#include <MItMeshEdge.h>
Polygon edge iterator.
This class is the edge iterator for polygonal surfaces.
The iterator functions in two modes depending on whether a component is specified. When a component is not given or is NULL the iteration will be over all edges for the polygon. When a component is given this iterator will iterate over the edges specified in the component. When iterating over components a DAG path to the polygon must also be supplied.
Public Member Functions | |
MItMeshEdge (MObject &polyObject, MStatus *ReturnStatus=NULL) | |
Constructor. More... | |
MItMeshEdge (MObject &polyObject, MObject &component, MStatus *ReturnStatus=NULL) | |
Constructor. More... | |
MItMeshEdge (const MDagPath &polyObject, MObject &component=MObject::kNullObj, MStatus *ReturnStatus=NULL) | |
Constructor. More... | |
virtual | ~MItMeshEdge () |
Destructor. More... | |
bool | isDone (MStatus *ReturnStatus=NULL) |
Indicates if all of the edges have been traversed yet. More... | |
MStatus | next () |
Advance to the next edge in the iteration. More... | |
MStatus | reset () |
Reset the iterator to the first edge. More... | |
MStatus | reset (MObject &polyObject, MObject &component=MObject::kNullObj) |
Reset the iterator to the first edge in the supplied mesh. More... | |
MStatus | reset (const MDagPath &polyObject, MObject &component=MObject::kNullObj) |
Reset the iterator to the first edge in the supplied mesh. More... | |
int | count (MStatus *ReturnStatus=NULL) |
Return the number of edges in this iteration. More... | |
MPoint | center (MSpace::Space space=MSpace::kObject, MStatus *ReturnStatus=NULL) |
Returns the center of the current edge. More... | |
MPoint | point (int index, MSpace::Space space=MSpace::kObject, MStatus *ReturnStatus=NULL) |
Return the position of the specified vertex of the current edge. More... | |
MStatus | setPoint (const MPoint &point, unsigned int index, MSpace::Space space=MSpace::kObject) |
Set the specified vertex of the current edge to the given value. More... | |
bool | isSmooth (MStatus *ReturnStatus=NULL) const |
This method determines if the current edge in the iteration is smooth (soft). More... | |
MStatus | setSmoothing (bool smooth=true) |
This method sets the current edge to be hard or smooth (soft). More... | |
MStatus | cleanupSmoothing () |
This method is obsolete. More... | |
int | index (int index, MStatus *ReturnStatus=NULL) |
This method returns a vertex index for the current edge based upon the specified index. More... | |
int | index (MStatus *ReturnStatus=NULL) const |
This method returns the index of the current edge in the iteration. More... | |
MObject | edge (MStatus *ReturnStatus=NULL) |
This method is obsolete. More... | |
MObject | currentItem (MStatus *ReturnStatus=NULL) |
Get the current edge in the iteration as a component. More... | |
MStatus | updateSurface () |
Signal that this polygonal surface has changed and needs to redraw itself. More... | |
MStatus | geomChanged () |
Reset the geom pointer in the MItMeshEdge. More... | |
MStatus | setIndex (int index, int &prevIndex) |
This method sets the index of the current edge to be accessed. More... | |
int | getConnectedFaces (MIntArray &faceList, MStatus *ReturnStatus=NULL) const |
This method returns an array containing the indices of the faces connected to the current edge. More... | |
int | getConnectedEdges (MIntArray &edgeList, MStatus *ReturnStatus=NULL) const |
This method returns a list of edges connected to the current edge. More... | |
MStatus | numConnectedFaces (int &faceCount) const |
This method returns the number of faces (1 or 2 ) connected to the current edge. More... | |
MStatus | numConnectedEdges (int &edgeCount) const |
This method returns the number of edges connected to the current edge. More... | |
bool | connectedToFace (int index, MStatus *ReturnStatus=NULL) |
This method determines whether the given face contains the current edge. More... | |
bool | connectedToEdge (int index, MStatus *ReturnStatus=NULL) |
This method determines whether the given edge is connected to the current edge. More... | |
bool | onBoundary (MStatus *ReturnStatus=NULL) |
This method checks to see if the current edge is a border edge. More... | |
MStatus | getLength (double &length, MSpace::Space space=MSpace::kObject) |
This method returns the length of the current edge. More... | |
Static Public Member Functions | |
static const char * | className () |
Returns the name of this class. More... | |
OPENMAYA_MAJOR_NAMESPACE_OPEN MItMeshEdge | ( | MObject & | polyObject, |
MStatus * | ReturnStatus = NULL |
||
) |
Constructor.
Creates an iterator for all edges of the given surface.
[in] | polyObject | The surface to iterate over |
[out] | ReturnStatus | Status code |
MItMeshEdge | ( | MObject & | polyObject, |
MObject & | component, | ||
MStatus * | ReturnStatus = NULL |
||
) |
Constructor.
Creates an iterator for the edges of a given surface. The returned edges are connected to the component object. This component may be a vertex or a face or an edge component. If no component is specified then the iteration will be for all edges of the given polygon.
[in] | polyObject | The surface to iterate over |
[in] | component | The component that determines which edges to iterate over |
[out] | ReturnStatus | Status code |
MItMeshEdge | ( | const MDagPath & | polyObject, |
MObject & | component = MObject::kNullObj , |
||
MStatus * | ReturnStatus = NULL |
||
) |
Constructor.
Creates an iterator for the edges of a given surface. The returned edges are connected to the component object. This component may be a vertex or a face or an edge component. If no component is specified then the iteration will be for all edges of the given polygon.
[in] | polyObject | The surface to iterate over |
[in] | component | The edges of the polyObject to iterate over |
[out] | ReturnStatus | Status code |
|
virtual |
Destructor.
Frees up storage used by the iterator.
bool isDone | ( | MStatus * | ReturnStatus = NULL | ) |
Indicates if all of the edges have been traversed yet.
[out] | ReturnStatus | Status code |
MStatus next | ( | ) |
Advance to the next edge in the iteration.
MStatus reset | ( | ) |
Reset the iterator to the first edge.
MStatus reset | ( | MObject & | polyObject, |
MObject & | component = MObject::kNullObj |
||
) |
Reset the iterator to the first edge in the supplied mesh.
Uses the edges constrained by the given component. If component is null then the iteration will be for all edges in the given polygon.
[in] | polyObject | The mesh object for the iteration |
[in] | component | The constraint object. May be a vertex, a face or an edge component |
MStatus reset | ( | const MDagPath & | polyObject, |
MObject & | component = MObject::kNullObj |
||
) |
Reset the iterator to the first edge in the supplied mesh.
Uses the edges constrained by the given component. If component is null then the iteration will be for all edges in the given polygon.
[in] | polyObject | The surface to iterate over |
[in] | component | The constraint object. May be a vertex, a face or an edge component |
int count | ( | MStatus * | ReturnStatus = NULL | ) |
Return the number of edges in this iteration.
[out] | ReturnStatus | Status code |
MPoint center | ( | MSpace::Space | space = MSpace::kObject , |
MStatus * | ReturnStatus = NULL |
||
) |
Returns the center of the current edge.
[in] | space | The coordinate system for this operation |
[out] | ReturnStatus | Status code |
MPoint point | ( | int | index, |
MSpace::Space | space = MSpace::kObject , |
||
MStatus * | ReturnStatus = NULL |
||
) |
Return the position of the specified vertex of the current edge.
[in] | index | The vertex of the edge we wish to examine (0 or 1) |
[in] | space | The coordinate system for this operation |
[out] | ReturnStatus | Status code |
MStatus setPoint | ( | const MPoint & | point, |
unsigned int | index, | ||
MSpace::Space | space = MSpace::kObject |
||
) |
Set the specified vertex of the current edge to the given value.
[in] | point | The new value for the edge |
[in] | index | The vertex index of the current edge we wish to set (0 or 1) |
[in] | space | The coordinate system for this operation |
bool isSmooth | ( | MStatus * | ReturnStatus = NULL | ) | const |
This method determines if the current edge in the iteration is smooth (soft).
[out] | ReturnStatus | Status code |
MStatus setSmoothing | ( | bool | smooth = true | ) |
This method sets the current edge to be hard or smooth (soft).
The cleanupSmoothing method is no longer required to be called after setSmoothing in Maya3.0 and later versions.
[in] | smooth | if true the edge will be smooth (soft), otherwise the edge will be hard. |
MStatus cleanupSmoothing | ( | ) |
This method is obsolete.
int index | ( | int | index, |
MStatus * | ReturnStatus = NULL |
||
) |
This method returns a vertex index for the current edge based upon the specified index.
The index can be either 0 or 1 since an edge is made up of exactly two vertices.
[in] | index | The vertex index in current edge (0 or 1) |
[out] | ReturnStatus | Status code |
int index | ( | MStatus * | ReturnStatus = NULL | ) | const |
This method returns the index of the current edge in the iteration.
[out] | ReturnStatus | Status code |
This method is obsolete.
Get the current edge in the iteration as a component.
Components are used to specify one or more edges and are usefull in operating on groups of non-contiguous edges for a surface. Components do not contain any information about the surface that they refer to so an MDagPath must be specified when dealing with components.
[out] | ReturnStatus | Status code |
Get the current edge in the iteration as a component.
Components are used to specify one or more edges and are usefull in operating on groups of non-contiguous edges for a surface. Components do not contain any information about the surface that they refer to so an MDagPath must be specified when dealing with components.
[out] | ReturnStatus | Status code |
MStatus updateSurface | ( | ) |
Signal that this polygonal surface has changed and needs to redraw itself.
MStatus geomChanged | ( | ) |
Reset the geom pointer in the MItMeshEdge.
If you're using MFnMesh to update Normals or Color per vertex while iterating, you must call geomChanged on the iterator immediately after the MFnMesh call to make sure that your geometry is up to date. A crash may result if this method is not called.
MStatus setIndex | ( | int | index, |
int & | prevIndex | ||
) |
This method sets the index of the current edge to be accessed.
The current edge will no longer be in sync with any previous iteration.
[in] | index | The index of desired edge to access. |
[out] | prevIndex | Index of the edge which was current before the change. |
This method returns an array containing the indices of the faces connected to the current edge.
Normally a boundary edge will only have one face connected to it and an internal edge will have two, but if the mesh has manifold geometry then the edge may have three or more faces connected to it.
[out] | faces | Array of face indices. |
[out] | ReturnStatus | Status code |
This method returns a list of edges connected to the current edge.
[out] | edges | Array of edge indices. |
[out] | ReturnStatus | Status code |
MStatus numConnectedFaces | ( | int & | faceCount | ) | const |
This method returns the number of faces (1 or 2 ) connected to the current edge.
[in] | faceCount | Number of connected faces |
MStatus numConnectedEdges | ( | int & | edgeCount | ) | const |
This method returns the number of edges connected to the current edge.
[out] | edgeCount | Number of connected edges. |
bool connectedToFace | ( | int | index, |
MStatus * | ReturnStatus = NULL |
||
) |
This method determines whether the given face contains the current edge.
[in] | index | Index of face to check. |
[out] | ReturnStatus | Status code |
bool connectedToEdge | ( | int | index, |
MStatus * | ReturnStatus = NULL |
||
) |
This method determines whether the given edge is connected to the current edge.
[in] | index | Index of edge to check. |
[in] | ReturnStatus | Status code |
bool onBoundary | ( | MStatus * | ReturnStatus = NULL | ) |
This method checks to see if the current edge is a border edge.
NOTE: it is possible to turn all edges into boundaries by extracting faces. In this case, onBoundary() will always return true even though it appears that there are internal edges.
[out] | ReturnStatus | Status code |
MStatus getLength | ( | double & | length, |
MSpace::Space | space = MSpace::kObject |
||
) |
This method returns the length of the current edge.
[in] | length | length of edge |
[in] | space | Coordinate space in which to perform the operation. |
|
static |
Returns the name of this class.