MeshFactory (Artisynth API documentation)

java.lang.Object
- maspack.geometry.MeshFactory

public class MeshFactory
extends java.lang.Object

Creates specific instances of polygonal meshes.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`MeshFactory.FaceType` Used by some factory methods to specify the face type
`static class`	`MeshFactory.VertexMap`
`static class`	`MeshFactory.VertexSet`

Field Summary

Fields
Modifier and Type Field and Description

static boolean DEFAULT_ADD_NORMALS

Fields
Modifier and Type	Field and Description
`static boolean`	`DEFAULT_ADD_NORMALS`

Constructor Summary

Constructors
Constructor and Description

MeshFactory()

Constructors
Constructor and Description
`MeshFactory()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`addQuadAnnularSector(PolygonalMesh mesh, double r0, double r1, double ang, int nr, int nang, RigidTransform3d XLM, MeshFactory.VertexMap vtxMap)` Adds an annular sector to an existing mesh.
`static void`	`addQuadCylindricalSection(PolygonalMesh mesh, double r, double h, double ang, int nh, int nang, boolean outward, RigidTransform3d XLM, MeshFactory.VertexMap vtxMap)` Adds a cylindrical section to an existing mesh.
`static void`	`addQuadRectangle(PolygonalMesh mesh, double wx, double wy, int nx, int ny, RigidTransform3d XLM, MeshFactory.VertexMap vtxMap)` Adds a quad rectangle to an existing mesh.
`static void`	`addQuadSphericalSection(PolygonalMesh mesh, double r, double maxthe, double maxphi, int nthe, int nphi, RigidTransform3d XLM, MeshFactory.VertexMap vtxMap)` Adds a spherical section to an existing mesh.
`static void`	`addQuadToroidalSection(PolygonalMesh mesh, double rmajor, double rminor, double minthe, double maxthe, int nmajor, int nminor, boolean capmin, boolean capmax, RigidTransform3d XLM, MeshFactory.VertexMap vtxMap)` Adds a toroidal section to an existing mesh.
`static void`	`closeSeams(PolygonalMesh mesh)`
`static PolygonalMesh`	`computeConvexHull(MeshBase mesh)` Builds a convex hull around a set of mesh vertices Internally relies on tetgen to generate a Delaunay tetrahedral mesh around the points
`static void`	`computeTextureCoordsForSphere(PolygonalMesh mesh, Point3d origin, double r, double tol)`
`static PolygonalMesh`	`createBox(double wx, double wy, double wz)` Creates a triangle-based box mesh, with two triangles per side, centered on the origin.
`static PolygonalMesh`	`createBox(double wx, double wy, double wz, boolean addNormals)` Creates a triangle-based box mesh, with two triangles per side, centered on the origin.
`static PolygonalMesh`	`createBox(double wx, double wy, double wz, double x, double y, double z)` Creates a triangle-based box mesh, with two triangles per side, centered at a prescribed location.
`static PolygonalMesh`	`createBox(double wx, double wy, double wz, double x, double y, double z, boolean addNormals)` Creates a triangle-based box mesh, with two triangles per side, centered at a prescribed location.
`static PolygonalMesh`	`createBox(double wx, double wy, double wz, Point3d center, int nx, int ny, int nz)` Creates a triangle-based box mesh, with a specified mesh resolution in each direction, and centered at a defined center point.
`static PolygonalMesh`	`createBox(double wx, double wy, double wz, Point3d center, int nx, int ny, int nz, boolean addNormals)` Creates a triangle-based box mesh, with a specified mesh resolution in each direction, and centered at a defined center point.
`static PolygonalMesh`	`createBox(double wx, double wy, double wz, Point3d center, int nx, int ny, int nz, boolean addNormals, MeshFactory.FaceType faceType)` Creates a box mesh, with a specified mesh resolution in each direction, and centered at a defined center point.
`static PolygonalMesh`	`createCircularSector(double rad, double ang, int nang)` Creates a triangular planar mesh of a circular sector with radius `r` and central angle `ang`.
`static PolygonalMesh`	`createCircularSector(double rad, double ang, int nr, int nang)` Creates a triangular planar mesh of a circular sector with radius `r` and central angle `ang`.
`static PolygonalMesh`	`createCone(double rtop, double rbot, double h, int nsides)`
`static PolygonalMesh`	`createConvexHull(MeshBase mesh)` Creates a convex hull from the vertex positions of an input mesh.
`static PolygonalMesh`	`createCylinder(double r, double h, int nslices)` Creates a triangular cylindrical mesh centered on the origin with the main axis aligned with the z axis.
`static PolygonalMesh`	`createCylinder(double r, double h, int nslices, int nr, int nh)` Creates a triangular cylindrical mesh centered on the origin with the main axis aligned with the z axis.
`static PolygonalMesh`	`createCylindricalWedge(double r, double h, double ang, int nr, int nh, int nang)` Creates a cylindrical wedge centered on the origin with the main axis of rotation aligned with the z axis.
`static PolygonalMesh`	`createDisk(double rad, int nr, int nang)` Creates a triangular planar disk with radius `r`, lying in the $x-y$ plane and centered on the origin.
`static PolygonalMesh`	`createEllipsoid(double a, double b, double c, int nslices)` Creates an triangular ellipsoid mesh, centered on the origin.
`static PolygonalMesh`	`createEllipsoid(double a, double b, double c, int nslices, int nlevels)` Creates an triangular ellipsoid mesh, centered on the origin.
`static PolygonalMesh`	`createExtendedTorus(double rmajor, double rminor, double xlen, int nmajor, int nminor)` Creates a quad extended torus mesh in the x-y plane.
`static PolygonalMesh`	`createFromFaces(java.lang.Iterable<Face> faces)` Create a new PolygonalMesh from a subset of faces.
`static PolygonalMesh`	`createHemisphere(double r, int nslices, int nlevels)` Creates an open triangular hemispherical mesh, centered on the origin, with a radius `r`.
`static PolygonalMesh`	`createHollowedBox(double wx, double wy, double wz, double r, int nsegs)` Creates a box with a cylindrical indentation in the top, parallel to the y axis, with a radius of r and approximated by nsegs segments.
`static PolygonalMesh`	`createIcosahedralSphere(double r, int divisions)`
`static PolygonalMesh`	`createIcosahedralSphere(double r, Point3d c, int divisions)`
`static PolygonalMesh`	`createIcosahedron(double r)`
`static PolygonalMesh`	`createOctadecahedralSphere(double r, int k)` Creates a sphere out of approximately uniform triangles by separating the sphere into a hexagonal prism with hexagonal pyramid caps, and dividing each edge into k segments.
`static PolygonalMesh`	`createOctahedralSphere(double r, int divisions)`
`static PolygonalMesh`	`createOctahedralSphere(double r, Point3d c, int divisions)`
`static PolygonalMesh`	`createOctahedron(double r)`
`static PolygonalMesh`	`createOpenCylinder(double r, double h, int nslices, int nh)` Creates an open cylindrical mesh centered on the origin with the main axis aligned with the z axis.
`static PolygonalMesh`	`createOpenQuadCylinder(double r, double h, int nslices, int nh)` Creates an open quad cylindrical mesh centered on the origin with the main axis aligned with the z axis.
`static PolygonalMesh`	`createPlane(double wx, double wy)` Legacy method to create a rectangle with texture coordinates; calls `createRectangle(wx,wy,true)`.
`static PolygonalMesh`	`createPlane(double wx, double wy, int xdiv, int ydiv)` Legacy method to create a rectangle with texture coordinates; calls `createRectangle(wx,wy,xdiv,ydiv,true)`.
`static PolygonalMesh`	`createPointedCylinder(double r, double h, double tiph, int nsides)`
`static PolygonalMesh`	`createPrism(double[] xy, double h)`
`static PolygonalMesh`	`createPrism(double[] xyTop, double[] xyBot, double h)`
`static PolygonalMesh`	`createQuadAnnularSector(double r0, double r1, double ang, int nr, int nang)` Creates an annular sector.
`static PolygonalMesh`	`createQuadBox(double wx, double wy, double wz)` Creates a quad-based box mesh, with one quad per side, centered on the origin.
`static PolygonalMesh`	`createQuadBox(double wx, double wy, double wz, boolean addNormals)` Creates a quad-based box mesh, with one quad per side, centered on the origin.
`static PolygonalMesh`	`createQuadBox(double wx, double wy, double wz, double x, double y, double z)` Creates a quad-based box mesh, with one quad per side, centered at a prescribed location.
`static PolygonalMesh`	`createQuadBox(double wx, double wy, double wz, double x, double y, double z, boolean addNormals)` Creates a quad-based box mesh, with one quad per side, centered at a prescribed location.
`static PolygonalMesh`	`createQuadBox(double wx, double wy, double wz, Point3d center, int nx, int ny, int nz)` Creates a quad-based box mesh, with a specified mesh resolution in each direction, and centered at a defined center point.
`static PolygonalMesh`	`createQuadBoxNew(double wx, double wy, double wz, Point3d center, int nx, int ny, int nz)`
`static PolygonalMesh`	`createQuadCircularSector(double rad, double ang, int nr, int nang)` Creates a quad-dominant planar mesh of a circular sector with radius `r` and central angle `ang`.
`static PolygonalMesh`	`createQuadCone(double rtop, double rbot, double h, int nsides)`
`static PolygonalMesh`	`createQuadCone(double rtop, double rbot, double h, int nsides, int nh)`
`static PolygonalMesh`	`createQuadCylinder(double r, double h, int nslices, int nr, int nh)` Creates a quad cylindrical mesh centered on the origin with the main axis aligned with the z axis.
`static PolygonalMesh`	`createQuadCylindricalSection(double r, double h, double ang, int nh, int nang)` Creates a cylindrical section.
`static PolygonalMesh`	`createQuadCylindricalWedge(double r, double h, double ang, int nr, int nh, int nang)` Creates a quad cylindrical wedge centered on the origin with the main axis of rotation aligned with the z axis.
`static PolygonalMesh`	`createQuadDisk(double rad, int nr, int nang)` Creates a quad-dominant planar disk with radius `r`, lying in the $x-y$ plane and centered on the origin.
`static PolygonalMesh`	`createQuadExtendedTorus(double rmajor, double rminor, double xlen, int nmajor, int nminor)` Creates a quad extended torus mesh in the x-y plane.
`static PolygonalMesh`	`createQuadHemisphere(double r, int nslices, int nlevels, double x, double y, double z)`
`static PolygonalMesh`	`createQuadPrism(double[] xy, double h)`
`static PolygonalMesh`	`createQuadPrism(double[] xyTop, double[] xyBot, double h)`
`static PolygonalMesh`	`createQuadPrism(double[] xyTop, double[] xyBot, double h, int nH)`
`static PolygonalMesh`	`createQuadRectangle(double wx, double wy, int nx, int ny)` Create a quad rectangle mesh.
`static PolygonalMesh`	`createQuadRoundedBox(double wx, double wy, double wz, int nslices)` Creates a box with rounded ends on the z-axis ends.
`static PolygonalMesh`	`createQuadRoundedBox(double wx, double wy, double wz, int nx, int ny, int nz, int nslices, boolean flatBottom)` Creates a box with rounded ends on the z-axis ends, and with a specified mesh resolution in the x, y, and z directions.
`static PolygonalMesh`	`createQuadRoundedCylinder(double r, double h, int nslices, int nsegs, boolean flatBottom)` Creates a cylinder with rounded (spherical) ends on the z-axis ends.
`static PolygonalMesh`	`createQuadSphere(double r, int nslices)`
`static PolygonalMesh`	`createQuadSphere(double r, int nslices, double x, double y, double z)`
`static PolygonalMesh`	`createQuadSphere(double r, int nslices, int nlevels, double x, double y, double z, boolean addTextureCoords)`
`static PolygonalMesh`	`createQuadSphericalSection(double r, double maxthe, double maxphi, int nthe, int nphi)` Creates a spherical section.
`static PolygonalMesh`	`createQuadToroidalSection(double rmajor, double rminor, double minthe, double maxthe, int nmajor, int nminor, boolean capmin, boolean capmax)` Creates a quad toroidal section.
`static PolygonalMesh`	`createQuadToroidalSection(double rmajor, double rminor, double maxthe, int nmajor, int nminor)` Creates a quad toroidal section.
`static PolygonalMesh`	`createQuadTorus(double rmajor, double rminor, int nmajor, int nminor)` Creates a quad torus mesh in the x-y plane.
`static PolygonalMesh`	`createQuadTube(double r0, double r1, double h, int nslices, int nr, int nh)` Creates a quad tube mesh centered on the origin with the main axis aligned with the z axis.
`static PointMesh`	`createRandomPointMesh(int numv, double width)` Creates a random point mesh, centered on the orgin, with a specified number of vertices and width.
`static PolygonalMesh`	`createRectangle(double wx, double wy, boolean addTextureCoords)` Create a open rectanglar mesh, composed of two triangles, in the x-y plane, centered on the origin and with normals directed along the z axis.
`static PolygonalMesh`	`createRectangle(double wx, double wy, int xdiv, int ydiv, boolean addTextureCoords)` Create a open rectangular mesh, composed of triangles, in the x-y plane, centered on the origin and with normals directed along the z axis.
`static PolygonalMesh`	`createRectangle(double wx, double wy, int xdiv, int ydiv, boolean addNormals, boolean addTextureCoords)` Create a open rectangular mesh, composed of triangles, in the x-y plane, centered on the origin and with normals directed along the z axis.
`static PolygonalMesh`	`createRefinedMesh(PolygonalMesh orig, int res)` Creates a refined version of a polygonal mesh, based on Nagata patches applied with a given resolution.
`static PolygonalMesh`	`createRoundedBox(double wz, double wx, double wy, int nslices)` Creates a triangular box mesh with rounded ends on the z-axis ends.
`static PolygonalMesh`	`createRoundedBox(double wz, double wx, double wy, int nz, int nx, int ny, int nslices)` Creates a triangular box mesh with rounded ends on the z-axis ends, and with a specified mesh resolution in the x, y, and z directions.
`static PolygonalMesh`	`createRoundedBox(double wz, double wx, double wy, int nz, int nx, int ny, int nslices, boolean flatBottom)` Creates a triangular box mesh with rounded ends on the z-axis ends, and with a specified mesh resolution in the x, y, and z directions.
`static PolygonalMesh`	`createRoundedCylinder(double r, double h, int nslices, int nsegs, boolean flatBottom)` Creates a triangular cylinder mesh with rounded (spherical) ends on the z-axis ends.
`static PolygonalMesh`	`createSkylineMesh(double wx, double wy, double wz, int nx, int ny, java.lang.String... depthField)` Creates a "skyline" mesh, which is a mesh defined over a rectangular region in the x-y plane.
`static PolygonalMesh`	`createSphere(double r, int nslices)` Creates a spherical triangular mesh, centered on the origin, with a radius `r`.
`static PolygonalMesh`	`createSphere(double r, int nslices, double x, double y, double z)`
`static PolygonalMesh`	`createSphere(double r, int nslices, int nlevels)` Creates a spherical triangular mesh, centered on the origin, with a radius `r`.
`static PolygonalMesh`	`createSphere(double r, int nslices, int nlevels, boolean addTextureCoords)` Creates a spherical triangular mesh, centered on the origin, with a radius `r`.
`static PolylineMesh`	`createSphericalPolyline(double r, int nslices, int nlevels)`
`static PolygonalMesh`	`createToroidalSection(double rmajor, double rminor, double minthe, double maxthe, int nmajor, int nminor, boolean capmin, boolean capmax)` Creates a triangular toroidal section.
`static PolygonalMesh`	`createTorus(double rmajor, double rminor, int nmajor, int nminor)` Creates a triangular torus mesh in the x-y plane.
`static PolygonalMesh`	`createTube(double r0, double r1, double h, int nslices, int nr, int nh)` Creates a triangular tube mesh centered on the origin with the main axis aligned with the z axis.
`static PolygonalMesh`	`extrudeAlongVertexNormals(PolygonalMesh mesh, double dx)` Expands (or shrinks) a mesh by displacing its vertices along their their normals.
`static boolean`	`fillHoles(PolygonalMesh mesh)`
`static java.util.ArrayList<HalfEdge>`	`findBorderEdges(PolygonalMesh mesh)`
`static PolygonalMesh`	`getFlipped(PolygonalMesh mesh)`
`static PolygonalMesh`	`getIntersection(PolygonalMesh mesh1, PolygonalMesh mesh2)`
`static PolygonalMesh`	`getSubtraction(PolygonalMesh mesh1, PolygonalMesh mesh2)`
`static PolygonalMesh`	`getUnion(PolygonalMesh mesh1, PolygonalMesh mesh2)`
`static void`	`mergeVertices(PolygonalMesh mesh, Vertex3d vtx1, Vertex3d vtx2)`
`static void`	`projectToSphere(double r, Point3d c, PolygonalMesh mesh)`
`static void`	`relax(PolygonalMesh mesh)`
`static java.util.ArrayList<PolygonalMesh>`	`splitMesh(PolygonalMesh splitme)` Splits a mesh into several pieces based on connectivity
`static java.util.ArrayList<PolygonalMesh>`	`splitMesh(PolygonalMesh splitme, double minCosLimit, int minSize)` Splits a mesh into several pieces based on connectivity and angle between faces
`static PolygonalMesh`	`subdivide(PolygonalMesh orig)`
`static PolygonalMesh`	`subdivide(PolygonalMesh orig, int numIters)`
`static PolygonalMesh`	`subdivideCatClark(PolygonalMesh orig)`
`static PolygonalMesh`	`subdivideCatClark(PolygonalMesh orig, int numIters)`
`static void`	`triangulateFaceCentroid(Face face)`
`static void`	`triangulateFaceCentroid(PolygonalMesh mesh)`
`static PolygonalMesh`	`wrapMesh(MeshBase mesh, Vector3i res, double margin, double dist)` Wrap all features of a mesh with a polygonal mesh

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DEFAULT_ADD_NORMALS
```
public static boolean DEFAULT_ADD_NORMALS
```
- Constructor Detail
  - MeshFactory
```
public MeshFactory()
```
- Method Detail
  - addQuadRectangle
```
public static void addQuadRectangle(PolygonalMesh mesh,
                                    double wx,
                                    double wy,
                                    int nx,
                                    int ny,
                                    RigidTransform3d XLM,
                                    MeshFactory.VertexMap vtxMap)
