This reference page is linked to from the following overview topics: SDK Change Details.

This file contains a number of utility classes for manipulating triangle or generalized polygon meshes. More...

#include "maxheap.h"
#include "export.h"
#include "baseinterface.h"
#include "mncommon.h"
#include "hitdata.h"
#include "point3.h"
#include "bitarray.h"
#include "matrix3.h"
#include "box3.h"
#include "TabTypes.h"
#include "GraphicsConstants.h"
#include "channels.h"
#include "mesh.h"

Classes
class	MNVert
	The vertex class used with the MNMesh mesh. More...
class	MNEdge
	An edge used with the MNMesh mesh. More...
class	MNMapFace
	Used to store map vertex information for a given face and map channel. More...
class	MNFace
	The face structure used with the MNMesh mesh. More...
class	MNMap
	Holds the mapping information for a particular map channel of the MNMesh. More...
class	MNDiagonalHitData
	This class is a new form of HitData used for hit-testing diagonals of polygons in Editable Poly and Edit Poly. More...
class	MNMesh
	The MNMesh class is provided for temporary use by plug-ins, to help with complex topology-based modifications to Meshes. More...
class	MNMeshBorder
	Hold boundary information for an MNMesh mesh. More...
class	MNFaceElement
	Used to assist in the process of sorting MNMesh faces into separate elements. More...
class	MNFaceClusters
	Used for grouping faces in an MNMesh into clusters for applying transformations. More...
class	MNEdgeClusters
	Represents a list of edge "clusters" for a given MNMesh. More...
class	MNChamferData
	Contains all the data needed to move points (and map vertices) as the user drags a chamfer or extrude. More...
class	MNTempData
	Used for caching face and edge clusters, vertex normals, and other derived data about an MNMesh. More...
class	IMNTempData10
	Interface for changes made to MNTempData in version 9.5. More...
class	BasisFinder
	Computes two components of a basis vector given a single input component. More...
class	MNMeshSelectionConverter
	When a Mesh object or modifier (such as Editable Mesh, Edit Mesh, or Mesh Select) handles viewport subobject selection, the flow is basically as follows from Editable Mesh. More...
class	MNMeshUtilities
	Provides a number of utility functions for working with MNMesh. More...
class	MNMapPreserveData
	This class is used to "preserve" mapping coordinates while moving vertices. More...
class	IMNMeshUtilities8
	IMNMeshUtilities8 extends the MNMeshUtilities class, adding new functionality applied on a MNMesh. More...
class	IMNMeshUtilities10
	Extends the MNMeshUtilities class, adding new functionality applied on a MNMesh. More...
class	IMNMeshUtilities13
	Extends the MNMeshUtilities class, adding new functionality applied on a MNMesh. More...
Namespaces
namespace	MaxGraphics
Defines
#define	REALLOC_SIZE 10
#define	MNMESH_FACEDATA_IMPL
	Enables Face Data in PolyObjects:
#define	MNM_SELCONV_REQUIRE_ALL 0x02
#define	MN_MESH_NONTRI (1<<0)
	At least 2 triangles have been joined.
#define	MN_MESH_FILLED_IN (1<<1)
	If set, all topological links, such as the list of edges, are complete.
#define	MN_MESH_RATSNEST (1<<2)
	Some regular Meshes have more than two faces referencing the same edge, or more than one referencing it in the same direction.
#define	MN_MESH_NO_BAD_VERTS (1<<3)
	This indicates that the mesh has had its vertices checked and "bad" ones eliminated by EliminateBadVerts.
#define	MN_MESH_VERTS_ORDERED (1<<4)
	Set if face and edge tables in each vertex are ordered by the methods MNMesh::OrderVerts().
#define	MN_MESH_FACE_NORMALS_INVALID (1<<6)
	Set if any of the face normals (fnorm) have become invalid.
#define	MN_MESH_HAS_VOLUME (1<<7)
	This mesh has at least one connected component which contains volume, i.e.
#define	MN_MESH_HITTEST_REQUIRE_ALL (1<<8)
#define	MN_MESH_PARTIALCACHEINVALID (1<<16)
	Indicates that the MNMesh has only set some of the vertices as invalid and not to reprocess the entire mesh just the vertices that changed.
