This reference page is linked to from the following overview topics: Implementing a hardware shading node plug-in, Threading and Maya.

Detailed Description

Polygonal surface function set.

Note on Terminology: The following terms are used interchangeably:

mesh and object,
polygon and face,
object-relative indices and global/mesh-relative indices,
face-relative indices and local indices

object-relative indices - they range between 0..(numVertices()-1)

face-relative indices - they range between 0..(polygonVertexCount(faceId)-1)

This function set provides access to polygonal meshes. Objects of type MFn::kMesh, MFn::kMeshData, and MFn::kMeshGeom are supported. MFn::kMesh objects are shapes in the DAG, MFn::kMeshGeom objects are the raw geometry that the shapes use, and MFn::kMeshData objects are the data that is passed through dependency graph connections.

NOTE: If the function set has been initialized with a MFn::kMesh object then it must have geometry attached.

Mesh Construction Meshes are created by specifying a vertex list, a list of vertex counts per-polygon, and a list of vertices that make up the polygons. Edge data is also maintained for the mesh and can be returned to the caller. The following lists are used by the create method to construct a mesh:

vertex list All of the vertices for the mesh are stored in a master vertex list which is an array indexed from 0 to numVertices()-1. Vertices in this list can be shared among polygons.

polygon count list This is a list containing the number of vertices for each polygon. Each polygon in the mesh would have an entry in this list containing its number of vertices.

vertex connection list This is a list of the vertex id's for each polygon. Since polygons can have different numbers of vertices, the polygon count list is used to determine which polygons are represented by the various sections of this list.

There are several cases in which the create method will alter the data passed in:

If the data for the mesh is provided in such a way that the verticies for some polygons are specified in a clockwise direction, and others in a counter-clockwise direction, the edges between neighboring polygons with reversed orderings will be duplicated. In this context, "duplicating an edge" means that copies will be made of the edge's vertices and the index list for the adjoining polygons will be redefined to

use the appropriate vertices.

If the vertex connection list for a polygon specifies an edge with the same start and end verticies, those edges will be removed. (ie. a polygon specified as 1 2 2 3 4 will be transformed into 1 2 3 4).

If the same vertex appears in the vertex connection list for a polygon more than once, another vertex will be created at the same location, and the list will be altered to use the copy. (ie. a polygon specified as 1 2 3 1 4 will be transformed into 1 2 3 5 4, where 5 is in the same location as 1).

