IMNMeshUtilities8 Class Reference
IMNMeshUtilities8 Class Referenceabstract
#include <mnmesh.h>
Class Description
IMNMeshUtilities8 extends the MNMeshUtilities class, adding new functionality applied on a MNMesh.
Such an interface is obtained through the call to GetInterface, using the class id: IMNMESHUTILITIES8_INTERFACE_ID on an instance of an MNMesh. usage is : IMNMeshUtilities8* l_meshToBridge = static_cast<IMNMeshUtilities8*>(mesh.GetInterface( IMNMESHUTILITIES8_INTERFACE_ID ));
Edge bridging: This is an extension of the existing bridge border method. It bridges 2 sets od edges of different size. you can bridge 4 edges with 5 edges. Limitations. the 2 edge lists must be disjoint, or at least separated by a sharp angle. this angular threshold can be adjusted by using the in_adjacentAngle parameter, Connect edges: 2 new parameters are added for better precision: in_pinch and in_slide. SelectEdgeRingShift: selects edges in the ring direction
Inheritance diagram for IMNMeshUtilities8:
Public Member Functions | |
| virtual Interface_ID | GetID () |
| virtual bool | BridgeTwoEdges (const int in_Edge1, const int in_Edge2, const int in_segmentsNumber, const int in_prevColumnIndex=0, const DWORD in_smoothingGroup=0, const MtlID in_materialId=0, const bool in_triangleAdded=false)=0 |
| Bridges 2 edges. More... | |
| virtual bool | BridgeSelectedEdges (const DWORD in_edgeFlag, const float in_smoothThresh, const int in_segmentsNumber, const float in_adjacentAngle, const bool in_reverseTriangle)=0 |
| Bridges edge selection. More... | |
| virtual bool | ConnectEdges (const DWORD in_edgeFlag, const int in_segments=2, const int in_pinch=0, const int in_slide=0)=0 |
| Creates new connections between opposing edges of the specified type. More... | |
| virtual void | SelectEdgeRingShift (const int in_ring_shift, BitArray &io_edgeSel)=0 |
| Edge selection shifting routine: shifts the current edge selection in the ring direction. More... | |
| virtual void | SelectEdgeLoopShift (const int in_loop_shift, BitArray &io_edgeSel)=0 |
| Edge selection shifting routine: shifts the current edge selection in the loop direction. More... | |
| virtual bool | SplitFlaggedVertices (const DWORD in_vertexFlag=MN_SEL, const float in_distance=0.0)=0 |
| Vertex splitting method, using a distance value for specifying the distance between the split vertices. More... | |
| virtual bool | SplitFlaggedEdges (const DWORD in_edgeFlag=MN_SEL, const float in_distance=0.0)=0 |
| Edge splitting method, using a distance value for specifying the distance between the split edges. More... | |
| virtual void | GetFlippedEdges (BitArray &io_edgeFlip, const bool in_useOnlySelectedEdges=false)=0 |
| Creates a bitArray indicating the directions of the MNMesh's edges relative to 2 arbitrary edges: the 2 first edges of the first face of the MNMesh. More... | |
| virtual bool | ChamferEdges (const DWORD in_flag=MN_SEL, MNChamferData *in_mcd=NULL, const bool in_open=false)=0 |
| New Edge chamfer method: A new parameter is added, allowing the creation of holes when chamfering. More... | |
| virtual bool | ChamferVertices (const DWORD flag=MN_SEL, MNChamferData *mcd=NULL, const bool in_open=false)=0 |
| New Vertex chamfer method : A new parameter is added, allowing the creation of holes when chamfering. More... | |
MNMesh Optimization Functions | |
| virtual bool | isFaceCacheInvalid (int faceIndex)=0 |
| Check if a face's cache is invalid. More... | |
| virtual void | InvalidateVertexCache (int vertex)=0 |
| Invalidates a single vertex's cache indicating it needs to be rebuilt. More... | |
| Public Member Functions inherited from BaseInterface | |
| virtual UtilExport | ~BaseInterface () |
| Destructor. More... | |
| UtilExport BaseInterface * | GetInterface (Interface_ID id) |
| virtual LifetimeType | LifetimeControl () |
| virtual bool | RegisterNotifyCallback (InterfaceNotifyCallback *incb) |
| virtual void | UnRegisterNotifyCallback (InterfaceNotifyCallback *incb) |
| virtual BaseInterface * | AcquireInterface () |
| virtual void | ReleaseInterface () |
| virtual void | DeleteInterface () |
| virtual BaseInterface * | CloneInterface (void *remapDir=NULL) |
| Public Member Functions inherited from InterfaceServer | |
| virtual UtilExport | ~InterfaceServer () |
| Destructor. More... | |
Additional Inherited Members | |
| Public Types inherited from BaseInterface | |
| enum | LifetimeType { noRelease, immediateRelease, wantsRelease, serverControlled } |
| Static Public Member Functions inherited from MaxHeapOperators | |
| static UtilExport void * | operator new (size_t size) |
| Standard new operator used to allocate objects If there is insufficient memory, an exception will be thrown. More... | |
| static UtilExport void * | operator new (size_t size, const std::nothrow_t &e) |
| Standard new operator used to allocate objects if there is insufficient memory, NULL will be returned. More... | |
| static UtilExport void * | operator new (size_t size, const char *filename, int line) |
| New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, an exception will be thrown. More... | |
| static UtilExport void * | operator new (size_t size, int block_type, const char *filename, int line) |
| New operator used to allocate objects that takes the type of memory, filename and line number where the new was called If there is insufficient memory, an exception will be thrown. More... | |
| static UtilExport void * | operator new (size_t size, const std::nothrow_t &e, const char *filename, int line) |
| New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, NULL will be returned. More... | |
| static UtilExport void * | operator new (size_t size, unsigned long flags) |
| New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, an exception will be thrown. More... | |
| static UtilExport void * | operator new (size_t size, const std::nothrow_t &e, unsigned long flags) |
| New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, NULL will be returned. More... | |
| static UtilExport void * | operator new[] (size_t size) |
| New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More... | |
| static UtilExport void * | operator new[] (size_t size, const std::nothrow_t &e) |
| New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More... | |
| static UtilExport void * | operator new[] (size_t size, const char *filename, int line) |
| New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More... | |
| static UtilExport void * | operator new[] (size_t size, int block_type, const char *filename, int line) |
| New operator used to allocate arrays of objects. More... | |
| static UtilExport void * | operator new[] (size_t size, const std::nothrow_t &e, const char *filename, int line) |
| New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More... | |
| static UtilExport void * | operator new[] (size_t size, unsigned long flags) |
| New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More... | |
| static UtilExport void * | operator new[] (size_t size, const std::nothrow_t &e, unsigned long flags) |
| New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More... | |
| static UtilExport void | operator delete (void *ptr) |
| Standard delete operator used to deallocate an object If the pointer is invalid, an exception will be thrown. More... | |
| static UtilExport void | operator delete (void *ptr, const std::nothrow_t &e) |
| Standard delete operator used to deallocate an object If the pointer is invalid, nothing will happen. More... | |
| static UtilExport void | operator delete (void *ptr, const char *filename, int line) |
| Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More... | |
| static UtilExport void | operator delete (void *ptr, int block_type, const char *filename, int line) |
| Delete operator used to deallocate an object that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More... | |
| static UtilExport void | operator delete (void *ptr, const std::nothrow_t &e, const char *filename, int line) |
| Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen. More... | |
| static UtilExport void | operator delete (void *ptr, unsigned long flags) |
| Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More... | |
| static UtilExport void | operator delete (void *ptr, const std::nothrow_t &e, unsigned long flags) |
| Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, nothing will happen. More... | |
| static UtilExport void | operator delete[] (void *ptr) |
| Standard delete operator used to deallocate an array of objects If the pointer is invalid, an exception will be thrown. More... | |
| static UtilExport void | operator delete[] (void *ptr, const std::nothrow_t &e) |
| Standard delete operator used to deallocate an array of objects If the pointer is invalid, nothing will happen. More... | |
| static UtilExport void | operator delete[] (void *ptr, const char *filename, int line) |
| Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More... | |
| static UtilExport void | operator delete[] (void *ptr, int block_type, const char *filename, int line) |
| Delete operator used to deallocate an array of objects that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More... | |
| static UtilExport void | operator delete[] (void *ptr, const std::nothrow_t &e, const char *filename, int line) |
| Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen. More... | |
| static UtilExport void | operator delete[] (void *ptr, unsigned long flags) |
| Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More... | |
| static UtilExport void | operator delete[] (void *ptr, const std::nothrow_t &e, unsigned long flags) |
| Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More... | |
| static UtilExport void * | operator new (size_t size, void *placement_ptr) |
| Placement new operator. More... | |
| static UtilExport void | operator delete (void *ptr, void *placement_ptr) |
| Placement delete operator. More... | |
| static UtilExport void * | aligned_malloc (size_t size, size_t alignment) |
| Allocates memory on a specified alignment boundary. More... | |
| static UtilExport void * | aligned_realloc (void *ptr, size_t size, size_t alignment) |
| Reallocates memory on a specified alignment boundary. More... | |
| static UtilExport void | aligned_free (void *ptr) |
| Frees a block of memory that was allocated with aligned_malloc/aligned_realloc. More... | |
Member Function Documentation
|
inlinevirtual |
- Remarks
- This method returns the unique interface ID.
Reimplemented from BaseInterface.
#define IMNMESHUTILITIES8_INTERFACE_ID
Interface id for IMNMeshUtilities8, se.g.
Definition: mnmesh.h:116
|
pure virtual |
Bridges 2 edges.
- Returns
- true if the bridging operation was successful
- false if the bridging operation failed
- Precondition
- in_sourceEdge and in_targetEdge must be different
- in_sourceEdge and in_targetEdge must on border
- Postcondition
- the mesh geometry is valid, even if the operation failed
- Parameters
-
[in] in_Edge1 1st edge index to bridge [in] in_Edge2 2nd edge index to bridge [in] in_segmentsNumber number of polys between the edges [in] in_prevColumnIndex internal value, do not use [in] in_smoothingGroup new face smoothing Group index [in] in_materialId new face material id [in] in_triangleAdded internal value, do not use
|
pure virtual |
Bridges edge selection.
- Returns
- true if the bridging operation was successful
- false if the bridging operation failed
- Precondition
- in_sourceEdge and in_targetEdge must be different
- in_sourceEdge and in_targetEdge must on border
- Postcondition
- the mesh geometry is valid, even if the operation failed
- Parameters
-
[in] in_edgeFlag edge cluster flag. [in] in_smoothThresh threshold angle, in radians, for smoothing successive columns of the bridge. [in] in_segmentsNumber number of polys between the edges [in] in_adjacentAngle angular threshold in radians for splitting one contiguous edge list in 2 in order to perform the bridging on 2 separate edge lists [in] in_reverseTriangle reverse triangle's position: if true, triangles will be added at the end of the bridge, if they are needed ( when bridging 4 edges with 5 edges.
|
pure virtual |
Creates new connections between opposing edges of the specified type.
If two edges are opposed they will each be split into a number (specified by in_segements) of equally sized segments. New edges will be created from the new vertexes created on each edge
- Returns
- true if the connection operation was successful
- false if the connection operation failed
- Precondition
- in_segments must be greater than 1
- in_pinch and in_slide must be between -100 and 100
- Postcondition
- the mesh geometry is valid, even if the operation failed
- Parameters
-
[in] in_edgeFlag edge cluster flag [in] in_segments number of connection edges between successive selected edges [in] in_pinch distance between successive new connection edges. Can be < 0. [in] in_slide position of the new connection edges, relative to the existing edges. Can be < 0.
Edge selection shifting routine: shifts the current edge selection in the ring direction.
- Precondition
- the io_edgeSel BitArray, must exist with the proper size
- Postcondition
- the io_edgeSel BitArray contains the list of the shifted edges
- Parameters
-
[in] in_ring_shift shifting value, can be positive or negative [in,out] io_edgeSel the new edge selection list
Edge selection shifting routine: shifts the current edge selection in the loop direction.
- Precondition
- the io_edgeSel BitArray must exist with the proper size
- Postcondition
- the io_edgeSel BitArray contains the list of the shifted edges
- Parameters
-
[in] in_loop_shift shifting value, can be positive or negative [in,out] io_edgeSel the new edge selection list
|
pure virtual |
Vertex splitting method, using a distance value for specifying the distance between the split vertices.
- Postcondition
- the MNmesh is valid, with the selected vertices ,split apart, using the in_distance.
- Parameters
-
[in] in_vertexFlag the vertex flag used [in] in_distance to split the vertices apart
|
pure virtual |
Edge splitting method, using a distance value for specifying the distance between the split edges.
- Postcondition
- the MNmesh is valid with the selected vertices ,split apart, using the in_distance.
- Parameters
-
[in] in_edgeFlag the vertex flag used [in] in_distance to split the selected edges apart
|
pure virtual |
Creates a bitArray indicating the directions of the MNMesh's edges relative to 2 arbitrary edges: the 2 first edges of the first face of the MNMesh.
For a MNesh made of quads ( like a converted plane), they are the 2 first edges of the lower left face.
- Precondition
- the array io_edgeFlip does not need to exist
- Postcondition
- the array exists and contains number of edges entries.
- Parameters
-
[in,out] io_edgeFlip array of flipped edges [in] in_useOnlySelectedEdges if this is true, only selected edges will be tested against the 2 original edges.
|
pure virtual |
New Edge chamfer method: A new parameter is added, allowing the creation of holes when chamfering.
- Returns
- true if the chamfer operation was successful
- false if the chamfer operation failed
- Postcondition
- the mesh geometry is valid, even if the operation failed
- Parameters
-
[in] in_flag the edge flag used [in] in_mcd the chamfer data [in] in_open If true, the newly created faces are removed, creating a hole between chamfered edges.
|
pure virtual |
New Vertex chamfer method : A new parameter is added, allowing the creation of holes when chamfering.
- Returns
- true if the chamfer operation was successful
- false if the chamfer operation failed
- Postcondition
- the mesh geometry is valid, even if the operation failed
- Parameters
-
[in] flag the vertices flag used [in] mcd the chamfer data [in] in_open If true, the newly created faces are removed, creating a hole between chamfered vertices.
|
pure virtual |
Check if a face's cache is invalid.
The function first checks if the whole mesh or the face have been flagged as cache invalid (MN_CACHEINVALID). If none of these is true, it then cycles through the face's vertices and returns true as soon as it finds a vertex flagged with MN_CACHEINVALID.
- Precondition
- faceIndex must be a valid index in the faces (f) array.
- Parameters
-
[in] faceIndex The index of the face for which you want to determine cache validity
- Returns
- true if the face is invalid, else false.
Invalidates a single vertex's cache indicating it needs to be rebuilt.
The function flags the specified vertex with the MN_CACHEINVALID flag, telling the rebuild functions that this vertex, the faces surrounding it and the other vertices of those faces need to have their normals recomputed. It also sets normalsBuilt to 0 to trigger normals' rebuild. This function should be called when one to several vertices have been modified. If all or almost all vertices of the mesh have been invalidated, it's more efficient to call InvalidateGeomCache() instead.
- Precondition
- vertex must be a valid index in the vertex (v) array.
- Parameters
-
[in] vertex The index of the vertex that needs to be invalidated.