This is a minimal framework for 3D mesh manipulation, which can be extended and used as a base for various projects, for example prototypes for fairing algorithms, or even displaying/modifying parametric surfaces, etc.
A framework for practicing
- handling of 3D points, vectors and triangle meshes
- displaying points, sections and polygons
- coloring, texturing
- some basic algorithms (curvature calculation, smoothing, evaluating Bezier surfaces)
The following hotkeys are available:
H: Displays a help window that contains all the necessary information.R: Reload modelO: Toggle orthographic projectionP: Set plain map (no coloring)M: Set mean curvature mapL: Set slicing map- +: Increase slicing density
- -: Decrease slicing density
- *: Set slicing direction to view
I: Set isophote line mapE: Set environment textureC: Toggle control polygon visualizationS: Toggle solid (filled polygon) visualizationW: Toggle wireframe visualizationX: Colors the triangles whose area is "typical" of the triangle mesh, i.e. larger than the smallest 25% and smaller than the largest 25% (ie between the 1st and 3rd quartiles), and also writes the value of the median.F: Fair mesh
Apart from Bezier surfaces, now you are able to construate linear Coons patch, defined by 4 B-Spline curves.
You can see the control polygons of 4 B-Spline curves colored with green, blue, red and white. The B-Spline curves are readed in from an input text file formatted like the following lines:
0 5 11 16 21
0 0 0
0.538973 0.441238 -0.018869
0.789511 0.710987 -0.0178379
1.0705 0.99705 -0.0424056
1.5 1.4 0
1.92654 2.03299 0.0510866
2.04474 1.46541 0.513285
2.0621 0.953166 0.941437
2.12746 0.370118 1.4236
2 0 2
2 0 2.5
2 0 3
1.74 0.148986 3.03634
1.44868 0.450289 3.03323
1 1 3
0.5 0.4 3
0.212158 0.223493 2.93774
0.0339112 0.547355 2.55629
0.034626 0.92554 2.11624
-0.0351735 1.12071 1.6582
-0.0340348 1.20689 0.729131
The linear Coons patch bounded by the B-Spline curves described by the above lines is the following.
Dependencies:
- Qt5 (http://qt-project.org/)
- libQGLViewer (http://www.libqglviewer.com/)
- OpenMesh (http://www.openmesh.org/)
qmake && make
Assumes that:
- qmake (Qt 5.x) is in the path
- QGLViewer include files are in
<standard include directory>/QGLViewer/ - OpenMesh include files are in
<standard include directory>/OpenMesh/ - QGLViewer library file is in
<standard library directory>/ - OpenMesh library files are in
/usr/lib/OpenMesh/
If any of the above is not satisfied, edit sample-framework.pro accordingly.
-
Install the Qt SDK, which should integrate itself into Visual Studio.
-
Download the source package for libQGLViewer, and put it somewhere, e.g. at c:\Program Files\libQGLViewer. Open Visual Studio, in the Qt menu select "Open Qt project file (*.pro)", and open the project file in the QGLViewer subdirectory (in my case c:\Program Files\libQGLViewer\libQGLViewer.pro). Compile a release version of the library.
-
Now open sample-framework.pro, and modify the following line:
LIBQGLVIEWER_INSTALL_PATH = 'C:\Program Files\libQGLViewer'(using the correct path on your system, of course).
-
Download the source package for OpenMesh, and put it somewhere, e.g. at c:\Program Files\OpenMesh. Open the solution file in Visual Studio and build a release version of the core library. Then open sample-framework.pro, and modify the following line:
OPENMESH_INSTALL_PATH = 'C:\Program Files\OpenMesh'(using the correct path on your system, of course).
-
Open Visual Studio, in the Qt menu select "Open Qt project file (*.pro)", and open sample-framework.pro.
-
You should be able to build the project, but it won't start. Solution: copy QGLViewer2.dll (found in QGLViewer\QGLViewer\release) into c:\Windows\System32 or into the project's directory.
-
If you also want to build a debug version of sample-framework, you are still not ready! You have to build debug versions of libQGLViewer and OpenMesh first, then change the library names in the project properties dialog window (and don't forget to copy QGLViewerd2.dll to a location in the path).