Texture Coordinates (UV's) You can optionally specify texture (uv) coordinates. UV coordinates are 2-d coordinates used for mapping textures to the polygons of a mesh. All of the uv coordinates are stored in one or more named UV sets. The default mesh uv list stores uv coordinates in an array indexed from 0 to numUVs()-1. UV's are referenced on a per-polygon per-vertex basis, so for a polygon with 4 vertices there would be 4 uv's. The uv values for a polygon are set by specifying the index of the uv for each vertex of the polygon. This index is the uv's position in the master uv array. UV's are optional so polygons do not have to have uv values associated with them. There may be only 1 or 2 polygons in a mesh that have uv coordinates set, or all of the polygons may have uv's. UV's can also be shared so several different polygons may reference the same uv's. If you are creating a UV for the first time or changing the order of the UV then you need to set the UV using one of the setUV methods and then assign new indices using one of the assignUV methods. It is not necessary to call assignUV if editing the position of an existing UV.

Color per vertex You can optionally specify color per vertex information using this class. It is possible to create and manipulate color per vertex information using the methods available. Many of the color per vertex methods have a default parameter: colorSet. If unspecified, the method will operate on the current color set.

Normals Some of the Normals in Maya are now user-settable. If the vertex normals are not set or locked, they are computed by maya when the mesh changes. If set or locked, the normals remain frozen relative to the object, unless the user unlocks them. There are 3 types of normals for a mesh:

Per-vertex per-polygon Polygonal objects store a list of per-vertex per-polygon normals (similar to the vertex list) This list is what is returned by MFnMesh::getNormals and MItMeshPolygon::getNormal(index, normal). As well, MItMeshPolygon::normalIndex( vertexIndex ) returns the index into the normal list for a particular vertex of the polygon.

For a cube, the list would contain 24 normals (4 vertices * 6 polygons) since the edges for a cube are hard and the per-vertex per-polygon normals cannot be shared. For a sphere or torus, which has smooth edges, the normals can be shared, and thus the normal list contains the same number of normals as vertices.

Per-polygon normals Polygonal objects store a normal for each polygon. These normals can be accessed via MItMeshPolygon::getNormal(normal) or MFnMesh::getPolygonNormal. So, a cube, which is comprised of 6 polygons would contain 6 such normals.

Per-vertex You can also access a normal for each vertex of the mesh, independent of any polygons. Such normals are not stored in the object, but instead are calculated by Maya upon request as the average of all the per-polygon normals for the polygons adjacent to the vertex. These normals are what is returned by MFnMesh::getVertexNormal or MItMeshVertex::getNormal.

Blind Data MFnMesh allows you to create Blind Data types, and to create and access mesh component level blind data, but not object level blind data. Object level data may be assigned through the polyBlindData command or the Blind Data Editor. However, object level blind data is just an ordinary compound dynamic attribute directly on the object. The parent attribute name is BlindDataNNNN where NNNN is the blind data typeID. e.g. if your typeId is 1001 your object will have a compound dynamic attr called BlindData1001.

Handling Components There are also three iterator classes which provide more specific control over the vertices, edges, and polygons of a mesh and are useful when dealing with components. See MItMeshPolygon, MItMeshEdge, and MItMeshVertex.

Examples:: animCubeNode.cpp, apiMeshCreator.cpp, blindDataMesh.cpp, blindDataShader.cpp, cleanPerFaceAssignmentCmd.cpp, cvColorShader.cpp, D3DGeometryItem.cpp, D3DViewportRenderer.cpp, findTexturesPerPolygonCmd.cpp, flipUVCmd.cpp, getPointAndNormal.cpp, GLSLShaderNode.cpp, hairCollisionSolver.cpp, hwColorPerVertexShader.cpp, hwManagedTextureShader.cpp, intersectCmd.cpp, listPolyHolesCmd.cpp, meshMapUtils.cpp, meshOpFty.h, meshOpFtyAction.cpp, meshRemapCmd.cpp, meshReorderCmd.cpp, meshReorderCmd.h, objExport.cpp, OpenGLViewportRenderer.cpp, particleAttrNode.cpp, polyPrimitiveCmd.cpp, polyWriter.cpp, polyWriter.h, shellNode.cpp, splitUVCmd.cpp, splitUVFtyAction.cpp, and testNobjectNode.cpp.

#include <MFnMesh.h>

Inheritance diagram for MFnMesh:

[legend]

List of all members.

Public Types
enum	MColorRepresentation { kAlpha = 1, kRGB = 3, kRGBA = 4 }
	Specifies which color components are used by a colorSet. More...
enum	SplitPlacement { kOnEdge, kInternalPoint, kInvalid }
	Specifies how a point along split is to be determined. More...
enum	BoolOperation { kIntersection = 1, kDifference, kUnion }
	Boolean operators. More...
Public Member Functions
virtual MFn::Type	type () const
	Function set type.
virtual	~MFnMesh ()
	Destructor.
	MFnMesh ()
	Default constructor.
	MFnMesh (MObject &object, MStatus *ReturnStatus=NULL)
	Constructor.
	MFnMesh (const MDagPath &object, MStatus *ret=NULL)
	Constructor.
MObject	create (int numVertices, int numPolygons, const MFloatPointArray &vertexArray, const MIntArray &polygonCounts, const MIntArray &polygonConnects, MObject parentOrOwner=MObject::kNullObj, MStatus *ReturnStatus=NULL)
	Creates a new polygonal mesh given an array of vertices and polygon connection information and sets this function set to operate on the new surface.
MObject	create (int numVertices, int numPolygons, const MPointArray &vertexArray, const MIntArray &polygonCounts, const MIntArray &polygonConnects, MObject parentOrOwner=MObject::kNullObj, MStatus *ReturnStatus=NULL)
	Creates a new polygonal mesh given an array of vertices and polygon connection information and sets this function set to operate on the new surface.
MObject	create (int numVertices, int numPolygons, const MFloatPointArray &vertexArray, const MIntArray &polygonCounts, const MIntArray &polygonConnects, const MFloatArray &uArray, const MFloatArray &vArray, MObject parentOrOwner=MObject::kNullObj, MStatus *ReturnStatus=NULL)
	Creates a new polygonal mesh given an array of vertices, polygon connection information, UV information, and sets this function set to operate on the new surface.
MObject	create (int numVertices, int numPolygons, const MPointArray &vertexArray, const MIntArray &polygonCounts, const MIntArray &polygonConnects, const MFloatArray &uArray, const MFloatArray &vArray, MObject parentOrOwner=MObject::kNullObj, MStatus *ReturnStatus=NULL)
	Creates a new polygonal mesh given an array of vertices, polygon connection information, UV information, and sets this function set to operate on the new surface.
MObject	generateSmoothMesh (MObject parentOrOwner=MObject::kNullObj, MMeshSmoothOptions options=NULL, MStatus ReturnStatus=NULL)
	Creates a new polygonal mesh using either the Smooth Mesh Preview attributes of this mesh or a set of options specified in an MMeshSmoothOptions object.
MStatus	getSmoothMeshDisplayOptions (MMeshSmoothOptions &options) const
	Retrieve the current display smoothing options for the mesh.
MStatus	setSmoothMeshDisplayOptions (const MMeshSmoothOptions &options)
	Sets the current display smoothing options for the mesh.
MObject	addPolygon (const MPointArray &vertexArray, bool mergeVertices=true, double pointTolerance=kMFnMeshPointTolerance, MObject parentOrOwner=MObject::kNullObj, MStatus *ReturnStatus=NULL)
	Adds a new polygon to this polygonal mesh.
MObject	addPolygon (const MPointArray &vertexArray, int &faceIndex, bool mergeVertices=true, double pointTolerance=kMFnMeshPointTolerance, MObject parentOrOwner=MObject::kNullObj, MStatus *ReturnStatus=NULL)
	Adds a new polygon to this polygonal mesh.
MStatus	deleteFace (int index, MDGModifier *modifier=NULL)
	Delete this face.
MStatus	deleteEdge (int index, MDGModifier *modifier=NULL)
	Delete this edge.
MStatus	deleteVertex (int index, MDGModifier *modifier=NULL)
	Delete this vertex.
MStatus	split (MIntArray &placements, MIntArray &edgeList, MFloatArray &edgeFactors, MFloatPointArray &internalPoints)
	This function splits a set of edges and faces in a continuous manner.
MStatus	subdivideFaces (MIntArray &faceList, int divisionCount)
	This function subdivides multiple faces.
MStatus	subdivideEdges (MIntArray &edgeList, int divisionCount)
	This function subdivides edges at regular intervals.
MStatus	extrudeFaces (MIntArray &faceList, int extrusionCount, MFloatVector *translation, bool extrudeTogether)
	This function extrudes a set of faces.
MStatus	extrudeEdges (MIntArray &edgeList, int extrusionCount, MFloatVector *translation, bool extrudeTogether)
	This function extrudes edges.
MStatus	duplicateFaces (MIntArray &faceList, MFloatVector *translation)
	This function duplicates a set of faces and detaches them from the rest of the mesh.
MStatus	extractFaces (MIntArray &faceList, MFloatVector *translation)
	This function detaches a set of faces from the mesh so that the resulting mesh will contain one more independant piece of geometry and leaves a hole where the faces use to be.
MStatus	collapseFaces (MIntArray &faceList)
	This function collapse faces into vertices.
MStatus	collapseEdges (MIntArray &edgeList)
	This function collapse edges into vertices.
int	numVertices (MStatus *ReturnStatus=NULL) const
	Returns the number of vertices in the vertex list for this mesh.
int	numEdges (MStatus *ReturnStatus=NULL) const
	Returns the number of edges for this mesh.
int	numPolygons (MStatus *ReturnStatus=NULL) const
	Returns the number of polygons for this mesh.
int	numFaceVertices (MStatus *ReturnStatus=NULL) const
	Returns the number of face-vertices for this mesh.
int	polygonVertexCount (int polygonId, MStatus *ReturnStatus=NULL) const
	Returns the number of vertices for the specified polygon.
int	numUVs (MStatus *ReturnStatus=NULL) const
	Returns the number of texture (uv) coordinates for this mesh.
int	numUVs (const MString &uvSet, MStatus *ReturnStatus=NULL) const
	Returns the number of texture (uv) coordinates for this mesh.
int	numColors (MStatus *ReturnStatus=NULL) const
	Returns the number of (vertex) color for this mesh.
int	numColors (const MString &colorSet, MStatus *ReturnStatus=NULL) const
	Returns the number of colors (vertex data) for this mesh.
int	numNormals (MStatus *ReturnStatus=NULL) const
	Returns the number of per-polygon per-vertex normals for this mesh.
bool	hasColorChannels (const MString &colorSet, MStatus *ReturnStatus=NULL) const
	This method returns if the color set has RGB components.
bool	hasAlphaChannels (const MString &colorSet, MStatus *ReturnStatus=NULL) const
	This method returns true if the color set has Alpha component.
MColorRepresentation	getColorRepresentation (const MString &colorSet, MStatus *ReturnStatus=NULL) const
	This method returns the color representation (RGB/RGBA/A) of a color set.
bool	isColorClamped (const MString &colorSet, MStatus *ReturnStatus=NULL) const
	This method returns if the color set has its R,G,B,and A components clamped in the range from 0 to 1.
MStatus	setIsColorClamped (const MString &colorSet, bool clamped)
	Set the color set to be clamped.
MStatus	getTriangles (MIntArray &triangleCounts, MIntArray &triangleVertices) const
	Returns the number of triangles for every polygon face and the vertex Ids of each triangle vertex.
MStatus	booleanOp (BoolOperation op, MFnMesh &mesh1, MFnMesh &mesh2)
	Computes the boolean between two meshes.
bool	closestIntersection (const MFloatPoint &raySource, const MFloatVector &rayDirection, const MIntArray faceIds, const MIntArray triIds, bool idsSorted, MSpace::Space space, float maxParam, bool testBothDirections, MMeshIsectAccelParams accelerator, MFloatPoint &hitPoint, float hitRayParam, int hitFace, int hitTriangle, float hitBary1, float hitBary2, float tolerance=1e-6, MStatus *ReturnStatus=NULL)
	Finds the closest intersection of a ray starting at raySource and travelling in rayDirection with the mesh.
bool	anyIntersection (const MFloatPoint &raySource, const MFloatVector &rayDirection, const MIntArray faceIds, const MIntArray triIds, bool idsSorted, MSpace::Space space, float maxParam, bool testBothDirections, MMeshIsectAccelParams accelerator, MFloatPoint &hitPoint, float hitRayParam, int hitFace, int hitTriangle, float hitBary1, float hitBary2, float tolerance=1e-6, MStatus *ReturnStatus=NULL)
	Finds any intersection of a ray starting at raySource and travelling in rayDirection with the mesh.
bool	allIntersections (const MFloatPoint &raySource, const MFloatVector &rayDirection, const MIntArray faceIds, const MIntArray triIds, bool idsSorted, MSpace::Space space, float maxParam, bool testBothDirections, MMeshIsectAccelParams accelerator, bool sortHits, MFloatPointArray &hitPoints, MFloatArray hitRayParams, MIntArray hitFaces, MIntArray hitTriangles, MFloatArray hitBary1, MFloatArray hitBary2, float tolerance=1e-6, MStatus *ReturnStatus=NULL)
	Finds all intersections of a ray starting at raySource and travelling in rayDirection with the mesh.
MStatus	sortIntersectionFaceTriIds (MIntArray faceIds, MIntArray triIds)
	Convenience routine for sorting faceIds or face/triangle ids before passing them into the closestIntersection(), allIntersections(), or anyIntersection() methods.
MStatus	freeCachedIntersectionAccelerator ()
	If the mesh has a cached intersection accelerator structure, then this routine forces it to be deleted.
MString	cachedIntersectionAcceleratorInfo (MStatus *ReturnStatus=NULL)
	Retrieves a string that describes the intersection acceleration structure for this object, if any.
bool	intersect (const MPoint &raySource, const MVector &rayDirection, MPointArray &points, double tolerance=kMFnMeshPointTolerance, MSpace::Space space=MSpace::kObject, MIntArray polygonIds=NULL, MStatus ReturnStatus=NULL) const
	Determines whether the given ray intersects this polygon and if so, returns the points of intersection.
MStatus	getClosestPointAndNormal (const MPoint &toThisPoint, MPoint &theClosestPoint, MVector &theNormal, MSpace::Space space=MSpace::kObject, int *closestPolygon=NULL) const
	Returns the closest point on this surface to the given point.
MStatus	getClosestPoint (const MPoint &toThisPoint, MPoint &theClosestPoint, MSpace::Space space=MSpace::kObject, int *closestPolygon=NULL) const
	Returns the closest point on this surface to the given point.
MStatus	getClosestNormal (const MPoint &toThisPoint, MVector &theNormal, MSpace::Space space=MSpace::kObject, int *closestPolygon=NULL) const
	Returns the closest point on this surface to the given point.
MStatus	getConnectedShaders (unsigned int instanceNumber, MObjectArray &shaders, MIntArray &indices) const
	Returns all the shaders (sets) connected to the specified instance of this mesh.
MStatus	getConnectedSetsAndMembers (unsigned int instanceNumber, MObjectArray &sets, MObjectArray &comps, bool renderableSetsOnly) const
	Returns all the sets connected to the specified instance of this mesh.
MObject	copy (const MObject &source, MObject parentOrOwner=MObject::kNullObj, MStatus *ReturnStatus=NULL)
	This method creates a copy of a given source mesh.
MStatus	updateSurface ()
	Signal that this polygonal mesh has changed and needs to redraw itself.
MStatus	syncObject ()
	If a non-api operation happens that many have changed the underlying Maya object wrapped by this api object, make sure that the api object references a valid maya object.
const float *	getRawPoints (MStatus *) const
	This method returns a pointer to the internal vertex list for this mesh.
const float *	getRawNormals (MStatus *) const
	This method returns a pointer to the internal normal list for this mesh.
MStatus	getPoints (MFloatPointArray &vertexArray, MSpace::Space space=MSpace::kObject) const
	This method copies the vertex list for this mesh into the given point array.
MStatus	getPoints (MPointArray &vertexArray, MSpace::Space space=MSpace::kObject) const
	This method copies the vertex list for this mesh into the given point array.
MStatus	setPoints (MFloatPointArray &vertexArray, MSpace::Space space=MSpace::kObject)
	This method copies the points in the given point array to the vertices of this polygon.
MStatus	setPoints (MPointArray &vertexArray, MSpace::Space space=MSpace::kObject)
	This method copies the points in the given point array to the vertices of this mesh.
MStatus	getVertices (MIntArray &vertexCount, MIntArray &vertexList) const
	This method retrieves the object-relative (mesh-relative/global) vertex indices for all polygons.
MStatus	getPolygonVertices (int polygonId, MIntArray &vertexList) const
	This method retrieves the object-relative (mesh-relative/global) vertex indices for the specified polygon.
MStatus	getPolygonTriangleVertices (int polygonId, int triangleId, int triangleVertices[3]) const
	This method retrieves the object-relative (mesh-relative/global) vertex indices for the specified triangle in the specified polygon.
MStatus	setPoint (int vertexId, const MPoint &pos, MSpace::Space space=MSpace::kObject)
	Sets the position of specified vertex in the vertex list for this mesh.
MStatus	getPoint (int vertexId, MPoint &pos, MSpace::Space space=MSpace::kObject) const
	Get the position of the specified vertex in this mesh's vertex list.
MStatus	getNormals (MFloatVectorArray &normals, MSpace::Space space=MSpace::kObject) const
	This method copies the normal list for this mesh into the given array.
MStatus	setNormals (MFloatVectorArray &normals, MSpace::Space space=MSpace::kObject)
	Set the normal array (user normals)
MStatus	getFaceVertexNormal (int faceIndex, int vertexIndex, MVector &normal, MSpace::Space space=MSpace::kObject) const
	Return a per-vertex-per-face normal for a given face (polygon) and given vertex.
MStatus	getFaceVertexNormals (int faceIndex, MFloatVectorArray &normals, MSpace::Space space=MSpace::kObject) const
	Return all per-vertex-per-face normals for a given face.
MStatus	getNormalIds (MIntArray &normalIdCounts, MIntArray &normalIds) const
	Return normal indices for all vertices for a all faces.
MStatus	getFaceNormalIds (int faceIndex, MIntArray &normals) const
	Return normal indices for all vertices for a given face.
MStatus	setFaceVertexNormal (MVector &normal, int faceIndex, int vertexIndex, MSpace::Space space=MSpace::kObject, MDGModifier *modifier=NULL)
	Set Normal for this face/vertex pair.
MStatus	setVertexNormal (MVector &normal, int vertexIndex, MSpace::Space space=MSpace::kObject, MDGModifier *modifier=NULL)
	Set Shared Normal for this vertex.
MStatus	setFaceVertexNormals (MVectorArray &normalArray, MIntArray &faceList, MIntArray &vertexList, MSpace::Space space=MSpace::kObject)
	Set Normals for the given face/vertex pairs.
MStatus	setVertexNormals (MVectorArray &normalArray, MIntArray &vertexList, MSpace::Space space=MSpace::kObject)
	Set Shared Normals for these vertices.
MStatus	getVertexNormal (int vertexId, MVector &normal, MSpace::Space space=MSpace::kObject) const
	This method is obsolete.
MStatus	getVertexNormal (int vertexId, bool angleWeighted, MVector &normal, MSpace::Space space=MSpace::kObject) const
	Return the normal at the given vertex.
MStatus	getVertexNormals (bool angleWeighted, MFloatVectorArray &normals, MSpace::Space space=MSpace::kObject) const
	Return all vertex normals.
MStatus	getPolygonNormal (int polygonId, MVector &normal, MSpace::Space space=MSpace::kObject) const
	Return the normal at the given polygon.
bool	isNormalLocked (int normalId, MStatus *ReturnStatus=NULL) const
	Test if the normal for a face/vertex pairs is locked (user defined).
MStatus	lockVertexNormals (MIntArray &vertexList)
	Lock Shared Normals for these vertices.
MStatus	lockFaceVertexNormals (MIntArray &faceList, MIntArray &vertexList)
	Lock Normals for these face/vertex pairs.
MStatus	unlockVertexNormals (MIntArray &vertexList)
	Unlock Shared Normals for these vertices.
MStatus	unlockFaceVertexNormals (MIntArray &faceList, MIntArray &vertexList)
	Unlock Normals for these face/vertex pairs.
int	getTangentId (int faceIndex, int vertexIndex, MStatus *ReturnStatus=NULL) const
	Return the tangent index for a given face vertex.
MStatus	getTangents (MFloatVectorArray &normals, MSpace::Space space=MSpace::kObject, const MString *uvSet=NULL) const
	Return the tangent vectors for all face vertices.
MStatus	getFaceVertexTangent (int faceIndex, int vertexIndex, MVector &tangent, MSpace::Space space=MSpace::kObject, const MString *uvSet=NULL) const
	Return the normalized tangent vector at a given face vertex.
MStatus	getFaceVertexTangents (int faceIndex, MFloatVectorArray &tangents, MSpace::Space space=MSpace::kObject, const MString *uvSet=NULL) const
	Return all per-vertex-per-face tangents for a given face.
MStatus	getBinormals (MFloatVectorArray &normals, MSpace::Space space=MSpace::kObject, const MString *uvSet=NULL) const
	Return the binormal vectors for all face vertices.
MStatus	getFaceVertexBinormal (int faceIndex, int vertexIndex, MVector &normal, MSpace::Space space=MSpace::kObject, const MString *uvSet=NULL) const
	Return the binormal vector at a given face vertex.
MStatus	getFaceVertexBinormals (int faceIndex, MFloatVectorArray &normals, MSpace::Space space=MSpace::kObject, const MString *uvSet=NULL) const
	Return all per-vertex-per-face binormals for a given face.
bool	isPolygonConvex (int faceIndex, MStatus *ReturnStatus=NULL) const
	This method determines if the specified polygon is convex.
MStatus	getEdgeVertices (int edgeId, int2 &vertexList) const
	This method retrieves the object-relative (mesh-relative/global) vertex indices corresponding to the specified edge.
bool	isEdgeSmooth (int edgeId, MStatus *ReturnStatus=NULL) const
	This method determines if the specified edge is smooth (soft).
MStatus	setEdgeSmoothing (int edgeId, bool smooth=true)
	This method sets the specified edge to be hard or smooth (soft).
MStatus	cleanupEdgeSmoothing ()
	This method updates the mesh after setEdgeSmoothing has been done.
MStatus	getCreaseEdges (MUintArray &edgeIds, MDoubleArray &creaseData) const
	This method returns the crease edges of the mesh, and also the crease data associated with those edges.
MStatus	setCreaseEdges (const MUintArray &edgeIds, const MDoubleArray &creaseData)
	This method sets the specified edges of the mesh as crease edges.
MUintArray	getInvisibleFaces (MStatus *ReturnStatus=NULL) const
	This method returns the invisible faces of the mesh.
MStatus	setInvisibleFaces (const MUintArray &faceIds, bool makeVisible=false)
	This method sets the specified faces of the mesh to be visible or invisible.
MStatus	getCreaseVertices (MUintArray &vertexIds, MDoubleArray &creaseData) const
	This method returns the crease vertices of the mesh, and also the crease data associated with those vertices.
MStatus	setCreaseVertices (const MUintArray &vertexIds, const MDoubleArray &creaseData)
	This method sets the specified vertices of the mesh as crease vertices.
int	numUVSets (MStatus *ReturnStatus=NULL) const
	Returns the number of uv sets for an object.
MString	createUVSetWithName (const MString &uvSetName, MDGModifier modifier=NULL, MStatus ReturnStatus=NULL, const MUintArray *instances=NULL)
	Create a new empty uv set for this mesh.
MString	copyUVSetWithName (const MString &fromName, const MString &toName, MDGModifier modifier=NULL, MStatus ReturnStatus=NULL)
	Copies a uv set from one to another for this mesh.
MStatus	renameUVSet (const MString &origName, const MString &newName, MDGModifier *modifier=NULL)
	Renames a uv set from one name to another for this mesh.
MStatus	deleteUVSet (const MString &setName, MDGModifier modifier=NULL, MSelectionList currentSelection=NULL)
	Deletes a named uv set from the object.
MStatus	setCurrentUVSetName (const MString &setName, MDGModifier modifier=NULL, MSelectionList currentSelection=NULL)
	Set the "current" uv set for this object.
MString	currentUVSetName (MStatus *ReturnStatus=NULL, int instance=kMFnMeshInstanceUnspecified) const
	Get the name of the "current" uv set.
MStatus	getUVSetNames (MStringArray &setNames) const
	Get the names of all of the uv sets on this object.
MStatus	getUVSetFamilyNames (MStringArray &familyNames) const
	Get the names of all of the uv set families on this object.
MStatus	getUVSetsInFamily (const MString &familyName, MStringArray &setNames) const
	Get the names of the uv sets that belong to this set family.
bool	isUVSetPerInstance (const MString &name, MStatus *ReturnStatus=NULL) const
	Return true if this set is per-instance, and false if it is shared across all instances.
MStatus	getFaceUVSetNames (int polygonId, MStringArray &setNames) const
	This method returns the list of UV sets mapped to a face.
MStatus	getAssociatedUVSetTextures (const MString uvSetName, MObjectArray &textures) const
	Get a list of texture nodes which are using a given uv set.
MStatus	getAssociatedUVSetInstances (const MString &uvSetName, MIntArray &instances) const
	Get a list of the instance numbers associated with this uv map.
MStatus	setUVs (const MFloatArray &uArray, const MFloatArray &vArray, const MString *uvSet=NULL)
	Sets all of the texture coordinates (uv's) for this mesh.
MStatus	setSomeUVs (const MIntArray &uvIds, const MFloatArray &uArray, const MFloatArray &vArray, const MString *uvSet=NULL)
	Sets the specified texture coordinates (UV's) for this mesh.
MStatus	getUVs (MFloatArray &uArray, MFloatArray &vArray, const MString *uvSet=NULL) const
	This method copies the texture coordinate list for this mesh into the given uv arrays.
MStatus	setUV (int uvId, float u, float v, const MString *uvSet=NULL)
	Sets the specified texture coordinate.
MStatus	getUV (int uvId, float &u, float &v, const MString *uvSet=NULL) const
	Get the value of the specified texture coordinate from this mesh's uv list.
MStatus	getPointAtUV (int polygonId, MPoint &theClosestPoint, float2 &uvPoint, MSpace::Space space=MSpace::kObject, const MString *uvSet=NULL, float tolerance=0.0)
	Return the position of the point at the given UV value in the current polygon.
MStatus	getUVAtPoint (MPoint &pt, float2 &uvPoint, MSpace::Space space=MSpace::kObject, const MString uvSet=NULL, int closestPolygon=NULL)
	Find the point closet to the given point, and return the UV value at that point.
MStatus	getPolygonUV (int polygonId, int vertexIndex, float &u, float &v, const MString *uvSet=NULL) const
	Get the value of the specified texture coordinate for a vertex in a polygon.
MStatus	getPolygonUVid (int polygonId, int vertexIndex, int &uvId, const MString *uvSet=NULL) const
	Get the id of the specified texture coordinate for a vertex in a polygon.
MStatus	assignUV (int polygonId, int vertexIndex, int uvId, const MString *uvSet=NULL)
	Maps a texture coordinate to a specified vertex of a polygon.
MStatus	assignUVs (const MIntArray &uvCounts, const MIntArray &uvIds, const MString *uvSet=NULL)
	This method maps all texture coordinates for the mesh.
MStatus	clearUVs (const MString *uvSet=NULL)
	This method clears out all texture coordinates for the mesh, and leaves behind an empty UVset.
MStatus	getAssignedUVs (MIntArray &uvCounts, MIntArray &uvIds, const MString *uvSet=NULL) const
	Get assigned UVs.
MStatus	getUvShellsIds (MIntArray &uvShellIds, unsigned int &nbUvShells, const MString *uvSet=NULL) const
	Constructs an array of unique integer for each UV shell.
int	numColorSets (MStatus *ReturnStatus=NULL) const
	Returns the number of color sets for an object.
MString	createColorSetWithName (const MString &colorSetName, MDGModifier modifier=NULL, const MUintArray instances=NULL, MStatus *ReturnStatus=NULL)
	Create a new empty color set for this mesh.
MStatus	deleteColorSet (const MString &colorSetName, MDGModifier modifier=NULL, MSelectionList currentSelection=NULL)
	Deletes a named color set from the object.
MStatus	setCurrentColorSetName (const MString &setName, MDGModifier modifier=NULL, MSelectionList currentSelection=NULL)
	Set the "current" or "working" color set for this object.
MString	currentColorSetName (int instance=kMFnMeshInstanceUnspecified, MStatus *ReturnStatus=NULL) const
	Get the name of the "current" or "working" color set.
MStatus	getColorSetNames (MStringArray &setNames) const
	Get the names of all of the colors sets on this object.
MStatus	getColorSetFamilyNames (MStringArray &familyNames) const
	Get the names of all of the color set families on this object.
MStatus	getColorSetsInFamily (const MString &familyName, MStringArray &setNames) const
	Get the names of the color sets that belong to this set family.
bool	isColorSetPerInstance (const MString &name, MStatus *ReturnStatus=NULL) const
	Return true if this color set is per-instance, and false if it is shared across all instances.
MStatus	getAssociatedColorSetInstances (const MString &setName, MIntArray &instances) const
	Get a list of the instance numbers associated with this color map.
MStatus	setFaceColor (MColor &color, int index)
	Set vertex-face Color for all vertices on this face.
MStatus	setFaceColor (MColor &color, int index, MColorRepresentation rep)
	Set vertex-face Color of specified channels for all vertices on this face.
MStatus	setVertexColor (MColor &color, int index, MDGModifier *modifier=NULL)
	Set color for this vertex.
MStatus	setVertexColor (MColor &color, int index, MDGModifier *modifier, MColorRepresentation rep)
	Set color of specified channels for this vertex.
MStatus	setFaceVertexColor (MColor &color, int faceIndex, int vertexIndex, MDGModifier *modifier=NULL)
	Set color for this vertex in this face.
MStatus	setFaceVertexColor (MColor &color, int faceIndex, int vertexIndex, MDGModifier *modifier, MColorRepresentation rep)
	Set color of specified channels for this vertex in this face.
MStatus	setFaceVertexColor (int faceIndex, int localVertexIndex, MColor &color, MDGModifier *modifier=NULL)
	Set color for this vertex in this face.
MStatus	setFaceVertexColor (int faceIndex, int localVertexIndex, MColor &color, MDGModifier *modifier, MColorRepresentation rep)
	Set color of specified channels for this vertex in this face.
MStatus	setFaceColors (MColorArray &colors, MIntArray &faceList)
	Set color for these faces.
MStatus	setFaceColors (MColorArray &colors, MIntArray &faceList, MColorRepresentation rep)
	Set color of specified channels for these faces.
MStatus	setVertexColors (MColorArray &colors, MIntArray &vertexList, MDGModifier *modifier=NULL)
	Set color for these vertices.
MStatus	setVertexColors (MColorArray &colors, MIntArray &vertexList, MDGModifier *modifier, MColorRepresentation rep)
	Set color of specified channels for these vertices.
MStatus	setFaceVertexColors (MColorArray &colors, MIntArray &faceList, MIntArray &vertexList, MDGModifier *modifier=NULL)
	Set colors for these face/vertex pairs.
MStatus	setFaceVertexColors (MColorArray &colors, MIntArray &faceList, MIntArray &vertexList, MDGModifier *modifier, MColorRepresentation rep)
	Set colors of specified channels for these face/vertex pairs.
MStatus	removeFaceColors (MIntArray &faceList)
	Remove previously set color these faces.
MStatus	removeVertexColors (MIntArray &vertexList)
	Remove color from these vertices.
MStatus	removeFaceVertexColors (MIntArray &faceList, MIntArray &vertexList)
	Remove colors for these face/vertex pairs.
MStatus	getVertexColors (MColorArray &colors, const MString colorSet=NULL, const MColor defaultUnsetColor=NULL)
	Get colors for all Vertices of the given colorSet.
MStatus	getFaceVertexColors (MColorArray &colors, const MString colorSet=NULL, const MColor defaultUnsetColor=NULL)
	Get colors for all vertex/faces of the given color set.
MStatus	getFaceVertexColorIndex (int faceIndex, int localVertexIndex, int &colorIndex, const MString *colorSet=NULL)
	Get an index into the array returned by getFaceVertexColors.
MStatus	setColors (const MColorArray &colors, const MString *colorSet=NULL)
	Sets all of the colors for this mesh.
MStatus	setColors (const MColorArray &colors, const MString *colorSet, MColorRepresentation rep)
	Sets all of the colors of specified channels for this mesh.
MStatus	setSomeColors (const MIntArray &colorIds, const MColorArray &colors, const MString *colorSet=NULL)
	Sets the specified colors for this mesh.
MStatus	setSomeColors (const MIntArray &colorIds, const MColorArray &colors, const MString *colorSet, MColorRepresentation rep)
	Sets the specified colors of specified channels for this mesh.
MStatus	getColors (MColorArray &colors, const MString colorSet=NULL, const MColor defaultUnsetColor=NULL) const
	This method copies the color array for this mesh into the given color array.
MStatus	getColorIndex (int faceIndex, int localVertexIndex, int &colorIndex, const MString *colorSet=NULL)
	Get an index into the array returned by getColors.
MStatus	setColor (int colorId, const MColor &color, const MString *colorSet=NULL)
	Sets the specified color values.
MStatus	setColor (int colorId, const MColor &color, const MString *colorSet, MColorRepresentation rep)
	Sets the specified color values of specified channels.
MStatus	getColor (int colorId, MColor &color, const MString colorSet=NULL, const MColor defaultUnsetColor=NULL) const
	Get the value of the specified texture coordinate from this mesh's color list.
MStatus	assignColor (int polygonId, int vertexIndex, int colorId, const MString *colorSet=NULL)
	Maps a color value to a specified vertex of a polygon.
MStatus	assignColors (const MIntArray &colorIds, const MString *colorSet=NULL)
	This method maps all colors for the mesh.
MStatus	clearColors (const MString *colorSet=NULL)
	This method clears out all color for the mesh, and leaves behind an empty color set.
bool	displayColors (MStatus *ReturnStatus=NULL) const
	Determine if the mesh node is set to display vertex colors.
MStatus	setDisplayColors (bool enable)
	Set whether the mesh node should display vertex colors.
int	getHoles (MIntArray &holeInfoArray, MIntArray &holeVertexArray, MStatus *ReturnStatus=NULL)
	Retrieves a list of the holes in the polygon.
bool	onBoundary (int polygonId, MStatus *ReturnStatus=NULL) const
	A method to determines whether the specified face in the mesh is a boundary face.
bool	isBlindDataTypeUsed (int blindDataId, MStatus *ReturnStatus=NULL) const
	Is this BlindData type id is already in use in this scene?
MStatus	createBlindDataType (int blindDataId, MStringArray longNames, MStringArray shortNames, MStringArray formatNames)
	Create a new blind data type.
bool	hasBlindDataComponentId (int compID, MFn::Type compType, int blindDataId, MStatus *ReturnStatus=NULL) const
	Does this component have blind data with the given ID.
bool	hasBlindData (MFn::Type compType, int blindDataId, MStatus *ReturnStatus=NULL) const
	Returns true if any component of the given type on this mesh have blind data with the given ID.
bool	hasBlindDataComponentId (int compID, MFn::Type compType, MStatus *ReturnStatus=NULL) const
	Does this component have any kind of blind data.
bool	hasBlindData (MFn::Type compType, MStatus *ReturnStatus=NULL) const
	Does any component of this type have any blind data.
MStatus	getBlindDataTypes (MFn::Type compType, MIntArray &blindDataIds) const
	Get the list of blind data ID's associated with the given component type on this mesh.
MStatus	getBlindDataAttrNames (int blindDataId, MStringArray &longNames, MStringArray &shortNames, MStringArray &formatNames) const
	Get the blind data attribute names and types for the specified blind data type id.
MStatus	getFaceVertexBlindDataIndex (int faceIndex, int vertexIndex, int &blindDataIndex) const
	Get the single index to retrieve face-vertex blind data.
MStatus	getBlindDataFaceVertexIndices (int blindDataIndex, int &faceIndex, int &vertexIndex) const
	Get the face and vertex indices from the face-vertex blind data index.
MStatus	getIntBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName, int &data) const
	Get the blind data value for the specified blind data attribute of the specified component.
MStatus	getIntBlindData (MFn::Type compType, int blindDataId, MString attrName, MIntArray &compIDs, MIntArray &data) const
	Get the blind data value for the specified blind data attribute of the given type of component.
MStatus	getFloatBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName, float &data) const
	Get the blind data value for the specified blind data attribute of the specified component.
MStatus	getFloatBlindData (MFn::Type compType, int blindDataId, MString attrName, MIntArray &compIDs, MFloatArray &data) const
	Get the blind data value for the specified blind data attribute for all components of the given type.
MStatus	getDoubleBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName, double &data) const
	Get the blind data value for the specified blind data attribute of the specified component.