#define	MN_MESH_CACHE_FLAGS (MN_MESH_FILLED_IN\|MN_MESH_NO_BAD_VERTS\|MN_MESH_VERTS_ORDERED)
#define	MNDISP_VERTTICKS 0x01
	Display vertex tick marks.
#define	MNDISP_SELVERTS 0x02
	Display selected vertices.
#define	MNDISP_SELFACES 0x04
	Display selected faces.
#define	MNDISP_SELEDGES 0x08
	Display selected edges.
#define	MNDISP_NORMALS 0x10
	Display face normals.
#define	MNDISP_SMOOTH_SUBSEL 0x20
	Analogous to the Mesh display flag MESH_SMOOTH_SUBSEL, this indicates whether we should display smooth faces with selection-color outlines (TRUE) or transparent shaded faces (FALSE)
#define	MNDISP_BEEN_DISP 0x40
	Set when the MNMesh has been displayed (at the end of the render method.)
#define	MNDISP_DIAGONALS 0x80
	Set when diagonals should be displayed.
#define	MNDISP_HIDE_SUBDIVISION_INTERIORS 0x100
#define	IMNMESHUTILITIES10_INTERFACE_ID Interface_ID(0x7b1acb31, 0x763982d5)
#define	IMNMESHUTILITIES13_INTERFACE_ID Interface_ID(0x4dfa07c3, 0x637941b0)
General MNMesh Component Flags
For MNVerts, MNEdges, and MNFaces, bits 0-7 are used for common characteristics of all components. Bits 8-15 are used for component-specific flags. Bits 16-23 are reserved for temporary use in MNMesh algorithms. Bits 24-31 are reserved for MNMath.lib users.
#define	MN_SEL (1<<0)
	Indicates that a component is selected.
#define	MN_DEAD (1<<1)
	Indicates that a component is not used and should be ignored.
#define	MN_TARG (1<<2)
	Indicates that a component is targeted.
#define	MN_BACKFACING (1<<3)
	Indicates that the vertex faces "backwards" in the current viewport.
#define	MN_HIDDEN (1<<4)
#define	MN_CACHEINVALID (1<<5)
#define	MN_INFOREGROUND (1<<7)
	Tags a face as not renderable but can be hit-test.
#define	MN_WHATEVER (1<<16)
#define	MN_LOCAL_SEL (1<<17)
	Alternate selections (not passed up the pipe).
#define	MN_HITTEST_CULLED (1<<18)
	Used to indicate culled components (neither selected nor not selected) in window-region hit testing.
#define	MN_USER (1<<24)
	Any value above this can be used by applications.
