MeshNormalSpec Class Reference

This class is an interface used to store user-specified normals (such as those created in the Edit Normals modifier). More...

#include <MeshNormalSpec.h>

Inheritance diagram for MeshNormalSpec:

Public Member Functions
	MeshNormalSpec ()
	~MeshNormalSpec ()
void	SetFlag (DWORD fl, bool val=true)
	Sets flags in the MeshNormalSpec. More...
void	ClearFlag (DWORD fl)
	Clears the flags given. See GetFlag for more details on MeshNormalSpec flags. More...
bool	GetFlag (DWORD fl) const
	Gets flags in the MeshNormalSpec. More...
DllExport void	Initialize ()
	Initializes all data members - do not use if already allocated! More...
DllExport bool	NAlloc (int num, bool keep=TRUE)
DllExport void	NShrink ()
	shrinks allocation down to actual number of normals. More...
DllExport bool	FAlloc (int num, bool keep=TRUE)
DllExport void	FShrink ()
DllExport void	Clear ()
	Deletes everything. More...
DllExport void	ClearAndFree ()
	Deletes everything, frees all memory. More...
int	GetNumFaces () const
DllExport bool	SetNumFaces (int numFaces)
int	GetNumNormals () const
DllExport bool	SetNumNormals (int numNormals)
Point3 &	Normal (int normID) const
Point3 *	GetNormalArray () const
bool	GetNormalExplicit (int normID) const
void	SetNormalExplicit (int normID, bool value)
void	SetAllExplicit (bool value=true)
	Set all normals to be explicit. More...
MeshNormalFace &	Face (int faceID) const
MeshNormalFace *	GetFaceArray () const
void	SetParent (Mesh *pMesh)
DllExport Point3 &	GetNormal (int face, int corner)
DllExport void	SetNormal (int face, int corner, Point3 &normal)
DllExport int	GetNormalIndex (int face, int corner)
DllExport void	SetNormalIndex (int face, int corner, int normalIndex)
DllExport int	NewNormal (Point3 normal, bool explic=true)
DllExport void	SetSelection (BitArray &newSelection)
BitArray &	GetSelection ()
void	SetDisplayLength (float displayLength)
float	GetDisplayLength ()
DllExport void	Display (GraphicsWindow *gw, bool showSel)
DllExport bool	HitTest (GraphicsWindow *gw, HitRegion *hr, DWORD flags, SubObjHitList &hitList)
DllExport Box3	GetBoundingBox (Matrix3 *tm=NULL, bool selectedOnly=false)
DllExport void	ClearNormals ()
	This method dumps all unspecified normals. Best to use only from within CheckNormals. More...
DllExport void	BuildNormals ()
	Fills in the mpSpecNormal data by building all the unspecified normals, and computing non-explicit ones. More...
DllExport void	ComputeNormals ()
	This method just recomputes the directions of non-explicit normals, without rebuilding the normal list. More...
DllExport void	CheckNormals ()
	This checks our flags and calls BuildNormals, ComputeNormals as needed. More...
DllExport MeshNormalSpec &	operator= (const MeshNormalSpec &from)
DllExport void	CopySpecified (const MeshNormalSpec &from)
DllExport bool	CopySpecified (const MeshNormalSpec &sourceNormals, const Tab< int > &faceIndexMap, int offset=0)
	For each face index map entry faceIndexMap[f] which is valid, i.e. More...