MStatus	getDoubleBlindData (MFn::Type compType, int blindDataId, MString attrName, MIntArray &compIDs, MDoubleArray &data) const
	Get the blind data value for the specified blind data attribute for all components of the given type.
MStatus	getBoolBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName, bool &data) const
	Get the blind data value for the specified blind data attribute of the specified component.
MStatus	getBoolBlindData (MFn::Type compType, int blindDataId, MString attrName, MIntArray &compIDs, MIntArray &data) const
	Get the blind data value for the specified blind data attribute for all components of the given type.
MString	stringBlindDataComponentId (int compID, MFn::Type compType, int blindDataId, MString attrName, MStatus *ReturnStatus=NULL) const
	Get the blind data value for the specified blind data attribute of the specified component.
MStatus	getStringBlindData (MFn::Type compType, int blindDataId, MString attrName, MIntArray &compIDs, MStringArray &data) const
	Get the blind data value for the specified blind data attribute for all components of the given type.
MString	binaryBlindDataComponentId (int compID, MFn::Type compType, int blindDataId, MString attrName, MStatus *ReturnStatus=NULL) const
	Get the blind data value for the specified blind data attribute of the specified component.
MStatus	getBinaryBlindData (MFn::Type compType, int blindDataId, MString attrName, MIntArray &compIDs, MStringArray &data) const
	Get the blind data value for the specified blind data attribute for all components of the given type.