```
    Adds a quad rectangle to an existing mesh. The rectangle is centered on the x-y plane of a local coordinate frame L, with face normals directed along the z axis. A transform XLM is supplied to map L into the mesh coordinate frame M.
    
    Parameters:
    
    mesh - existing mesh to add the rectangle to
    
    wx - width of the rectangle along the local x axis
    
    wy - width of the rectangle along the local y axis
    
    nx - number of subdivisions along the local x axis
    
    ny - number of subdivisions along the local y axis
    
    XLM - transform from the local coordinate frame L to mesh coordinates M.
    
    vtxMap - spatial hash map storing all existing vertices in the mesh. New vertices will be created as needed and added to both this map and to the mesh.
  - createQuadRectangle
```
public static PolygonalMesh createQuadRectangle(double wx,
                                                double wy,
                                                int nx,
                                                int ny)
```
    Create a quad rectangle mesh. The rectangle is centered on the x-y plane of a local coordinate frame L, with face normals directed along the z axis.
    
    Parameters:
    
    wx - width of the rectangle along the local x axis
    
    wy - width of the rectangle along the local y axis
    
    nx - number of subdivisions along the local x axis
    
    ny - number of subdivisions along the local y axis
  - addQuadAnnularSector
```
public static void addQuadAnnularSector(PolygonalMesh mesh,
                                        double r0,
                                        double r1,
                                        double ang,
                                        int nr,
                                        int nang,
                                        RigidTransform3d XLM,
                                        MeshFactory.VertexMap vtxMap)