DllExport MeshNormalSpec &	operator+= (const MeshNormalSpec &from)
DllExport void	MyDebugPrint (bool printAll=false)
DllExport bool	CheckAllData (int numParentFaces)
DllExport IOResult	Save (ISave *isave)
DllExport IOResult	Load (ILoad *iload)
Interface_ID	GetID ()
DllExport void	DeleteInterface ()
DllExport BaseInterface *	GetInterface (Interface_ID id)
DllExport BaseInterface *	CloneInterface (void *remapDir=NULL)
DllExport void	ShallowCopy (IPipelineClient *from, ChannelMask channels)
DllExport void	DeepCopy (IPipelineClient *from, ChannelMask channels)
DllExport void	NewAndCopyChannels (ChannelMask channels)
DllExport void	FreeChannels (ChannelMask channels, int zeroOthers=1)
DllExport void	ZeroChannels (ChannelMask channels)
DllExport void	AppendAllChannels (IPipelineClient *from)
DllExport bool	Transform (const Matrix3 &transformMat, bool useSelelection=false, const BitArray *normalSelection=nullptr, bool isGeomTransform=true)
	Transforms the normals. More...
DllExport bool	Translate (Point3 &translate, BOOL useSel=true, BitArray *normalSelection=NULL)
DllExport bool	BreakNormals (BOOL useSel=true, BitArray *normalSelection=NULL, BOOL toAverage=false)
DllExport bool	UnifyNormals (BOOL useSel=true, BitArray *normalSelection=NULL, BOOL toAverage=false)
DllExport bool	AverageNormals (BOOL useThresh=false, float threshold=0.0f, BOOL useSel=true, BitArray *normalSelection=NULL)
DllExport bool	SpecifyNormals (BOOL useSel=true, BitArray *normalSelection=NULL)
DllExport bool	MakeNormalsExplicit (BOOL useSel=true, BitArray *normalSelection=NULL, bool value=true)
DllExport bool	ResetNormals (BOOL useSel=true, BitArray *normalSelection=NULL)
Public Member Functions inherited from BaseInterface
virtual UtilExport	~BaseInterface ()
	Destructor. More...
virtual LifetimeType	LifetimeControl ()
virtual bool	RegisterNotifyCallback (InterfaceNotifyCallback *incb)
virtual void	UnRegisterNotifyCallback (InterfaceNotifyCallback *incb)
virtual BaseInterface *	AcquireInterface ()
virtual void	ReleaseInterface ()
Public Member Functions inherited from InterfaceServer
virtual UtilExport	~InterfaceServer ()
	Destructor. More...
template<class InterfaceType >
InterfaceType *	GetTypedInterface ()

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...

Detailed Description

This class is an interface used to store user-specified normals (such as those created in the Edit Normals modifier).

These normals have very limited pipeline support. They are used for viewport display, but not for rendering.

The MeshNormalSpec contains three types of normals:

• Unspecified - these are the usual normals that are computed from smoothing groups. All normals are unspecified by default.
• Specified - these are normals that are intended for use by particular corners of particular faces, without regard to smoothing groups. For instance, you can create a box, apply Edit Normals, select a group of normals at a particular vertex, and click "Unify". Now those three faces are told to specifically use that one unified normal, and they ignore their smoothing groups at that vertex (which would normally tell them they should each have their own normal).
• Explicit - these are normals that are set to particular values. For instance, if the user wants to use the Edit Normals Move or Rotate commands to set a normal to something other than its default value, it has to be made explicit, so it won't be recomputed based on the face normals. All explicit normals are also considered to be specified..

Constructor & Destructor Documentation

MeshNormalSpec()

MeshNormalSpec ( )

inline

                      : mpFace(NULL), mpNormal(NULL), mNumNormalAlloc(0),
        mNumFaceAlloc(0), mNumNormals(0), mNumFaces(0), mpParent(NULL), mFlags(0),
        mDisplayLength(MESH_NORMAL_LENGTH_DEFAULT) { }

~MeshNormalSpec()

~MeshNormalSpec ( )

inline

{ ClearAndFree (); }

Member Function Documentation

SetFlag()

void SetFlag ( DWORD  fl, bool  val = true  )

inline

Sets flags in the MeshNormalSpec.

Generally, the only flag that clients should set is the MESH_NORMAL_MODIFIER_SUPPORT flag. See GetFlag for more details.