MStatus	setIntBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName, int data)
	Set a value for an integer blind data attribute.
MStatus	setIntBlindData (MIntArray &compIDs, MFn::Type compType, int blindDataId, MString attrName, int data)
	Set a value for an integer blind data on an array of components.
MStatus	setIntBlindData (MIntArray &compIDs, MFn::Type compType, int blindDataId, MString attrName, MIntArray &data)
	Set a values for an integer blind data on an array of components.
MStatus	setFloatBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName, float data)
	Set a value for a float blind data attribute.
MStatus	setFloatBlindData (MIntArray &compIDs, MFn::Type compType, int blindDataId, MString attrName, float data)
	Set a value for float blind data on an array of components.
MStatus	setFloatBlindData (MIntArray &compIDs, MFn::Type compType, int blindDataId, MString attrName, MFloatArray &data)
	Set a values for a float blind data on an array of components.
MStatus	setDoubleBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName, double data)
	Set a value for a double blind data attribute.
MStatus	setDoubleBlindData (MIntArray &compIDs, MFn::Type compType, int blindDataId, MString attrName, double data)
	Set a value for double blind data on an array of components.
MStatus	setDoubleBlindData (MIntArray &compIDs, MFn::Type compType, int blindDataId, MString attrName, MDoubleArray &data)
	Set a values for a double blind data on an array of components.
