pymel.core.general.MeshFace¶
- class MeshFace(*args, **kwargs)¶
-
- connectedVertices()¶
Return type: MeshVertex list
- geomChanged()¶
Reset the geom pointer in the MItMeshPolygon . This is now being handled automatically inside the iterator, and users should no longer need to call this method directly to sync up the iterator to changes made by MFnMesh Derived from api method maya.OpenMaya.MItMeshPolygon.geomChanged
Undo is not currently supported for this method
- getArea(space='preTransform')¶
This method gets the area of the face
Parameters : - space : Space.Space
World Space or Object Space
values: ‘transform’, ‘preTransform’, ‘object’, ‘world’
Return type: float
Derived from api method maya.OpenMaya.MSpace.getArea
- getColor(colorSetName=None)¶
This method gets the average color of the all the vertices in this face
Parameters : - colorSetName : unicode
Name of the color set.
Return type: Color
Derived from api method maya.OpenMaya.MItMeshPolygon.getColor
- getColorIndex(vertexIndex, colorSetName=None)¶
This method returns the colorIndex for a vertex of the current face.
Parameters : - vertexIndex : int
Face-relative index of vertex.
- colorSetName : unicode
Name of the color set.
Return type: int
Derived from api method maya.OpenMaya.MItMeshPolygon.getColorIndex
- getColorIndices(colorSetName=None)¶
This method returns the colorIndices for each vertex on the face.
Parameters : - colorSetName : unicode
Name of the color set.
Return type: int list
Derived from api method maya.OpenMaya.MItMeshPolygon.getColorIndices
- getColors(colorSetName=None)¶
This method gets the color of the each vertex in the current face.
Parameters : - colorSetName : unicode
Name of the color set.
Return type: Color list
Derived from api method maya.OpenMaya.MItMeshPolygon.getColors
- getEdges()¶
This method gets the indices of the edges contained in the current face.
Return type: int list Derived from api method maya.OpenMaya.MItMeshPolygon.getEdges
- getNormal(space='preTransform')¶
Return the face normal of the current polygon.
Parameters : - space : Space.Space
The transformation space
values: ‘transform’, ‘preTransform’, ‘object’, ‘world’
Return type: Vector
Derived from api method maya.OpenMaya.MSpace.getNormal
- getNormals(space='preTransform')¶
Returns the normals for all vertices in the current face
Parameters : - space : Space.Space
The transformation space
values: ‘transform’, ‘preTransform’, ‘object’, ‘world’
Return type: Vector list
Derived from api method maya.OpenMaya.MSpace.getNormals
- getPoint(index, space='preTransform')¶
Return the position of the vertex at index in the current polygon.
Parameters : - index : int
The face-relative index of the vertex in the current polygon
- space : Space.Space
The coordinate system for this operation
values: ‘transform’, ‘preTransform’, ‘object’, ‘world’
Return type: Point
Derived from api method maya.OpenMaya.MSpace.point
- getPointAtUV(uvPoint, space='preTransform', uvSet=None, tolerance=0.0)¶
Return the position of the point at the given UV value in the current polygon.
Parameters : - uvPoint : (float, float)
The UV value to try to locate
- space : Space.Space
The coordinate system for this operation
values: ‘transform’, ‘preTransform’, ‘object’, ‘world’
- uvSet : unicode
UV set to work with
- tolerance : float
tolerance value to compare float data type
Return type: Point
Derived from api method maya.OpenMaya.MSpace.getPointAtUV
- getPoints(space='preTransform')¶
Retrieves the positions of the vertices on the current face/polygon that the iterator is pointing to. Vertex positions will be inserted into the given array and will be indexed using face-relative vertex IDs (ie. ordered from 0 to (vertexCount of the face) - 1), which should not be confused with the vertexIDs of each vertex in relation to the entire mesh object.
Parameters : - space : Space.Space
The coordinate system for this operation
values: ‘transform’, ‘preTransform’, ‘object’, ‘world’
Return type: Point list
Derived from api method maya.OpenMaya.MSpace.getPoints
- getUV(vertex, uvSet=None)¶
Return the texture coordinate for the given vertex.
Parameters : - vertex : int
The face-relative vertex index to get UV for
- uvSet : unicode
UV set to work with
Return type: (float, float)
Derived from api method maya.OpenMaya.MItMeshPolygon.getUV
- getUVArea(uvSet=None)¶
This method gets the UV area of the face
Parameters : - uvSet : unicode
UV set to work with
Return type: float
Derived from api method maya.OpenMaya.MItMeshPolygon.getUVArea
- getUVAtPoint(pt, space='preTransform', uvSet=None)¶
Find the point closest to the given point in the current polygon, and return the UV value at that point.
Parameters : - pt : Point
The point to try to get UV for
- space : Space.Space
The coordinate system for this operation
values: ‘transform’, ‘preTransform’, ‘object’, ‘world’
- uvSet : unicode
UV set to work with
Return type: (float, float)
Derived from api method maya.OpenMaya.MSpace.getUVAtPoint
- getUVIndex(vertex, uvSet=None)¶
Returns the index of the texture coordinate for the given vertex. This index refers to an element of the texture coordinate array for the polygonal object returned by MFnMesh::getUVs .
Parameters : - vertex : int
The face-relative vertex index of the current polygon
- uvSet : unicode
UV set to work with
Return type: int
Derived from api method maya.OpenMaya.MItMeshPolygon.getUVIndex
- getUVSetNames()¶
This method is used to find the UV set names mapped to the current face.
Return type: list list Derived from api method maya.OpenMaya.MItMeshPolygon.getUVSetNames
- getUVs(uvSet=None)¶
Return the all the texture coordinates for the vertices of this face (in local vertex order).
Parameters : - uvSet : unicode
UV set to work with
Return type: (float list, float list)
Derived from api method maya.OpenMaya.MItMeshPolygon.getUVs
- getVertices()¶
This method gets the indices of the vertices of the current face
Return type: int list Derived from api method maya.OpenMaya.MItMeshPolygon.getVertices
- hasColor()¶
This method determines whether the current face has color-per-vertex set for any vertex.
Return type: bool Derived from api method maya.OpenMaya.MItMeshPolygon.hasColor
- hasUVs()¶
Tests whether this face has UV’s mapped or not (either all the vertices for a face should have UV’s, or none of them do, so the UV count for a face is either 0, or equal to the number of vertices).
Return type: bool Derived from api method maya.OpenMaya.MItMeshPolygon.hasUVs
- hasValidTriangulation()¶
This method checks if the face has a valid triangulation. If it doesn’t, then the face was bad geometry: it may gave degenerate points or cross over itself.
Return type: bool Derived from api method maya.OpenMaya.MItMeshPolygon.hasValidTriangulation
- isConnectedTo(component)¶
Return type: bool
- isConnectedToEdge(index)¶
This method determines whether the given edge is connected to a vertex in the current face
Parameters : - index : int
Index of the edge to be tested for
Return type: bool
Derived from api method maya.OpenMaya.MItMeshPolygon.isConnectedToEdge
- isConnectedToFace(index)¶
This method determines whether the given face is adjacent to the current face
Parameters : - index : int
Index of the face to be tested for
Return type: bool
Derived from api method maya.OpenMaya.MItMeshPolygon.isConnectedToFace
- isConnectedToVertex(index)¶
This method determines whether the given vertex shares an edge with a vertex in the current face.
Parameters : - index : int
Index of the vertex to be tested for
Return type: bool
Derived from api method maya.OpenMaya.MItMeshPolygon.isConnectedToVertex
- isConvex()¶
This method checks if the face is convex.
Return type: bool Derived from api method maya.OpenMaya.MItMeshPolygon.isConvex
- isHoled()¶
This method checks if the face has any holes.
Return type: bool Derived from api method maya.OpenMaya.MItMeshPolygon.isHoled
- isLamina()¶
This method checks if the face is a lamina (the face is folded over onto itself).
Return type: bool Derived from api method maya.OpenMaya.MItMeshPolygon.isLamina
- isOnBoundary()¶
This method determines whether the current face is on a boundary
Return type: bool Derived from api method maya.OpenMaya.MItMeshPolygon.onBoundary
- isPlanar()¶
This method checks if the face is planar
Return type: bool Derived from api method maya.OpenMaya.MItMeshPolygon.isPlanar
- isStarlike()¶
This method checks if the face is starlike. That is, a line from the centre to any vertex lies entirely within the face.
Return type: bool Derived from api method maya.OpenMaya.MItMeshPolygon.isStarlike
- isZeroArea()¶
This method checks if its a zero area face
Return type: bool Derived from api method maya.OpenMaya.MItMeshPolygon.zeroArea
- isZeroUVArea()¶
This method checks if the UV area of the face is zero
Return type: bool Derived from api method maya.OpenMaya.MItMeshPolygon.zeroUVArea
- normalIndex(localVertexIndex)¶
Returns the normal index for the specified vertex. This index refers to an element in the normal array returned by MFnMesh::getNormals . These normals are per-polygon per-vertex normals. See the MFnMesh description for more information on normals.
Parameters : - localVertexIndex : int
The face-relative index of the vertex to examine for the current polygon
Return type: int
Derived from api method maya.OpenMaya.MItMeshPolygon.normalIndex
- numColors(colorSetName=None)¶
This method checks for the number of colors on vertices in this face.
Parameters : - colorSetName : unicode
Name of the color set.
Return type: int
Derived from api method maya.OpenMaya.MItMeshPolygon.numColors
- numConnectedEdges()¶
This method checks for the number of connected edges on the vertices of this face
Return type: int Derived from api method maya.OpenMaya.MItMeshPolygon.numConnectedEdges
- numConnectedFaces()¶
This method checks for the number of connected faces
Return type: int Derived from api method maya.OpenMaya.MItMeshPolygon.numConnectedFaces
- numTriangles()¶
This Method checks for the number of triangles in this face in the current triangulation
Return type: int Derived from api method maya.OpenMaya.MItMeshPolygon.numTriangles
- polygonVertexCount()¶
Return the number of vertices for the current polygon.
Return type: int Derived from api method maya.OpenMaya.MItMeshPolygon.polygonVertexCount
- setPoint(point, index, space='preTransform')¶
Set the vertex at the given index in the current polygon.
Parameters : - point : Point
The new position for the vertex
- index : int
The face-relative index of the vertex in the current polygon
- space : Space.Space
The coordinate system for this operation
values: ‘transform’, ‘preTransform’, ‘object’, ‘world’
Derived from api method maya.OpenMaya.MSpace.setPoint
- setPoints(pointArray, space='preTransform')¶
Sets new locations for vertices of the current polygon that the iterator is pointing to.
Parameters : - pointArray : Point list
The new positions for the vertices.
- space : Space.Space
The coordinate system for this operation.
values: ‘transform’, ‘preTransform’, ‘object’, ‘world’
Derived from api method maya.OpenMaya.MSpace.setPoints
- setUV(vertexId, uvPoint, uvSet=None)¶
Modify the UV value for the given vertex in the current face. If the face is not already mapped, this method will fail.
Parameters : - vertexId : int
face-relative index of the vertex to set UV for.
- uvPoint : (float, float)
The UV values to set it to
- uvSet : unicode
UV set to work with
Derived from api method maya.OpenMaya.MItMeshPolygon.setUV
- setUVs(uArray, vArray, uvSet=None)¶
Modify the UV value for all vertices in the current face. If the face has not already been mapped, this method will fail.
Parameters : - uArray : float list
All the U values - in local face order
- vArray : float list
The corresponding V values
- uvSet : unicode
UV set to work with
Derived from api method maya.OpenMaya.MItMeshPolygon.setUVs
- updateSurface()¶
Signal that this polygonal surface has changed and needs to redraw itself. Derived from api method maya.OpenMaya.MItMeshPolygon.updateSurface
Undo is not currently supported for this method