{ if (val) mFlags |= fl; else mFlags &= ~fl; }

ClearFlag()

void ClearFlag ( DWORD  fl )

inline

Clears the flags given. See GetFlag for more details on MeshNormalSpec flags.

{ mFlags &= ~fl; }

GetFlag()

bool GetFlag ( DWORD  fl ) const

inline

Gets flags in the MeshNormalSpec.

Remarks

MeshNormalSpec supports the following flags: MESH_NORMAL_NORMALS_BUILT Indicates that non-specified normals have been constructed using smoothing groups. If not set, non-specified normals may be invalid. MESH_NORMAL_NORMALS_COMPUTED Indicates that non-explicit normals have been computed using geometrically computed face normals. (If not set, only explicit normals may be assumed to be pointing the right direction.) MESH_NORMAL_MODIFIER_SUPPORT This flag should be set by modifiers that want to support the edited normals. See class TriObjectNormalModifier for more details. If this flag is not specifically set in a modifier that alters PART_GEOM or PART_TOPO of a TriObject, any specified normals will be cleared after the modifier is evaluated.

{ return (mFlags & fl) ? true : false; }

Initialize()

DllExport void Initialize

(

)

Initializes all data members - do not use if already allocated!

NAlloc()

DllExport bool NAlloc	(	int	num,
		bool	keep = TRUE
	)

NShrink()

DllExport void NShrink

(

)

shrinks allocation down to actual number of normals.

FAlloc()

DllExport bool FAlloc	(	int	num,
		bool	keep = TRUE
	)

FShrink()

DllExport void FShrink

(

)

Clear()

DllExport void Clear

(

)

Deletes everything.

ClearAndFree()

DllExport void ClearAndFree

(

)

Deletes everything, frees all memory.

GetNumFaces()

int GetNumFaces ( ) const

inline

{ return mNumFaces; }

SetNumFaces()

DllExport bool SetNumFaces

(

int

numFaces

)

GetNumNormals()

int GetNumNormals ( ) const

inline

{ return mNumNormals; }

SetNumNormals()

DllExport bool SetNumNormals

(

int

numNormals

)

Normal()

Point3& Normal ( int  normID ) const

inline

{ return mpNormal[normID]; }

GetNormalArray()

Point3* GetNormalArray ( ) const

inline

{ return mpNormal; }

GetNormalExplicit()

bool GetNormalExplicit ( int  normID ) const

inline

{ return mNormalExplicit[normID] ? true : false; }

SetNormalExplicit()

void SetNormalExplicit ( int  normID, bool  value  )

inline

{ mNormalExplicit.Set (normID, value); }

SetAllExplicit()

void SetAllExplicit ( bool  value = true )

inline

Set all normals to be explicit.

Parameters

value

- If true, all normals will be set to explicit. If false, all normals will be set to non-explicit

{ if (value) mNormalExplicit.SetAll(); else mNormalExplicit.ClearAll (); }

Face()

MeshNormalFace& Face ( int  faceID ) const

inline

{ return mpFace[faceID]; }

GetFaceArray()

MeshNormalFace* GetFaceArray ( ) const

inline

{ return mpFace; }

SetParent()

void SetParent ( Mesh *  pMesh )

inline

{ mpParent = pMesh; }

GetNormal()

DllExport Point3& GetNormal	(	int	face,
		int	corner
	)

SetNormal()

DllExport void SetNormal	(	int	face,
		int	corner,
		Point3 &	normal
	)

GetNormalIndex()

DllExport int GetNormalIndex	(	int	face,
		int	corner
	)

SetNormalIndex()

DllExport void SetNormalIndex	(	int	face,
		int	corner,
		int	normalIndex
	)

NewNormal()

DllExport int NewNormal	(	Point3	normal,
		bool	explic = true
	)

SetSelection()

DllExport void SetSelection

(

BitArray &

newSelection

)