MStatus	setBoolBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName, bool data)
	Set a value for a boolean blind data attribute.
MStatus	setBoolBlindData (MIntArray &compIDs, MFn::Type compType, int blindDataId, MString attrName, bool data)
	Set a value for boolean blind data on an array of components.
MStatus	setBoolBlindData (MIntArray &compIDs, MFn::Type compType, int blindDataId, MString attrName, MIntArray &data)
	Set a values for a boolean blind data on an array of components.
MStatus	setStringBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName, MString data)
	Set a value for a string blind data attribute.
MStatus	setStringBlindData (MIntArray &compIDs, MFn::Type compType, int blindDataId, MString attrName, MString data)
	Set a value for string blind data on an array of components.
MStatus	setStringBlindData (MIntArray &compIDs, MFn::Type compType, int blindDataId, MString attrName, MStringArray &data)
	Set a values for a string blind data on an array of components.
MStatus	setBinaryBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName, MString data)
	Set a value for a binary blind data attribute.
MStatus	setBinaryBlindData (MIntArray &compIDs, MFn::Type compType, int blindDataId, MString attrName, MString data)
	Set a value for binary blind data on an array of components.
MStatus	setBinaryBlindData (MIntArray &compIDs, MFn::Type compType, int blindDataId, MString attrName, MStringArray &data)
	Set a values for a binary blind data on an array of components.