```
    Adds an annular sector to an existing mesh. The sector is centered on the x-y plane of a local coordinate frame L, with the bisecting axis parallel to x and face normals directed along the z axis. It extends for +/-ang/2 on either side of the x axis, and from an inner radius r0 to an outer radius r1; if ang is 2 PI and r0 is 0 then the sector becomes a circle with radius r1. The mesh is made of quads except for those faces connected to the origin. A transform XLM is supplied to map L into the mesh coordinate frame M.
    
    Parameters:
    
    mesh - existing mesh to add the annular sector to
    
    r0 - inner radius of the sector
    
    r1 - outer radius of the sector
    
    ang - total angular extent of the sector
    
    nr - number of radial slices
    
    nang - number of angular slices
    
    XLM - transform from the local coordinate frame L to mesh coordinates M.
    
    vtxMap - spatial hash map storing all existing vertices in the mesh. New vertices will be created as needed and added to both this map and to the mesh.
  - createQuadAnnularSector
```
public static PolygonalMesh createQuadAnnularSector(double r0,
                                                    double r1,
                                                    double ang,
                                                    int nr,
                                                    int nang)
```
    Creates an annular sector. The sector is centered on the x-y plane of a local coordinate frame L, with the bisecting axis parallel to x and face normals directed along the z axis. For more details, see the documentation for addQuadAnnularSector(maspack.geometry.PolygonalMesh, double, double, double, int, int, maspack.matrix.RigidTransform3d, maspack.geometry.MeshFactory.VertexMap).
    
    Parameters:
    
    r0 - inner radius of the annular sector
    
    r1 - outer radius of the annular sector
    
    ang - total angular extent of the annular sector
    
    nr - number of radial slices
    
    nang - number of angular slices
  - addQuadCylindricalSection
```
public static void addQuadCylindricalSection(PolygonalMesh mesh,
                                             double r,
                                             double h,
                                             double ang,
                                             int nh,
                                             int nang,
                                             boolean outward,
                                             RigidTransform3d XLM,
                                             MeshFactory.VertexMap vtxMap)
```
    Adds a cylindrical section to an existing mesh. The section is centered on the z axis of a local coordinate frame L, extending for a length +/-h/2 above and below the origin. The angular extent of the section is +/-ang/2 on either side of the x axis; if ang is 2 PI then the section will become a whole cylinder. Normals are oriented to face outwards. The sector is made of quads. A transform XLM is supplied to map L into the mesh coordinate frame M.
    
    Parameters:
    
    mesh - existing mesh to add the section to
    
    r - radius of the cylinder
    
    h - height of the cylinder
    
    ang - total angular extent of the section
    
    nh - number of height slices
    
    nang - number of angular slices
    
    outward - if true, the normals are facing outward
    
    XLM - transform from the local coordinate frame L to mesh coordinates M.
    
    vtxMap - spatial hash map storing all existing vertices in the mesh. New vertices will be created as needed and added to both this map and to the mesh.
  - createQuadCylindricalSection
```
public static PolygonalMesh createQuadCylindricalSection(double r,
                                                         double h,
                                                         double ang,
                                                         int nh,
                                                         int nang)
```
    Creates a cylindrical section. The section is centered on the z axis of a local coordinate frame L, extending for a length +/-h/2 above and below the origin. The angular extent of the section is +/-ang/2 on either side of the x axis; if ang is 2 PI then the section will become a whole cylinder. Normals are oriented to face outwards. The sector is made of quads.
    
    Parameters:
    
    r - radius of the cylinder
    
    h - height of the cylinder
    
    ang - total angular extent of the section
    
    nh - number of height slices
    
    nang - number of angular slices
  - addQuadSphericalSection
```
public static void addQuadSphericalSection(PolygonalMesh mesh,
                                           double r,
                                           double maxthe,
                                           double maxphi,
                                           int nthe,
                                           int nphi,
                                           RigidTransform3d XLM,
                                           MeshFactory.VertexMap vtxMap)
```
    Adds a spherical section to an existing mesh. The section is centered on the origin of a local coordinate frame L, with the poles located on the z axis. A point on the sphere is defined using spherical coordinates r, theta, and phi, with theta giving the azimuth angle with respect to the x axis and phi giving the elevation angle with respect to the z axis. The x, y, z and values are hence
```
 r sin(phi) cos(theta), r sin(phi) sin(theta), r cos(phi)
 
```
    The extent of phi is given by [0, maxphi], while the extend of theta is given by [-maxthe, maxthe]. Specifying maxphi and maxthe as both PI results in a complete sphere. Normals are oriented to face outwards. The section is made of quads, except at the poles. A transform XLM is supplied to map L into the mesh coordinate frame M.
    Note: to avoid degenarte quads near the south pole of the section, maxphi is rounded to PI if it is within 1e-4 of PI.
    Parameters:
    
    mesh - existing mesh to add the section to
    
    r - radius of the section
    
    maxthe - maximum azimuth angle about either side of the x axis
    
    maxphi - maximum elevation angle with respect to the z axis
    
    nthe - number of slices for the azimuth
    
    nphi - number of slices for the elevation
    
    XLM - transform from the local coordinate frame L to mesh coordinates M.
    
    vtxMap - spatial hash map storing all existing vertices in the mesh. New vertices will be created as needed and added to both this map and to the mesh.
  - createQuadSphericalSection
```
public static PolygonalMesh createQuadSphericalSection(double r,
                                                       double maxthe,
                                                       double maxphi,
                                                       int nthe,
                                                       int nphi)