GetSelection()

BitArray& GetSelection ( )

inline

{ return mNormalSel; }

SetDisplayLength()

void SetDisplayLength ( float  displayLength )

inline

{ mDisplayLength = displayLength; }

GetDisplayLength()

float GetDisplayLength ( )

inline

{ return mDisplayLength; }

Display()

DllExport void Display	(	GraphicsWindow *	gw,
		bool	showSel
	)

HitTest()

DllExport bool HitTest	(	GraphicsWindow *	gw,
		HitRegion *	hr,
		DWORD	flags,
		SubObjHitList &	hitList
	)

GetBoundingBox()

DllExport Box3 GetBoundingBox	(	Matrix3 *	tm = NULL,
		bool	selectedOnly = false
	)

ClearNormals()

DllExport void ClearNormals

(

)

This method dumps all unspecified normals. Best to use only from within CheckNormals.

BuildNormals()

DllExport void BuildNormals

(

)

Fills in the mpSpecNormal data by building all the unspecified normals, and computing non-explicit ones.

Remarks

Does nothing if normal faces not allocated yet!

Requires an accurate mpParent pointer.

ComputeNormals()

DllExport void ComputeNormals

(

)

This method just recomputes the directions of non-explicit normals, without rebuilding the normal list.

Remarks

Requires an accurate mpParent pointer.

CheckNormals()

DllExport void CheckNormals

(

)

This checks our flags and calls BuildNormals, ComputeNormals as needed.

Remarks

Requires an accurate mpParent pointer.

operator=()

DllExport MeshNormalSpec& operator=

(

const MeshNormalSpec &

from

)

CopySpecified() [1/2]

DllExport void CopySpecified

(

const MeshNormalSpec &

from

)

CopySpecified() [2/2]

DllExport bool CopySpecified	(	const MeshNormalSpec &	sourceNormals,
		const Tab< int > &	faceIndexMap,
		int	offset = 0
	)

For each face index map entry faceIndexMap[f] which is valid, i.e.

faceIndexMap[f] >= 0, the face targetFace = faceIndexMap[f] + offset of this object is defined as a copy of source face f of object sourceNormals, which may be the same as this object. In particular, face targetFace is allocated if necessary, and any vertex normals which are set as specified for the source face are copied to the corresponding vertices of the target face. The explicitness of normals is also preserved in the copy. Note that the operation will fail if sourceNormals is the same as this object, and the index map contains undefined copies, i.e. if for any f we have the conditions 0 <= faceIndexMap[f], targetFace < faceIndexMap.Count(), and faceIndexMap[targetFace] >= 0.

Parameters

[in]	sourceNormals	specified normals object containing the source face data
[in]	faceIndexMap	map from source to target faces; the condition faceIndexMap[f] < 0 indicates that source face f is not to be copied
[in]	offset	index offset to be applied to all valid entries of faceIndexMap in order to obtain the target face index; note that nnegative values are invalid, and will result in failure and a false return value

Returns

Flag indicating whether copy operation was successful.

operator+=()

DllExport MeshNormalSpec& operator+=

(

const MeshNormalSpec &

from

)

MyDebugPrint()

DllExport void MyDebugPrint

(

bool

printAll = false

)

CheckAllData()

DllExport bool CheckAllData

(

int

numParentFaces

)

Save()

DllExport IOResult Save

(

ISave *

isave

)

Load()

DllExport IOResult Load

(

ILoad *

iload

)

GetID()

Interface_ID GetID ( )

inlinevirtual

Remarks

This method returns the unique interface ID.

Reimplemented from IPipelineClient.

{return MESH_NORMAL_SPEC_INTERFACE;}

DeleteInterface()

DllExport void DeleteInterface ( )

virtual

Remarks

This method can be used as a direct interface delete request.

Default Implementation:

{ }

Reimplemented from BaseInterface.

GetInterface()