MStatus	setBinaryBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName, char *data, int length)
	Set a value for a binary blind data attribute.
MStatus	clearBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName)
	Delete a value for a binary blind data attribute on a particular componenr.
MStatus	clearBlindData (MFn::Type compType, int blindDataId, MString attrName)
	Delete the values for the given attribute on the given binary blind data type from all components of the given type.
MStatus	clearBlindData (MFn::Type compType)
	Delete all blind data from components of the given type, e.g.
MStatus	clearBlindData (int compID, MFn::Type compType, int blindDataId)
	Delete the values for a binary blind data type (all its attributes) from a particular component.
MStatus	clearBlindData (MFn::Type compType, int blindDataId)
	Delete the values for a binary blind data type (all its attributes) from all components of the given type.
void	setCheckSamePointTwice (bool check=true)
	This method allows the turning on or off of duplicate point checking when polygons are created or added using this class.
bool	getCheckSamePointTwice (void)
	Return true if checking for duplicate points is turned on.
MStatus	createInPlace (int numVertices, int numPolygons, const MFloatPointArray &vertexArray, const MIntArray &polygonCounts, const MIntArray &polygonConnects)
	Replaces the existing polygonal mesh with a new one specified by array of vertices and polygon connection information.
MStatus	copyInPlace (const MObject &source)
	This method creates copies the given source mesh onto the current surface.