```
    Creates a spherical section. The section is centered on the origin of a local coordinate frame L, with the poles located on the z axis. A point on the sphere is defined using spherical coordinates r, theta, and phi, with theta giving the azimuth angle with respect to the x axis and phi giving the elevation angle with respect to the z axis. For additional information, see the documentation for addQuadSphericalSection(maspack.geometry.PolygonalMesh, double, double, double, int, int, maspack.matrix.RigidTransform3d, maspack.geometry.MeshFactory.VertexMap).
    
    Parameters:
    
    r - radius of the section
    
    maxthe - maximum azimuth angle about either side of the x axis
    
    maxphi - maximum elevation angle with respect to the z axis
    
    nthe - number of slices for the azimuth
    
    nphi - number of slices for the elevation
  - addQuadToroidalSection
```
public static void addQuadToroidalSection(PolygonalMesh mesh,
                                          double rmajor,
                                          double rminor,
                                          double minthe,
                                          double maxthe,
                                          int nmajor,
                                          int nminor,
                                          boolean capmin,
                                          boolean capmax,
                                          RigidTransform3d XLM,
                                          MeshFactory.VertexMap vtxMap)
```
    Adds a toroidal section to an existing mesh. The section lies in the x-y plane and curves about the z-axis between the angles minthe and maxthe with respect to the postive x axis. The major radius from the z axis to the center of the tube is given by rmajor, and the minor radius of the tube section itself is given by rminor.
    The section made out of quads. It is closed into a torus if maxthe is equal to 2*Math.PI.
    
    Parameters:
    
    mesh - existing mesh to add the section to
    
    rmajor - major radius of bending about the z axis
    
    rminor - minor radius of the tube
    
    minthe - minimum bending angle about the z axis
    
    maxthe - maximum bending angle about the z axis
    
    nmajor - number of slices along the major radius
    
    nminor - number of slices along the minor radius
    
    capmin - if true, cap the end at minthe
    
    capmax - if true, cap the end at maxthe
    
    XLM - transform from the local coordinate frame L to mesh coordinates M.
    
    vtxMap - spatial hash map storing all existing vertices in the mesh. New vertices will be created as needed and added to both this map and to the mesh.
  - createQuadToroidalSection
```
public static PolygonalMesh createQuadToroidalSection(double rmajor,
                                                      double rminor,
                                                      double maxthe,
                                                      int nmajor,
                                                      int nminor)
```
    Creates a quad toroidal section. The section lies in the x-y plane and curves about the z-axis for an angular distance of maxthe, with the starting end aligned with the x-z plane. For additional information, see the documentation for addQuadToroidalSection(maspack.geometry.PolygonalMesh, double, double, double, double, int, int, boolean, boolean, maspack.matrix.RigidTransform3d, maspack.geometry.MeshFactory.VertexMap).
    
    Parameters:
    
    rmajor - major radius of bending about the z axis
    
    rminor - minor radius of the tube
    
    maxthe - maximum bending angle about the z axis
    
    nmajor - number of slices along the major radius
    
    nminor - number of slices along the minor radius
  - createQuadToroidalSection
```
public static PolygonalMesh createQuadToroidalSection(double rmajor,
                                                      double rminor,
                                                      double minthe,
                                                      double maxthe,
                                                      int nmajor,
                                                      int nminor,
                                                      boolean capmin,
                                                      boolean capmax)
```
    Creates a quad toroidal section. The section lies in the x-y plane and curves about the z-axis between minthe and maxthe with respect to the x axis. For additional information, see the documentation for addQuadToroidalSection(maspack.geometry.PolygonalMesh, double, double, double, double, int, int, boolean, boolean, maspack.matrix.RigidTransform3d, maspack.geometry.MeshFactory.VertexMap).
    
    Parameters:
    
    rmajor - major radius of bending about the z axis
    
    rminor - minor radius of the tube
    
    minthe - minimum bending angle about the z axis
    
    maxthe - maximum bending angle about the z axis
    
    nmajor - number of slices along the major radius
    
    nminor - number of slices along the minor radius
    
    capmin - if true, cap the end at minthe
    
    capmax - if true, cap the end at maxthe
  - createToroidalSection
```
public static PolygonalMesh createToroidalSection(double rmajor,
                                                  double rminor,
                                                  double minthe,
                                                  double maxthe,
                                                  int nmajor,
                                                  int nminor,
                                                  boolean capmin,
                                                  boolean capmax)
```
    Creates a triangular toroidal section. The section lies in the x-y plane and curves about the z-axis between minthe and maxthe with respect to the x axis. For additional information, see the documentation for addQuadToroidalSection(maspack.geometry.PolygonalMesh, double, double, double, double, int, int, boolean, boolean, maspack.matrix.RigidTransform3d, maspack.geometry.MeshFactory.VertexMap).
    
    Parameters:
    
    rmajor - major radius of bending about the z axis
    
    rminor - minor radius of the tube
    
    minthe - minimum bending angle about the z axis
    
    maxthe - maximum bending angle about the z axis
    
    nmajor - number of slices along the major radius
    
    nminor - number of slices along the minor radius
    
    capmin - if true, cap the end at minthe
    
    capmax - if true, cap the end at maxthe
  - createQuadTorus
```
public static PolygonalMesh createQuadTorus(double rmajor,
                                            double rminor,
                                            int nmajor,
                                            int nminor)
```
    Creates a quad torus mesh in the x-y plane.
    
    Parameters:
    
    rmajor - major radius of the torus
    
    rminor - minor radius of the torus
    
    nmajor - number of slices along the major radius
    
    nminor - number of slices along the minor radius
  - createTorus
```
public static PolygonalMesh createTorus(double rmajor,
                                        double rminor,
                                        int nmajor,
                                        int nminor)
```
    Creates a triangular torus mesh in the x-y plane.
    
    Parameters:
    
    rmajor - major radius of the torus
    
    rminor - minor radius of the torus
    
    nmajor - number of slices along the major radius
    
    nminor - number of slices along the minor radius
  - createQuadExtendedTorus
```
public static PolygonalMesh createQuadExtendedTorus(double rmajor,
                                                    double rminor,
                                                    double xlen,
                                                    int nmajor,
                                                    int nminor)
```
    Creates a quad extended torus mesh in the x-y plane. An extended torus is a torus with straight sections added in the middle, giving a shape similar to a chain link. The straight sections are parallel to the x-axis.
    
    Parameters:
    
    rmajor - major radius of the torus
    
    rminor - minor radius of the torus
    
    xlen - length of the straight sections
    
    nmajor - number of slices along the major radius
    
    nminor - number of slices along the minor radius
  - createExtendedTorus
```
public static PolygonalMesh createExtendedTorus(double rmajor,
                                                double rminor,
                                                double xlen,
                                                int nmajor,
                                                int nminor)
```
    Creates a quad extended torus mesh in the x-y plane. An extended torus is a torus with straight sections added in the middle, giving a shape similar to a chain link. The straight sections are parallel to the x-axis.
    
    Parameters:
    
    rmajor - major radius of the torus
    
    rminor - minor radius of the torus
    
    xlen - length of the straight sections
    
    nmajor - number of slices along the major radius
    
    nminor - number of slices along the minor radius
  - createPlane
```
public static PolygonalMesh createPlane(double wx,
                                        double wy)
```
    Legacy method to create a rectangle with texture coordinates; calls createRectangle(wx,wy,true).
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    Returns:
    
    created rectangular mesh
  - createRectangle
```
public static PolygonalMesh createRectangle(double wx,
                                            double wy,
                                            boolean addTextureCoords)
```
    Create a open rectanglar mesh, composed of two triangles, in the x-y plane, centered on the origin and with normals directed along the z axis. Texture coordinates can optionally be created for each triangle so that (0,0) and (1,1) correspond to the lower left and upper right corners.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    addTextureCoords - if true, generates texture coordinates
  - createPlane
```
public static PolygonalMesh createPlane(double wx,
                                        double wy,
                                        int xdiv,
                                        int ydiv)
```
    Legacy method to create a rectangle with texture coordinates; calls createRectangle(wx,wy,xdiv,ydiv,true).
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    xdiv - number of divisions in x (>=1)
    
    ydiv - number of divisions in y (>=1)
    
    Returns:
    
    created rectangular mesh
  - createRectangle
```
public static PolygonalMesh createRectangle(double wx,
                                            double wy,
                                            int xdiv,
                                            int ydiv,
                                            boolean addTextureCoords)
```
    Create a open rectangular mesh, composed of triangles, in the x-y plane, centered on the origin and with normals directed along the z axis. Texture coordinates can optionally be created created for each triangle so that (0,0) and (1,1) correspond to the lower left and upper right corners.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    xdiv - number of divisions in x (>=1)
    
    ydiv - number of divisions in y (>=1)
    
    addTextureCoords - if true, generates texture coordinates
    
    Returns:
    
    created mesh
  - createRectangle
```
public static PolygonalMesh createRectangle(double wx,
                                            double wy,
                                            int xdiv,
                                            int ydiv,
                                            boolean addNormals,
                                            boolean addTextureCoords)
