MeshFaceList

MeshFaceList class

Provides access to the faces and Face related functionality of a Mesh.

Derived Classes:

Namespace: Rhino.Geometry.Collections
MeshFaceList: references

Properties (5)

Capacity

Gets or sets the total number of mesh triangles and quads the internal data structure can hold without resizing.

Count

Gets or sets the number of mesh faces. When getting this can includes invalid faces.

Item

Returns the mesh face at the given index.

QuadCount

Gets the number of faces that are valid quads (4 corners).

TriangleCount

Gets the number of faces that are valid triangles (3 corners).

Methods (40)

AddFace(int vertex1, int vertex2, int vertex3, int vertex4)

Appends a new quadrangular face to the end of the mesh face list.

AddFace(int vertex1, int vertex2, int vertex3)

Appends a new triangular face to the end of the mesh face list.

AddFace(MeshFace face)

Appends a new mesh face to the end of the mesh face list.

AddFaces(IEnumerable<MeshFace> faces)

Appends a list of faces to the end of the mesh face list.

AdjacentFaces(int faceIndex)

Gets all faces that share a topological edge with a given face.

Clear()

Clears the Face list on the mesh.

ConvertNonPlanarQuadsToTriangles(double planarTolerance, double angleToleranceRadians, int splitMethod)

Splits non-planar quads into two triangles based on given parameters.

ConvertQuadsToTriangles()

Splits all quads along the short diagonal.

ConvertTrianglesToQuads(double angleToleranceRadians, double minimumDiagonalLengthRatio)

Joins adjacent triangles into quads if the resulting quad is 'nice'.

CullDegenerateFaces()

Attempts to removes degenerate faces from the mesh.
Degenerate faces are faces that contains such a combination of indices, that their final shape collapsed in a line or point.
Before returning, this method also attempts to repair faces by juggling vertex indices.

DeleteFaces(IEnumerable<int> faceIndexes, bool compact)

Removes a collection of faces from the mesh without affecting the remaining geometry.

DeleteFaces(IEnumerable<int> faceIndexes)

Removes a collection of faces from the mesh without affecting the remaining geometry.

Destroy()

Releases all memory allocated to store faces. The list capacity will be 0 after this call.
Subsequent calls can add new items.

ExtractDuplicateFaces()

Extracts, or removes, duplicate faces.

ExtractFaces(IEnumerable<int> faceIndices)

Extracts, or removes, faces.

GetClashingFacePairs(int maxPairCount)

Gets an array of pairs of mesh faces that clash.

GetConnectedFaces(int faceIndex, double angleRadians, bool greaterThanAngle)

Find all connected face indices where adjacent face normals meet the criteria of angleRadians and greaterThanAngle

GetConnectedFaces(int faceIndex)

Find all connected face indices

GetConnectedFacesToEdges(int startFaceIndex, bool treatNonmanifoldLikeUnwelded)

Uses startFaceIndex and finds all connected face indexes up to unwelded or naked edges. If treatNonmanifoldLikeUnwelded is True then non-manifold edges will be considered as unwelded or naked

GetDuplicateFaces()

Finds all of the duplicate faces.

GetEnumerator()

Gets an enumerator that yields all faces in this collection.

GetFace(int index)

Returns the mesh face at the given index.

GetFaceAspectRatio(int index)

Returns the mesh face at the given index.

GetFaceBoundingBox(int faceIndex)

Gets the bounding box of a face.

GetFaceCenter(int faceIndex)

Gets the center point of a face.
For a triangular face, this is the centroid or barycenter.
For a quad, this is the average of four comer points.

GetFaceVertices(int faceIndex, out Point3f a, out Point3f b, out Point3f c, out Point3f d)

Gets the 3D location of the vertices forming a face.

GetTopologicalVertices(int faceIndex)

Gets the topology vertex indices of a face.

GetZeroAreaFaces(out int whollyDegenerateFaces, out int partiallyDegenerateFaces)

Examines and adds face indexes to whollyDegenerateFaces if the face is a triangle with zero area or a quad both triangles have zero area. Face indexes are added to partiallyDegenerateFaces when a quad has one triangle with zero area.

HasNakedEdges(int faceIndex)

Returns True if at least one of the face edges are not topologically connected to any other faces.

Insert(int index, MeshFace face)

Inserts a mesh face at a defined index in this list.

IsHidden(int faceIndex)

Gets a value indicating whether a face is hidden.
A face is hidden if, and only if, at least one of its vertices is hidden.

MergeAdjacentFaces(int edgeIndex)

Merges two triangular mesh faces that share an edge into one quadrangular face.

RemoveAt(int index, bool compact)

Removes a face from the mesh.

RemoveAt(int index)

Removes a face from the mesh.

RemoveZeroAreaFaces(ref int fixedFaceCount)

Deletes or fixes mesh faces that have zero area.

SetFace(int index, int vertex1, int vertex2, int vertex3, int vertex4)

Sets a quadrangular face at a specific index of the mesh.

SetFace(int index, int vertex1, int vertex2, int vertex3)

Sets a triangular face at a specific index of the mesh.

SetFace(int index, MeshFace face)

Sets a face at a specific index of the mesh.

ToIntArray(bool asTriangles, ref List<int> replacedIndices)

Copies all of the faces to a linear array of indices. Clean-up of vertex indices if replacedIndices is a valid List<int>

ToIntArray(bool asTriangles)

Copies all of the face indices to a linear array of indices per face. Note that this includes indices from invalid faces too.

Nothing found