MString	createColorSetWithName (const MString &colorSetName, MDGModifier modifier, MStatus ReturnStatus)
	This method is obsolete.
MString	currentColorSetName (MStatus *ReturnStatus) const
	This method is obsolete. This method is not available in Python.
MObject	generateSmoothMesh (MObject parentOrOwner, MStatus *ReturnStatus)
	This method is obsolete.
	MFnMesh (const MObject &object, MStatus *ret=NULL)
	Constructor.
MObject	addPolygon (MPointArray &vertexArray, double polyTolerance, bool mergeVertices=true, double pointTolerance=kMFnMeshPointTolerance, bool forceGeometry=true, MObject parentOrOwner=MObject::kNullObj, MStatus *ReturnStatus=NULL)
	This method is obsolete. This method is not available in Python.
bool	intersect (MPoint &raySource, MVector &rayDirection, MPointArray &points, MStatus *ReturnStatus=NULL) const
	This method is obsolete. This method is not available in Python.
bool	intersect (const MPoint &raySource, const MVector &rayDirection, MPointArray &points, MStatus *ReturnStatus=NULL) const
	This method is obsolete. This method is not available in Python.
MStatus	getBlindDataAttrNames (int blindDataId, MStringArray &longNames, MStringArray &shortNames) const
	Get the blind data attribute names for the specified blind data type id.
bool	hasBlindData (int compID, MFn::Type compType, int blindDataId, MStatus *ReturnStatus=NULL) const
	This method is obsolete. This method is not available in Python.
bool	hasBlindData (int compID, MFn::Type compType, MStatus *ReturnStatus=NULL) const
	This method is obsolete. This method is not available in Python.
MStatus	createUVSet (MString &uvSetName, MDGModifier modifier=NULL, const MUintArray instances=NULL)
	This method is not available in Python.
MStatus	copyUVSet (const MString &fromName, MString &toName, MDGModifier *modifier=NULL)
	This method is not available in Python.
MStatus	getCurrentUVSetName (MString &setName, int instance=kMFnMeshInstanceUnspecified) const
	This method is not available in Python.
MStatus	createColorSet (MString &colorSetName, MDGModifier modifier=NULL, const MUintArray instances=NULL)
	This method is not available in Python.
MStatus	createColorSet (MString &colorSetName, MDGModifier modifier, bool clamped, MColorRepresentation rep, const MUintArray instances=NULL)
	This method is not available in Python.
MStatus	getCurrentColorSetName (MString &setName, int instance=kMFnMeshInstanceUnspecified) const
	This method is not available in Python.
MStatus	getStringBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName, MString &data) const
	This method is obsolete. This method is not available in Python.
MStatus	getBinaryBlindData (int compID, MFn::Type compType, int blindDataId, MString attrName, MString &data) const
	This method is obsolete. This method is not available in Python.
Static Public Member Functions
static MMeshIsectAccelParams	uniformGridParams (int xDiv, int yDiv, int zDiv)
	Creates a MMeshIsectAccelParams configuration object to pass to the methods MFnMesh::closestIntersection(), MFnMesh::anyIntersection(), or MFnMesh::allIntersections().
static MMeshIsectAccelParams	autoUniformGridParams ()
	Creates a MMeshIsectAccelParams configuration object to pass to the methods MFnMesh::closestIntersection(), MFnMesh::anyIntersection(), or MFnMesh::allIntersections().
static MString	globalIntersectionAcceleratorsInfo ()
	Retrieves a string that describes the systemwide resource usage for cached mesh intersection accelerators.
static void	clearGlobalIntersectionAcceleratorInfo ()
	As described above, clears the "total count", "total build time", and "peak memory" fields from the information string returned by globalIntersectionAcceleratorsInfo().
Protected Member Functions
virtual const char *	className () const
	Class name.

kAlpha	Alpha only. Search for all occurrences
kRGB	Red, green and blue only. Search for all occurrences
kRGBA	Red, green, blue and alpha. Search for all occurrences

kOnEdge	Split at a position along an edge. Search for all occurrences
kInternalPoint	Split at a point within a face. Search for all occurrences
kInvalid	Search for all occurrences