```
    Create a open rectangular mesh, composed of triangles, in the x-y plane, centered on the origin and with normals directed along the z axis. Texture coordinates can optionally be created created for each triangle so that (0,0) and (1,1) correspond to the lower left and upper right corners.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    xdiv - number of divisions in x (>=1)
    
    ydiv - number of divisions in y (>=1)
    
    addNormals - if true, generates normals in the positive z direction
    
    addTextureCoords - if true, generates texture coordinates
    
    Returns:
    
    created mesh
  - createQuadCircularSector
```
public static PolygonalMesh createQuadCircularSector(double rad,
                                                     double ang,
                                                     int nr,
                                                     int nang)
```
    Creates a quad-dominant planar mesh of a circular sector with radius r and central angle ang. The mesh lies in the $x-y$ plane with the circle centered on the origin and the sector bisceted by the x axis. The mesh is composed of quads except for the part adjcent to the center of the circle. If nr is 1, then the mesh is composed only of triangles. If ang equals 2 PI (within machine precision), then the sector becomes a disk.
    
    Parameters:
    
    rad - radius of the sector
    
    ang - total angle of the sector (radians)
    
    nr - number of radial divisions
    
    nang - number of angular divisions
    
    Returns:
    
    created mesh
  - createCircularSector
```
public static PolygonalMesh createCircularSector(double rad,
                                                 double ang,
                                                 int nr,
                                                 int nang)
```
    Creates a triangular planar mesh of a circular sector with radius r and central angle ang. The mesh lies in the $x-y$ plane with the circle centered on the origin and the sector bisceted by the x axis. If ang equals 2 PI (within machine precision), then the sector becomes a disk.
    
    Parameters:
    
    rad - radius of the sector
    
    ang - total angle of the sector (radians)
    
    nr - number of radial divisions
    
    nang - number of angular divisions
    
    Returns:
    
    created mesh
  - createCircularSector
```
public static PolygonalMesh createCircularSector(double rad,
                                                 double ang,
                                                 int nang)
```
    Creates a triangular planar mesh of a circular sector with radius r and central angle ang. The mesh lies in the $x-y$ plane with the circle centered on the origin and the sector bisceted by the x axis. There is only one radial segment, and so the mesh is triangular fan. If ang equals 2 PI (within machine precision), then the sector becomes a disk.
    
    Parameters:
    
    rad - radius of the sector
    
    ang - total angle of the sector (radians)
    
    nang - number of angular divisions
    
    Returns:
    
    created mesh
  - createQuadDisk
```
public static PolygonalMesh createQuadDisk(double rad,
                                           int nr,
                                           int nang)
```
    Creates a quad-dominant planar disk with radius r, lying in the $x-y$ plane and centered on the origin. The mesh is composed of quads except for the part adjcent to the center of the disk. If nr is 1, then the mesh is composed only of triangles.
    
    Parameters:
    
    rad - radius of the disk
    
    nr - number of radial divisions
    
    nang - number of angular divisions
    
    Returns:
    
    created mesh
  - createDisk
```
public static PolygonalMesh createDisk(double rad,
                                       int nr,
                                       int nang)
```
    Creates a triangular planar disk with radius r, lying in the $x-y$ plane and centered on the origin.
    
    Parameters:
    
    rad - radius of the disk
    
    nr - number of radial divisions
    
    nang - number of angular divisions
    
    Returns:
    
    created mesh
  - createQuadBox
```
public static PolygonalMesh createQuadBox(double wx,
                                          double wy,
                                          double wz)
```
    Creates a quad-based box mesh, with one quad per side, centered on the origin.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    wz - width in the z direction
  - createQuadBox
```
public static PolygonalMesh createQuadBox(double wx,
                                          double wy,
                                          double wz,
                                          boolean addNormals)
```
    Creates a quad-based box mesh, with one quad per side, centered on the origin.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    wz - width in the z direction
    
    addNormals - if true, generates normals perpendicular to each side
  - createQuadBox
```
public static PolygonalMesh createQuadBox(double wx,
                                          double wy,
                                          double wz,
                                          double x,
                                          double y,
                                          double z)
```
    Creates a quad-based box mesh, with one quad per side, centered at a prescribed location.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    wz - width in the z direction
    
    x - center location along the x axis
    
    y - center location along the y axis
    
    z - center location along the z axis
  - createQuadBox
```
public static PolygonalMesh createQuadBox(double wx,
                                          double wy,
                                          double wz,
                                          double x,
                                          double y,
                                          double z,
                                          boolean addNormals)
```
    Creates a quad-based box mesh, with one quad per side, centered at a prescribed location.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    wz - width in the z direction
    
    x - center location along the x axis
    
    y - center location along the y axis
    
    z - center location along the z axis
    
    addNormals - if true, generates normals perpendicular to each side
  - createBox
```
public static PolygonalMesh createBox(double wx,
                                      double wy,
                                      double wz)
```
    Creates a triangle-based box mesh, with two triangles per side, centered on the origin.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    wz - width in the z direction
  - createBox
```
public static PolygonalMesh createBox(double wx,
                                      double wy,
                                      double wz,
                                      boolean addNormals)
```
    Creates a triangle-based box mesh, with two triangles per side, centered on the origin.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    wz - width in the z direction
    
    addNormals - if true, generates normals perpendicular to each side
  - createBox
```
public static PolygonalMesh createBox(double wx,
                                      double wy,
                                      double wz,
                                      double x,
                                      double y,
                                      double z)
```
    Creates a triangle-based box mesh, with two triangles per side, centered at a prescribed location.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    wz - width in the z direction
    
    x - center location along the x axis
    
    y - center location along the y axis
    
    z - center location along the z axis
  - createBox
```
public static PolygonalMesh createBox(double wx,
                                      double wy,
                                      double wz,
                                      double x,
                                      double y,
                                      double z,
                                      boolean addNormals)
```
    Creates a triangle-based box mesh, with two triangles per side, centered at a prescribed location.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    wz - width in the z direction
    
    x - center location along the x axis
    
    y - center location along the y axis
    
    z - center location along the z axis
    
    addNormals - if true, generates normals perpendicular to each side
  - createBox
```
public static PolygonalMesh createBox(double wx,
                                      double wy,
                                      double wz,
                                      Point3d center,
                                      int nx,
                                      int ny,
                                      int nz)
```
    Creates a triangle-based box mesh, with a specified mesh resolution in each direction, and centered at a defined center point.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    wz - width in the z direction
    
    center - center of the box
    
    nx - number of subdivisions along x
    
    ny - number of subdivisions along y
    
    nz - number of subdivisions along z
  - createBox
```
public static PolygonalMesh createBox(double wx,
                                      double wy,
                                      double wz,
                                      Point3d center,
                                      int nx,
                                      int ny,
                                      int nz,
                                      boolean addNormals)
```
    Creates a triangle-based box mesh, with a specified mesh resolution in each direction, and centered at a defined center point.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    wz - width in the z direction
    
    center - center of the box
    
    nx - number of subdivisions along x
    
    ny - number of subdivisions along y
    
    nz - number of subdivisions along z
    
    addNormals - if true, generates normals perpendicular to each side
  - wrapMesh
```
public static PolygonalMesh wrapMesh(MeshBase mesh,
                                     Vector3i res,
                                     double margin,
                                     double dist)
```
    Wrap all features of a mesh with a polygonal mesh
    
    Parameters:
    
    mesh - mesh to wrap
    
    res - resolution for evaluating distances
    
    dist - level-set of distances to consider
    
    Returns:
    
    wrapped mesh
  - subdivide
```
public static PolygonalMesh subdivide(PolygonalMesh orig,
                                      int numIters)
```
  - subdivide
```
public static PolygonalMesh subdivide(PolygonalMesh orig)
```
  - subdivideCatClark
```
public static PolygonalMesh subdivideCatClark(PolygonalMesh orig,
                                              int numIters)
```
  - subdivideCatClark
```
public static PolygonalMesh subdivideCatClark(PolygonalMesh orig)
```
  - createQuadBox
```
public static PolygonalMesh createQuadBox(double wx,
                                          double wy,
                                          double wz,
                                          Point3d center,
                                          int nx,
                                          int ny,
                                          int nz)