DllExport BaseInterface* GetInterface ( Interface_ID  id )

virtual

Remarks

Returns a pointer to the interface whose ID is specified.

Parameters:

Interface_ID id

The ID of the interface to return.

Default Implementation:

{ return NULL; }

Reimplemented from BaseInterface.

CloneInterface()

DllExport BaseInterface* CloneInterface ( void *  remapDir = NULL )

virtual

Remarks

This method allows you to clone the base interface.

Parameters:

void* remapDir

The RemapDir passed to the clone method.

Default Implementation:

{ return NULL; }

Reimplemented from BaseInterface.

ShallowCopy()

DllExport void ShallowCopy ( IPipelineClient *  from, ChannelMask  channels  )

virtual

Implements IPipelineClient.

DeepCopy()

DllExport void DeepCopy ( IPipelineClient *  from, ChannelMask  channels  )

virtual

Implements IPipelineClient.

NewAndCopyChannels()

DllExport void NewAndCopyChannels ( ChannelMask  channels )

virtual

Implements IPipelineClient.

FreeChannels()

DllExport void FreeChannels ( ChannelMask  channels, int  zeroOthers = 1  )

virtual

Implements IPipelineClient.

ZeroChannels()

DllExport void ZeroChannels ( ChannelMask  channels )

virtual

Implements IPipelineClient.

AppendAllChannels()

DllExport void AppendAllChannels ( IPipelineClient *  from )

virtual

Implements IPipelineClient.

Transform()

DllExport bool Transform	(	const Matrix3 &	transformMat,
		bool	useSelelection = false,
		const BitArray *	normalSelection = nullptr,
		bool	isGeomTransform = true
	)

Transforms the normals.

If isGeomTransform is true, the normals are transformed consistent with the transformation defined by matrix transformMat being applied to the geometry, meaning that the normal vectors are multiplied by transpose of the inverse of transformMat. If isGeomTransform is false, then the matrix portion of transformMat is simply applied directly. In both cases, we disregard the translation vector, and renormalize the affected normal vectors. Note that if transformMat represents a rotation, then the result is independent of the choice of isGeomTransform, since the matrix will be orthogonal.

Parameters

[in]	transformMat	matrix representing the transformation to be applied
[in]	useSelelection	when true, only selected normals are altered, otherwise, the transformation is applied to all defined normals
[in]	normalSelection	when useSelection is true, the selected normals are defined by normalSelection if not null, or the usual member selection, otherwise
[in]	isGeomTransform	when true, matrix transformMat is interpreted as a transformation applied to the associated geometry, as discussed above

Returns

Flag indicating whether any normals were altered. In particular, if the specified values of transformMat and isGeomTransform indicate an identity transformation, we will return false.

Translate()

DllExport bool Translate	(	Point3 &	translate,
		BOOL	useSel = true,
		BitArray *	normalSelection = NULL
	)

BreakNormals()

DllExport bool BreakNormals	(	BOOL	useSel = true,
		BitArray *	normalSelection = NULL,
		BOOL	toAverage = false
	)

UnifyNormals()

DllExport bool UnifyNormals	(	BOOL	useSel = true,
		BitArray *	normalSelection = NULL,
		BOOL	toAverage = false
	)

AverageNormals()

DllExport bool AverageNormals	(	BOOL	useThresh = false,
		float	threshold = 0.0f,
		BOOL	useSel = true,
		BitArray *	normalSelection = NULL
	)

SpecifyNormals()

DllExport bool SpecifyNormals	(	BOOL	useSel = true,
		BitArray *	normalSelection = NULL
	)

MakeNormalsExplicit()

DllExport bool MakeNormalsExplicit	(	BOOL	useSel = true,
		BitArray *	normalSelection = NULL,
		bool	value = true
	)

ResetNormals()

DllExport bool ResetNormals	(	BOOL	useSel = true,
		BitArray *	normalSelection = NULL
	)