My data structure setup for this program was as follows:
I started with an STL vector list of vertices, a vector list of edges, and a vector list of faces.
Each vertex has a position, a normal, a texture coordinate (not actually used but in original implementation), and an STL Set of neighboring faces. The reason I chose to use a set to store neighboring faces was so that I could easily find the intersection between the sets of two adjacent vertices in an edge, and hence find the faces that come out of an edge. It also allowed me to easily get a vertex's neighbors
Each face has a vector of 3 vertices, a vector list of edges(which ends up being 3 after the construction is over), and a plane. The plane usually isn't calculated unless it's actually needed
Each edge has a pointer to its two vertices, and a pointer to the vertex at its midpoint. The reason I added the pointer to the vertex midpoint was because it was so convenient to have for functions like Fractalize() and Subdivide(). In many functions, it's not used, so it's simply null. But when I begin to split edges, it's very convenient to have a pointer that allows me to easily access the center.
Rotate the mesh counter-clockwise by an angle (in radians) around a line specified by a point (x, y, z) and a direction vector (dx, dy, dz).
No screenshot provided, since this one is self-explanatory and not-interesting (and hard to show with a screenshot).
Sample Execution:
meshpro input.off output.off -rotate 1 1 0 0 0 1
Rotates the mesh about the z-axis placed at (x=1, y=1)
Move every vertex by a given offset along its normal direction (this relies first on the successful execution of the compute vertex normals routine). This is as if every point were moved along the gradient of the surface (like moving out to an adjacent level set of an implicit suface).
Original
meshpro bunny.offbunny-0.01.off -inflate -0.01 (This one is technically "deflating" since the parameter is negative)
void R3Mesh::Deform(R3Point *source_points, R3Point *target_points, int npoints, double t);
Deform according to point correspondences: Warp the mesh by a deformation defined by point correspondences provided in an ascii file with six numbers on each line: x y z x' y' z'. The position of every vertex in the output mesh should be offset by a Gaussian weighted average of the offsets implied by the point correspondences (x,y,z) -> (x',y',z'). The t parameter should control the "amount" of offset, so that t = 0 gives the original mesh, t = 1 gives the deformed mesh, and other t values interpolate or extrapolate. I chose to use the distance between the points in each correspondence as the width of the Gaussian.
Smooth the mesh by moving every vertex to a position determined by a weighted average of its immediate neighbors (wiht weights determined by a Gaussian function of distance in R3)
Use the equation G(dx,dy,dz, sigma) = e ^ (-(dx^2 + dy^2 + dz^2) / sigma^2), where dx, dy, and dz are the distance of a neighbor point from a central point
Accentuate details in the mesh by moving every vertex away from the position determined by a weighted average of its neighbors (with weights determined by a Gaussian function).
If S is the smoothed position, P is the original position, P’ = P + t*(P-S)
Replace every triangle by four new ones. Create a new vertex at the midpoint of every edge, create new triangles between the vertices, and remove the original triangles.
Compute the surface normal at every vertex by taking a weighted average of the normals for the attached faces, where the weights are determined by the areas of the faces (like estimating the gradient of a level surface at discrete points). I take advantage of the fact that every vertex in my data structure points to its neighboring faces.
NOTE: No screenshot or mesh available; this operation is used in the inflate operation.
Take the cross sectional area described in profile_curve and rotate it by discrete amounts equal to rotation_angle_step around the line axis_of_revolution until it has rotated by 2PI. Join up each adjacent rotation of the cross section with faces. I relied heavily on my Rotation Routine here.
Execution:
meshpro int.off out.off -revolution file:profile real:px real:py real:pz real:vx real:vy real:vz real:angle_step
Where profile is a mesh that's only vertices (no faces) describing the cross-sectional area
The axis is (px, py, pz) * t * (vx, vy, vz) for a real number t
angle_step is the discrete rotation between adjacent faces
NOTE: The mesh "in.off" is ignored, but something needs to provided since I didn't get a chance to modify meshpro.cpp enough to deal with just an output mesh.
For this example, I used the cross-section provided in curv.off, which is the implicit curve defined by x = cos(a)+2; y = 0; z = sin(a) (a = [1/2*PI, 3/2*PI])
meshpro bunny.off revolution1.off -revolution curv.off 0 0 0 0 0 1 0.1 Rotate around the z-axis, using an angle step of 0.1 radians
meshpro bunny.off revolution2.off -revolution curv.off 0 1 0 0 0 1 0.05 Rotate around an offset of the z-axis this time, and use a smaller quantization for the angle (0.05 radians). Note how it's wider this time because of the placement of the rotation axis.
meshpro bunny.off revolution3.off -revolution curv.off 0 0 0 1 0 0 0.1 Rotate around the x-axis with a quantization of 0.1 radians
Take a cross-sectional area, provided in a mesh crosssection_polygon, and move it along the curve specified by another mesh, centerline_curve, to sweep out a surface from that area. In order for this to work and to have the right volume, the cross-sectional area needs to be rotated each time
In order to figure out how to rotate the cross-sectional area in each successive application of the sweep, I had to keep track of vectors that represented changes between points in the centerline curve. Taking the cross product of two of these successive vectors (v1 X v2, as shown in the picture above), gives the axis of rotation. Then, the angle between them gives the amount by which to rotate about that axis (I used the dot product to figure out theta).
I used the same cross-sectional area as in the surface of revolution, except I moved it across a line this time instead of rotating about an axis
NOTE: Once again, providing "bunny.off" as the input mesh is garbage, because the input mesh is simply ignored (the mesh is constructed from other paramters; namely, the cross-section area and the curve along which that area moves)
NOTE ALSO: The cross-sectional area is in curv.off, and the sweep line is in profile.off
Create fractal detail by recursively subdividing every triangle of an input mesh into four (as in the Subdivide feature) and moving every new vertex by a random offset vector (as in the Random Noise feature) with magnitude proportional to the original edge length.
Create triangles covering the holes of a mesh by connecting vertices on the boundary of every hole. Find holes by detecting a loop of edges that only have one face on them.
I created the following algorithm to do this:
Loop through all of the edges until an edge with only one neighboring face is found
Create an STL vector object that holds vertices, and add the first two vertices of that edge. Call them v1 and v2.
Get a list of all of the neighboring vertices of v2. If any of the edges between v2 and its neighbors have only one face attached, then add the neighbor to the set, and repeat the process for that vertex (recurse out)
If at any point in time, a neighbor vertex of the last vertex added is equal to the first vertex, that means the loop has been completed. Create a new vertex that's a weighted average of the loop vertices, and create faces between all of the loop vertices and that new center vertex
The recursion process will terminate when a hole has been filled, and the entire process will finished when all edges are checked
Create a mesh from a 2D image, with the x and y axes representing the pixel position in the image, and the z axis representing luminance of each pixel.