```
    Creates a quad-based box mesh, with a specified mesh resolution in each direction, and centered at a defined center point.
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    wz - width in the z direction
    
    center - center of the box
    
    nx - number of subdivisions along x
    
    ny - number of subdivisions along y
    
    nz - number of subdivisions along z
  - createBox
```
public static PolygonalMesh createBox(double wx,
                                      double wy,
                                      double wz,
                                      Point3d center,
                                      int nx,
                                      int ny,
                                      int nz,
                                      boolean addNormals,
                                      MeshFactory.FaceType faceType)
```
    Creates a box mesh, with a specified mesh resolution in each direction, and centered at a defined center point. The faces type is specified by faceType
    
    Parameters:
    
    wx - width in the x direction
    
    wy - width in the y direction
    
    wz - width in the z direction
    
    center - center of the box
    
    nx - number of subdivisions along x
    
    ny - number of subdivisions along y
    
    nz - number of subdivisions along z
    
    addNormals - if true, generates normals perpendicular to each side
    
    faceType - specifies the face type to be either quads, triangles, or triangles with alternating diagonals
  - createQuadBoxNew
```
public static PolygonalMesh createQuadBoxNew(double wx,
                                             double wy,
                                             double wz,
                                             Point3d center,
                                             int nx,
                                             int ny,
                                             int nz)
```
  - triangulateFaceCentroid
```
public static void triangulateFaceCentroid(PolygonalMesh mesh)
```
  - createCylinder
```
public static PolygonalMesh createCylinder(double r,
                                           double h,
                                           int nslices)
```
    Creates a triangular cylindrical mesh centered on the origin with the main axis aligned with the z axis.
    
    Parameters:
    
    r - outer radius of the cylinder
    
    h - height of the cylinder
    
    nslices - number of segments about the z axis
  - createCylinder
```
public static PolygonalMesh createCylinder(double r,
                                           double h,
                                           int nslices,
                                           int nr,
                                           int nh)
```
    Creates a triangular cylindrical mesh centered on the origin with the main axis aligned with the z axis.
    
    Parameters:
    
    r - outer radius of the cylinder
    
    h - height of the cylinder
    
    nslices - number of segments about the z axis
    
    nr - number of radial segments on each end cap
    
    nh - number of height segments along the z axis
  - triangulateFaceCentroid
```
public static void triangulateFaceCentroid(Face face)
```
  - createOpenCylinder
```
public static PolygonalMesh createOpenCylinder(double r,
                                               double h,
                                               int nslices,
                                               int nh)
```
    Creates an open cylindrical mesh centered on the origin with the main axis aligned with the z axis. All faces are triangles.
    
    Parameters:
    
    r - outer radius of the cylinder
    
    h - height of the cylinder
    
    nslices - number of segments about the z axis
    
    nh - number of height segments along the z axis
  - createOpenQuadCylinder
```
public static PolygonalMesh createOpenQuadCylinder(double r,
                                                   double h,
                                                   int nslices,
                                                   int nh)
```
    Creates an open quad cylindrical mesh centered on the origin with the main axis aligned with the z axis. All faces are quads.
    
    Parameters:
    
    r - outer radius of the cylinder
    
    h - height of the cylinder
    
    nslices - number of segments about the z axis
    
    nh - number of height segments along the z axis
  - createQuadCylindricalWedge
```
public static PolygonalMesh createQuadCylindricalWedge(double r,
                                                       double h,
                                                       double ang,
                                                       int nr,
                                                       int nh,
                                                       int nang)
```
    Creates a quad cylindrical wedge centered on the origin with the main axis of rotation aligned with the z axis. The wedge extends for an angular extent of+/-ang/2 on either side of the x axis; if ang is within machine precision of 2 PI then the section will become a whole cylinder. Normals are oriented to face outwards. All faces are quads except for those at the center of the end caps.
    
    Parameters:
    
    r - outer radius of the wedge
    
    h - height of the wedge
    
    ang - total angular extent of the wedge
    
    nr - number of radial slices
    
    nh - number of height slices
    
    nang - number of angular slices
  - createCylindricalWedge
```
public static PolygonalMesh createCylindricalWedge(double r,
                                                   double h,
                                                   double ang,
                                                   int nr,
                                                   int nh,
                                                   int nang)
```
    Creates a cylindrical wedge centered on the origin with the main axis of rotation aligned with the z axis. The wedge extends for an angular extent of+/-ang/2 on either side of the x axis; if ang is within machine precision of 2 PI then the section will become a whole cylinder. Normals are oriented to face outwards.
    
    Parameters:
    
    r - outer radius of the wedge
    
    h - height of the wedge
    
    ang - total angular extent of the wedge
    
    nr - number of radial slices
    
    nh - number of height slices
    
    nang - number of angular slices
  - createQuadCylinder
```
public static PolygonalMesh createQuadCylinder(double r,
                                               double h,
                                               int nslices,
                                               int nr,
                                               int nh)
```
    Creates a quad cylindrical mesh centered on the origin with the main axis aligned with the z axis. All faces are quads except for those at the center of each end cap.
    
    Parameters:
    
    r - outer radius of the cylinder
    
    h - height of the cylinder
    
    nslices - number of segments about the z axis
    
    nr - number of radial segments on each end cap
    
    nh - number of height segments along the z axis
  - createQuadTube
```
public static PolygonalMesh createQuadTube(double r0,
                                           double r1,
                                           double h,
                                           int nslices,
                                           int nr,
                                           int nh)
```
    Creates a quad tube mesh centered on the origin with the main axis aligned with the z axis.
    
    Parameters:
    
    r0 - inner radius of the tube
    
    r1 - outer radius of the tube
    
    h - height of the tube
    
    nslices - number of segments about the z axis
    
    nr - number of radial segments on each end
    
    nh - number of height segments along the z axis
  - createTube
```
public static PolygonalMesh createTube(double r0,
                                       double r1,
                                       double h,
                                       int nslices,
                                       int nr,
                                       int nh)
```
    Creates a triangular tube mesh centered on the origin with the main axis aligned with the z axis.
    
    Parameters:
    
    r0 - inner radius of the tube
    
    r1 - outer radius of the tube
    
    h - height of the tube
    
    nslices - number of segments about the z axis
    
    nr - number of radial segments on each end
    
    nh - number of height segments along the z axis
  - createPointedCylinder
```
public static PolygonalMesh createPointedCylinder(double r,
                                                  double h,
                                                  double tiph,
                                                  int nsides)
```
  - relax
```
public static void relax(PolygonalMesh mesh)
```
  - projectToSphere
```
public static void projectToSphere(double r,
                                   Point3d c,
                                   PolygonalMesh mesh)
```
  - createOctahedralSphere
```
public static PolygonalMesh createOctahedralSphere(double r,
                                                   int divisions)
```
  - createOctahedralSphere
```
public static PolygonalMesh createOctahedralSphere(double r,
                                                   Point3d c,
                                                   int divisions)
```
  - createIcosahedralSphere
```
public static PolygonalMesh createIcosahedralSphere(double r,
                                                    int divisions)
```
  - createIcosahedralSphere
```
public static PolygonalMesh createIcosahedralSphere(double r,
                                                    Point3d c,
                                                    int divisions)
```
  - createOctahedron
```
public static PolygonalMesh createOctahedron(double r)
```
  - createIcosahedron
```
public static PolygonalMesh createIcosahedron(double r)
```
  - createOctadecahedralSphere
```
public static PolygonalMesh createOctadecahedralSphere(double r,
                                                       int k)
```
    Creates a sphere out of approximately uniform triangles by separating the sphere into a hexagonal prism with hexagonal pyramid caps, and dividing each edge into k segments.
    
    Parameters:
    
    r - radius of sphere
    
    k - number of divisions
    
    Returns:
    
    sphere mesh
  - createQuadSphere
```
public static PolygonalMesh createQuadSphere(double r,
                                             int nslices)
```
  - createSphere
```
public static PolygonalMesh createSphere(double r,
                                         int nslices)
```
    Creates a spherical triangular mesh, centered on the origin, with a radius r. The mesh is constructed using spherical coordinates, with a resolution of nslices about the equator and nslices/2 longitudinally.
    
    Parameters:
    
    r - radius of the sphere
    
    nslices - mesh resolution
    
    Returns:
    
    created spherical mesh
  - createSphere
```
public static PolygonalMesh createSphere(double r,
                                         int nslices,
                                         int nlevels)
```
    Creates a spherical triangular mesh, centered on the origin, with a radius r. The mesh is constructed using spherical coordinates, with a resolution of nslices about the equator and nlevels longitudinally.
    
    Parameters:
    
    r - radius of the sphere
    
    nslices - equatorial mesh resolution
    
    nlevels - longitudinal mesh resolution
    
    Returns:
    
    created spherical mesh
  - createSphere
```
public static PolygonalMesh createSphere(double r,
                                         int nslices,
                                         int nlevels,
                                         boolean addTextureCoords)