kIntersection	Boolean interesection. Search for all occurrences
kDifference	Boolean difference. Search for all occurrences
kUnion	Boolean union. Search for all occurrences

[in]	object	The MObject to attach the function set to
[out]	ReturnStatus	the return status

MFnMesh	(	const MDagPath &	object,
		MStatus *	ReturnStatus = `NULL`
	)

[in]	object	The const MDagPath to attach the function set to
[out]	ReturnStatus	The return status

MFnMesh	(	const MObject &	object,
		MStatus *	ReturnStatus = `NULL`
	)

MObject create	(	int	numVertices,
		int	numPolygons,
		const MFloatPointArray &	vertexArray,
		const MIntArray &	polygonCounts,
		const MIntArray &	polygonConnects,
		MObject	parentOrOwner = `MObject::kNullObj`,
		MStatus *	ReturnStatus = `NULL`
	)

[in]	numVertices	number of vertices
[in]	numPolygons	number of polygons
[in]	vertexArray	point (vertex) array. This should include all the vertices in the mesh, and no extras. For example, a cube could have the vertices: { (-1,-1,-1), (1,-1,-1), (1,-1,1), (-1,-1,1), (-1,1,-1), (-1,1,1), (1,1,1), (1,1,-1) }
[in]	polygonCounts	array of vertex counts for each polygon. For example the cube would have 6 faces, each of which had 4 verts, so the polygonCounts would be {4,4,4,4,4,4}.
[in]	polygonConnects	array of vertex connections for each polygon. For example, in the cube, we have 4 vertices for every face, so we list the vertices for face0, face1, etc consecutively in the array. These are specified by indexes in the vertexArray: e.g for the cube: { 0, 1, 2, 3, 4, 5, 6, 7, 3, 2, 6, 5, 0, 3, 5, 4, 0, 4, 7, 1, 1, 7, 6, 2 }
[in]	parentOrOwner	parent of the polygon that will be created
[out]	ReturnStatus	Status code

MObject generateSmoothMesh	(	MObject	parentOrOwner = `MObject::kNullObj`,
		MMeshSmoothOptions *	options = `NULL`,
		MStatus *	ReturnStatus = `NULL`
	)

[in]	faceId	The face to delete
[in,out]	modifier	Since this method may modify the DG, if you wish to undo its effects, you need to keep track of what needs to be undone. If the modifier is non-null, and this MFnMesh refers to a shape, then it will add the command to be undone to the modifier. Use MDGModifier::undoIt to undo the effects of this method.

[in]	edgeId	The edge to delete
[in,out]	modifier	Since this method may modify the DG, if you wish to undo its effects, you need to keep track of what to be undone. If the modifier is non-null, and this MFnMesh refers to a shape, then it will add the command to be undone to the modifier. Use MDGModifier::undoIt to undo the effects of this method.

[in]	vertexId	The object-relative (mehs-relative/global) vertex index to delete
[in,out]	modifier	Since this method may modify the DG, if you wish to undo its effects, you need to keep track of what needs to be undone. If the modifier is non-null, and this MFnMesh refers to a shape, then it will add the command to be undone to the modifier. Use MDGModifier::undoIt to undo the effects of this method.

MObject addPolygon	(	const MPointArray &	vertexArray,
		bool	mergeVertices = `true`,
		double	pointTolerance = `kMFnMeshPointTolerance`,
		MObject	parentOrOwner = `MObject::kNullObj`,
		MStatus *	ReturnStatus = `NULL`
	)

[in]	vertexArray	array of ordered vertices that make up the polygon
[in]	mergeVertices	If true then if a vertex falls within pointTolerance of an existing vertex then the existing vertex is reused.
[in]	pointTolerance	specifies how close verticies have to be to before they are merged. This merging is only done if mergeVerticies is true.
[in]	parentOrOwner	the DAG parent or kMeshData the new surface will belong to
[out]	ReturnStatus	status code

MStatus deleteFace	(	int	faceId,
		MDGModifier *	modifier = `NULL`
	)

MStatus deleteEdge	(	int	edgeId,
		MDGModifier *	modifier = `NULL`
	)

MStatus deleteVertex	(	int	vertexId,
		MDGModifier *	modifier = `NULL`
	)

MStatus split	(	MIntArray &	placements,
		MIntArray &	edgeList,
		MFloatArray &	edgeFactors,
		MFloatPointArray &	internalPoints
	)

[in]	placements	array that contains elements of the SplitPlacement enumeration. They represent where to place the new vertices for the split.
[in]	edgeList	array of edge IDs to be split, in order of their appearance in the split. There must be as many elements in this array as there are SplitPlacement::kOnEdge elements in the placements array.
[in]	edgeFactors	array of factors in the range [0,1] that represent how far along each edge must the split be done. This array must have the same number of elements as the edgeList array.
[in]	internalPoints	array of positions for the vertices that will be added inside existing faces. There must be as many elements in this array as there are SplitPlacement::kInternalPoint elements in the placements array. This array can be empty. Internal points should be specified on the face between the previous edge id and the next edge id.

MStatus subdivideFaces	(	MIntArray &	faceList,
		int	divisionCount
	)

[in]	faceList	array of face IDs to subdivide
[in]	divisionCount	number of subsequent subdivisions to do

MStatus subdivideEdges	(	MIntArray &	edgeList,
		int	divisionCount
	)

MFnMesh Class Reference

OpenMaya - API module for common classes | FunctionSet classes

Detailed Description

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

[in]	edgeList	array of edge component IDs to be subdivided
[in]	divisionCount	number of subsequent subdivisions to do

MStatus extrudeFaces	(	MIntArray &	faceList,
		int	extrusionCount,
		MFloatVector *	translation,
		bool	extrudeTogether
	)

[in]	faceList	array of face component IDs to be extruded
[in]	extrusionCount	number of subsequent extrusions to do
[in]	translation	translation vector to apply to the extruded elements. This is a world-space translation. Use NULL if not required.
[in]	extrudeTogether	sets whether the components should be extruded individually or together, as if one complex component was being extruded.

MStatus extrudeEdges	(	MIntArray &	edgeList,
		int	extrusionCount,
		MFloatVector *	translation,
		bool	extrudeTogether
	)

[in]	edgeList	array of edge component IDs to be extruded
[in]	extrusionCount	number of subsequent extrusions to do
[in]	translation	translation vector to apply to the extruded elements. This is a world-space translation. Use NULL if not required.
[in]	extrudeTogether	sets whether the components should be extruded individually or together, as if one complex component was being extruded.

MStatus duplicateFaces	(	MIntArray &	faceList,
		MFloatVector *	translation
	)

[in]	faceList	array of face component IDs to be duplicated
[in]	translation	translation vector to apply to the duplicated elements. This is a world-space translation. Use NULL if not required.

MStatus extractFaces	(	MIntArray &	faceList,
		MFloatVector *	translation
	)

[in]	faceList	array of face component IDs to be extracted
[in]	translation	translation vector to apply to the extracted elements. This is a world-space translation. Use NULL if not required.

int polygonVertexCount	(	int	polygonId,
		MStatus *	ReturnStatus = `NULL`
	)		const