Vertex Flags
#define	MN_VERT_DONE (1<<8)
	Set in algorithms that may accidentally revisit the same vertex (MNVertext twice, to keep them from processing it the second time.
#define	MN_VERT_WELDED (1<<9)
	Used by MNMesh::WeldBorderVerts()
#define	MN_VERT_SUBDIVISION_CORNER (1<<10)
	Track which vertices are direct "descendants" of the original cage vertices in subdivision.
Edge flags
#define	MN_EDGE_INVIS (1<<8)
	Both faces using this edge consider it invisible.
#define	MN_EDGE_NOCROSS (1<<9)
	This edge should not be crossed in algorithms like MNMesh::SabinDoo that can mix faces across edges.
#define	MN_EDGE_MAP_SEAM (1<<10)
	Track which edges are direct descendants of the original cage edges in subdivision.
#define	MN_EDGE_SUBDIVISION_BOUNDARY (1<<11)
	Track unwanted edges created by Cut, so they might be removed later.
#define	MN_EDGE_CUT_EXTRA (1<<12)
	Used with MNMesh::CutPrepare() and MNMEsh::CutCleanUp()
Interface IDs
#define	IMNMESHUTILITIES8_INTERFACE_ID Interface_ID(0xf5235e73, 0x3b304334)
	Interface id for IMNMeshUtilities8, se.g.
#define	IMNTEMPDATA10_INTERFACE_ID Interface_ID(0x56d8fa2, 0x3459c774)
	Interface ID for IMNTempData10.
MNFace flags:
#define	MN_FACE_OPEN_REGION (1<<8)
	This face is part of a region of the mesh that is not closed, i.e.
#define	MN_FACE_CHECKED (1<<9)
#define	MN_FACE_CHANGED (1<<10)
	This flag can be cleared on all faces before an operation that moves some of the vertices of an MNMesh, then set for each face touching one of the moved vertices.
#define	MN_FACE_CULLED (1<<11)
	Used to indicate a face has been culled during hit-testing.
Per-edge Data
#define	MAX_EDGEDATA 10
#define	EDATA_KNOT 0
#define	EDATA_CREASE 1
Internal flags
#define	MN_MESH_TEMP_1 (1<<13)
#define	MN_MESH_TEMP_2 (1<<14)
#define	MN_MESH_DONTTRISTRIP (1<<15)
Flags for Sub Object Hit-Test
#define	SUBHIT_MNUSECURRENTSEL (1<<22)
	When this bit is set, the selection only and unselection only tests will use the current level (edge or face) selection when doing a vertex level hit test.
#define	SUBHIT_OPENONLY (1<<23)
#define	SUBHIT_MNVERTS (1<<24)
#define	SUBHIT_MNFACES (1<<25)
#define	SUBHIT_MNEDGES (1<<26)
#define	SUBHIT_MNDIAGONALS (1<<27)
	Hit-test on "diagonals" of polygons - MNDiagonalHitData is the type of HitData returned.
#define	SUBHIT_MNTYPEMASK (SUBHIT_MNVERTS\|SUBHIT_MNFACES\|SUBHIT_MNEDGES\|SUBHIT_MNDIAGONALS)
Subdivision Flags
#define	MN_SUBDIV_NEWMAP 0x01
#define	MN_SUBDIV_HIDE_INTERNAL_EDGES 0x10
Enumerations
enum	PMeshSelLevel { MNM_SL_OBJECT, MNM_SL_VERTEX, MNM_SL_EDGE, MNM_SL_FACE, MNM_SL_CURRENT }
	MNMesh selection levels. More...
Functions
DllExport void	DiagSort (int dnum, int *diag)
	Puts diagonals in increase-by-last-index, decrease-by-first order.
DllExport int	EdgeDataType (int edID)
DllExport void *	EdgeDataDefault (int edID)
DllExport void	MNChamferDataDebugPrint (MNChamferData &mcd, int mapNum)
	Output all the data in the specified MNChamferData to the DebugPrint buffer during debug runs using using DebugPrint().
DllExport void	SelectionDistance (MNMesh &mesh, float *selDist, DWORD selFlags)
	This function computes the current distance of each vertex from the current selection.
DllExport void	SelectionDistance (MNMesh &mesh, float *selDist, int iters, DWORD selFlags)
	This function computes the current distance of each vertex from the current selection, along paths of edges.
DllExport void	ClustDistances (MNMesh &mesh, int numClusts, int vclust, Tab< float > *clustDist)
	Computes the current distance of each vertex from the specified cluster.
DllExport void	ClustDistances (MNMesh &mesh, int numClusts, int vclust, Tab< float > *clustDist, int iters)
	Computes the current distance of each vertex from the specified cluster.
Variables
const int	kMNNurmsHourglassLimit = 2500

Detailed Description

This file contains a number of utility classes for manipulating triangle or generalized polygon meshes.

The following files contains important grouping of constants and flags:

Definition in file mnmesh.h.

Define Documentation

#define REALLOC_SIZE 10

MNM_SL_OBJECT	Search for all occurrences
MNM_SL_VERTEX	Search for all occurrences
MNM_SL_EDGE	Search for all occurrences
MNM_SL_FACE	Search for all occurrences
MNM_SL_CURRENT	Search for all occurrences

DllExport void MNChamferDataDebugPrint	(	MNChamferData &	mcd,
		int	mapNum
	)

mcd	The MNChamferData we want to investigate.
mapNum	The number of map channels in the MNMesh associated with this MNChamferData . (For historical reasons, this information is not kept in the MNChamferData class.) Generally this is retrieved with a call to MNMesh::MNum().

DllExport void SelectionDistance	(	MNMesh &	mesh,
		float *	selDist,
		DWORD	selFlags
	)

DllExport void ClustDistances	(	MNMesh &	mesh,
		int	numClusts,
		int *	vclust,
		Tab< float > **	clustDist
	)

mnmesh.h File Reference

Classes

Namespaces

Defines

Enumerations

Functions

Variables

Detailed Description

Define Documentation

Enumeration Type Documentation

Function Documentation

Variable Documentation