```
    Creates a spherical triangular mesh, centered on the origin, with a radius r. The mesh is constructed using spherical coordinates, with a resolution of nslices about the equator and nlevels longitudinally. Texture coordinates can optionally be created, where (0,0) and (1,1) map to the spherical coordinates (-PI,PI) (south pole) and (PI,0) (north pole).
    
    Parameters:
    
    r - radius of the sphere
    
    nslices - equatorial mesh resolution
    
    nlevels - longitudinal mesh resolution
    
    addTextureCoords - if true, generates texture coordinates
    
    Returns:
    
    created spherical mesh
  - createEllipsoid
```
public static PolygonalMesh createEllipsoid(double a,
                                            double b,
                                            double c,
                                            int nslices)
```
    Creates an triangular ellipsoid mesh, centered on the origin. The mesh is constructed using spherical coordinates, with a resolution of nslices about the equator and nslices/2 longitudinally.
    
    Parameters:
    
    a - semi-axis length along x
    
    b - semi-axis length along y
    
    c - semi-axis length along z
    
    nslices - mesh resolution
    
    Returns:
    
    created ellipsoidal mesh
  - createEllipsoid
```
public static PolygonalMesh createEllipsoid(double a,
                                            double b,
                                            double c,
                                            int nslices,
                                            int nlevels)
```
    Creates an triangular ellipsoid mesh, centered on the origin. The mesh is constructed using spherical coordinates, with a resolution of nslices about the equator and nlevels longitudinally.
    
    Parameters:
    
    a - semi-axis length along x
    
    b - semi-axis length along y
    
    c - semi-axis length along z
    
    nslices - equatorial mesh resolution
    
    nlevels - longitudinal mesh resolution
    
    Returns:
    
    created ellipsoidal mesh
  - createHemisphere
```
public static PolygonalMesh createHemisphere(double r,
                                             int nslices,
                                             int nlevels)
```
    Creates an open triangular hemispherical mesh, centered on the origin, with a radius r. The mesh is constructed using spherical coordinates, with a resolution of nslices about the equator and nlevels longitudinally.
    
    Parameters:
    
    r - radius of the sphere
    
    nslices - equatorial mesh resolution
    
    nlevels - longitudinal mesh resolution
    
    Returns:
    
    created spherical mesh
  - createQuadSphere
```
public static PolygonalMesh createQuadSphere(double r,
                                             int nslices,
                                             double x,
                                             double y,
                                             double z)
```
  - computeTextureCoordsForSphere
```
public static void computeTextureCoordsForSphere(PolygonalMesh mesh,
                                                 Point3d origin,
                                                 double r,
                                                 double tol)
```
  - createQuadSphere
```
public static PolygonalMesh createQuadSphere(double r,
                                             int nslices,
                                             int nlevels,
                                             double x,
                                             double y,
                                             double z,
                                             boolean addTextureCoords)
```
  - createQuadHemisphere
```
public static PolygonalMesh createQuadHemisphere(double r,
                                                 int nslices,
                                                 int nlevels,
                                                 double x,
                                                 double y,
                                                 double z)
```
  - createSphere
```
public static PolygonalMesh createSphere(double r,
                                         int nslices,
                                         double x,
                                         double y,
                                         double z)
```
  - createQuadRoundedBox
```
public static PolygonalMesh createQuadRoundedBox(double wx,
                                                 double wy,
                                                 double wz,
                                                 int nslices)
```
    Creates a box with rounded ends on the z-axis ends. The rounding is done circularly, in the z-x plane. The z width (specified by wz) gives the distance between the centers of each semi-circle which is used to create the rounding. The mesh is quad-based, except at the center of the semi-circles.
    
    Parameters:
    
    wx - width along the x axis
    
    wy - width along the y axis
    
    wz - width along the z axis
    
    nslices - gives the number of sides used to approximate each semi-circlar end
  - createQuadRoundedBox
```
public static PolygonalMesh createQuadRoundedBox(double wx,
                                                 double wy,
                                                 double wz,
                                                 int nx,
                                                 int ny,
                                                 int nz,
                                                 int nslices,
                                                 boolean flatBottom)
```
    Creates a box with rounded ends on the z-axis ends, and with a specified mesh resolution in the x, y, and z directions. The rounding is done circularly, in the z-x plane. The z width (specified by wz) gives the distance between the centers of each semi-circle which is used to create the rounding. The mesh is quad based, except at the center of the semi-circles.
    
    Parameters:
    
    wx - width along the x axis
    
    wy - width along the y axis
    
    wz - width along the z axis
    
    nx - number of mesh divisions along x between the rounding centers
    
    ny - number of mesh divisions along y between the rounding centers
    
    nz - number of mesh divisions along z between the rounding centers
    
    nslices - gives the number of sides used to approximate each semi-circlar end
    
    flatBottom - if true, make the bottom flat instead of rounded
    
    Returns:
    
    created mesh
  - createRoundedBox
```
public static PolygonalMesh createRoundedBox(double wz,
                                             double wx,
                                             double wy,
                                             int nz,
                                             int nx,
                                             int ny,
                                             int nslices)
```
    Creates a triangular box mesh with rounded ends on the z-axis ends, and with a specified mesh resolution in the x, y, and z directions. The rounding is done circularly, in the z-x plane. The z width (specified by wz) gives the distance between the centers of each semi-circle which is used to create the rounding.
    
    Parameters:
    
    wz - width along the z axis
    
    wx - width along the x axis
    
    wy - width along the y axis
    
    nz - number of mesh divisions along z between the rounding centers
    
    nx - number of mesh divisions along x between the rounding centers
    
    ny - number of mesh divisions along y between the rounding centers
    
    nslices - gives the number of sides used to approximate each semi-circlar end
  - createRoundedBox
```
public static PolygonalMesh createRoundedBox(double wz,
                                             double wx,
                                             double wy,
                                             int nz,
                                             int nx,
                                             int ny,
                                             int nslices,
                                             boolean flatBottom)
```
    Creates a triangular box mesh with rounded ends on the z-axis ends, and with a specified mesh resolution in the x, y, and z directions. The rounding is done circularly, in the z-x plane. The z width (specified by wy) gives the distance between the centers of each semi-circle which is used to create the rounding.
    
    Parameters:
    
    wz - width along the z axis
    
    wx - width along the x axis
    
    wy - width along the y axis
    
    nz - number of mesh divisions along z between the rounding centers
    
    nx - number of mesh divisions along x between the rounding centers
    
    ny - number of mesh divisions along y between the rounding centers
    
    nslices - gives the number of sides used to approximate each semi-circlar end
    
    flatBottom - if true, make the bottom flat instead of rounded
  - createRoundedBox
```
public static PolygonalMesh createRoundedBox(double wz,
                                             double wx,
                                             double wy,
                                             int nslices)
```
    Creates a triangular box mesh with rounded ends on the z-axis ends. The rounding is done circularly, in the z-x plane. The z width (specified by wy) gives the distance between the centers of each semi-circle which is used to create the rounding.
    
    Parameters:
    
    wz - width along the z axis
    
    wx - width along the x axis
    
    wy - width along the y axis
    
    nslices - gives the number of sides used to approximate each semi-circlar end
  - createQuadRoundedCylinder
```
public static PolygonalMesh createQuadRoundedCylinder(double r,
                                                      double h,
                                                      int nslices,
                                                      int nsegs,
                                                      boolean flatBottom)
```
    Creates a cylinder with rounded (spherical) ends on the z-axis ends. This is really just a sphere with a cylinder inserted along the equator. The cylinder portion is divided into a prescribed number of segments (nsegs). The mesh is made of quads except at the poles of the rounded ends. An argument flatBottom can be used to request that the bottom of cylinder is flat instead of rounded.
    
    Parameters:
    
    r - radius of the cylinder
    
    h - height of the cylinder along the z axis (measured as the distance between the centers of the rounded ends.
    
    nslices - number of sides used to form the cylinder. This will be rounded up to a multiple of 4.
    
    nsegs - number of segments along the length of the cylinder. This must be greater than 0.
    
    flatBottom - if true, indicates that the bottom of the cylinder should be flat instead of rounded.
  - createRoundedCylinder
```
public static PolygonalMesh createRoundedCylinder(double r,
                                                  double h,
                                                  int nslices,
                                                  int nsegs,
                                                  boolean flatBottom)
```
    Creates a triangular cylinder mesh with rounded (spherical) ends on the z-axis ends. This is really just a sphere with a cylinder inserted along the equator. The cylinder portion is divided into a prescribed number of segments (nsegs). The mesh is made of triangles. An argument flatBottom can be used to request that the bottom of cylinder is flat instead of rounded.
    
    Parameters:
    
    r - radius of the cylinder
    
    h - height of the cylinder along the z axis (measured as the distance between the centers of the rounded ends.
    
    nslices - number of sides used to form the cylinder. This will be rounded up to a multiple of 4.
    
    nsegs - number of segments along the length of the cylinder. This must be greater than 0.
    
    flatBottom - if true, indicates that the bottom of the cylinder should be flat instead of rounded.
  - createQuadCone
```
public static PolygonalMesh createQuadCone(double rtop,
                                           double rbot,
                                           double h,
                                           int nsides,
                                           int nh)
```
  - createQuadCone
```
public static PolygonalMesh createQuadCone(double rtop,
                                           double rbot,
                                           double h,
                                           int nsides)
```
  - createCone
```
public static PolygonalMesh createCone(double rtop,
                                       double rbot,
                                       double h,
                                       int nsides)
```
  - createQuadPrism
```
public static PolygonalMesh createQuadPrism(double[] xy,
                                            double h)
```
  - createPrism
```
public static PolygonalMesh createPrism(double[] xy,
                                        double h)
```
  - createQuadPrism
```
public static PolygonalMesh createQuadPrism(double[] xyTop,
                                            double[] xyBot,
                                            double h)
```
  - createQuadPrism
```
public static PolygonalMesh createQuadPrism(double[] xyTop,
                                            double[] xyBot,
                                            double h,
                                            int nH)
```
  - createPrism
```
public static PolygonalMesh createPrism(double[] xyTop,
                                        double[] xyBot,
                                        double h)
```
  - createHollowedBox
```
public static PolygonalMesh createHollowedBox(double wx,
                                              double wy,
                                              double wz,
                                              double r,
                                              int nsegs)
```
    Creates a box with a cylindrical indentation in the top, parallel to the y axis, with a radius of r and approximated by nsegs segments.
  - createSphericalPolyline
```
public static PolylineMesh createSphericalPolyline(double r,
                                                   int nslices,
                                                   int nlevels)
```
  - createSkylineMesh
```
public static PolygonalMesh createSkylineMesh(double wx,
                                              double wy,
                                              double wz,
                                              int nx,
                                              int ny,
                                              java.lang.String... depthField)
```
    Creates a "skyline" mesh, which is a mesh defined over a rectangular region in the x-y plane. The rectangle is divided into an nx X ny grid, with the depth of each grid cell in z direction defined by a discrete depth field specified by an array of strings. The depth field is given by an array of ny strings, each containing nx characters giving the depth for a specific row of grid cells. Depth field strings are ordered from higher to lower y values. Each each character should be a digit in the range '0' to '9', or ' ' which is equivalent to '0'. If d is the numeric value of the character, then the depth is given by d*wz.
    The mesh is centered on the origin, with the bottom face set at z = -wz and a depth of 0 corresponding to z = 0. If the number of strings is less then ny, or the number of characters in any given string is less then nx, the missing digits are assumed to be '0'. Extra strings or characters are ignored.
    
    Parameters:
    
    wx - width of the mesh along the x axis
    
    wy - height of the mesh along the y axis.
    
    wz - basic unit of depth
    
    nx - number of grid cells in the x direction
    
    ny - number of grid cells in the y direction
    
    depthField - character strings giving the depth of each grid cell
  - createRandomPointMesh
```
public static PointMesh createRandomPointMesh(int numv,
                                              double width)
```
    Creates a random point mesh, centered on the orgin, with a specified number of vertices and width.
  - createRefinedMesh
```
public static PolygonalMesh createRefinedMesh(PolygonalMesh orig,
                                              int res)
```
    Creates a refined version of a polygonal mesh, based on Nagata patches applied with a given resolution. The supplied mesh must be triangular, and its normals will be computed automatically.
  - getIntersection
```
public static PolygonalMesh getIntersection(PolygonalMesh mesh1,
                                            PolygonalMesh mesh2)
```
  - getUnion
```
public static PolygonalMesh getUnion(PolygonalMesh mesh1,
                                     PolygonalMesh mesh2)
```
  - getSubtraction
```
public static PolygonalMesh getSubtraction(PolygonalMesh mesh1,
                                           PolygonalMesh mesh2)
```
  - findBorderEdges
```
public static java.util.ArrayList<HalfEdge> findBorderEdges(PolygonalMesh mesh)
```
  - fillHoles
```
public static boolean fillHoles(PolygonalMesh mesh)
```
  - closeSeams
```
public static void closeSeams(PolygonalMesh mesh)
```
  - mergeVertices
```
public static void mergeVertices(PolygonalMesh mesh,
                                 Vertex3d vtx1,
                                 Vertex3d vtx2)
```
  - getFlipped
```
public static PolygonalMesh getFlipped(PolygonalMesh mesh)
```
  - createFromFaces
```
public static PolygonalMesh createFromFaces(java.lang.Iterable<Face> faces)
```
    Create a new PolygonalMesh from a subset of faces. Vertices are copied, so no longer reference the original mesh.
    
    Parameters:
    
    faces - set of faces
    
    Returns:
    
    new mesh containing copy
  - splitMesh
```
public static java.util.ArrayList<PolygonalMesh> splitMesh(PolygonalMesh splitme,
                                                           double minCosLimit,
                                                           int minSize)
```
    Splits a mesh into several pieces based on connectivity and angle between faces
    
    Parameters:
    
    splitme - mesh to split
    
    minCosLimit - cosine of limit angle, if neighbour's cosine is above this, considered connected
    
    minSize - minimum number of faces to consider as a new piece (groups of few faces are discarded)
    
    Returns:
    
    set of split meshes
  - createConvexHull
```
public static PolygonalMesh createConvexHull(MeshBase mesh)
```
    Creates a convex hull from the vertex positions of an input mesh.
    
    Parameters:
    
    mesh - input mesh providing the vertex positions
    
    Returns:
    
    convex hull mesh
  - splitMesh
```
public static java.util.ArrayList<PolygonalMesh> splitMesh(PolygonalMesh splitme)
```
    Splits a mesh into several pieces based on connectivity
    
    Parameters:
    
    splitme - mesh to split
    
    Returns:
    
    set of split meshes
  - computeConvexHull
```
public static PolygonalMesh computeConvexHull(MeshBase mesh)
```
    Builds a convex hull around a set of mesh vertices Internally relies on tetgen to generate a Delaunay tetrahedral mesh around the points
    
    Parameters:
    
    mesh - mesh with vertices
    
    Returns:
    
    convex hull surface
  - extrudeAlongVertexNormals
```
public static PolygonalMesh extrudeAlongVertexNormals(PolygonalMesh mesh,
                                                      double dx)
```
    Expands (or shrinks) a mesh by displacing its vertices along their their normals.
    
    Parameters:
    
    mesh - mesh to be extruded
    
    dx - displacement to be applied along vertex normals
    
    Returns:
    
    new extruded mesh

Class MeshFactory

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_ADD_NORMALS

Constructor Detail

MeshFactory

Method Detail

addQuadRectangle

createQuadRectangle

addQuadAnnularSector

createQuadAnnularSector

addQuadCylindricalSection

createQuadCylindricalSection

addQuadSphericalSection

createQuadSphericalSection

addQuadToroidalSection

createQuadToroidalSection

createQuadToroidalSection

createToroidalSection

createQuadTorus

createTorus

createQuadExtendedTorus

createExtendedTorus

createPlane

createRectangle

createPlane

createRectangle

createRectangle

createQuadCircularSector

createCircularSector

createCircularSector

createQuadDisk

createDisk

createQuadBox

createQuadBox

createQuadBox

createQuadBox

createBox

createBox

createBox

createBox

createBox

createBox

wrapMesh

subdivide

subdivide

subdivideCatClark

subdivideCatClark

createQuadBox

createBox

createQuadBoxNew

triangulateFaceCentroid

createCylinder

createCylinder

triangulateFaceCentroid

createOpenCylinder

createOpenQuadCylinder

createQuadCylindricalWedge

createCylindricalWedge

createQuadCylinder

createQuadTube

createTube

createPointedCylinder

relax

projectToSphere

createOctahedralSphere

createOctahedralSphere

createIcosahedralSphere

createIcosahedralSphere

createOctahedron

createIcosahedron

createOctadecahedralSphere

createQuadSphere

createSphere

createSphere

createSphere