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.
void	ClearFlag (DWORD fl)
	Clears the flags given. See GetFlag for more details on MeshNormalSpec flags.
bool	GetFlag (DWORD fl) const
	Gets flags in the MeshNormalSpec.
DllExport void	Initialize ()
	Initializes all data members - do not use if already allocated!
DllExport bool	NAlloc (int num, bool keep=TRUE)
DllExport void	NShrink ()
	shrinks allocation down to actual number of normals.
DllExport bool	FAlloc (int num, bool keep=TRUE)
DllExport void	FShrink ()
DllExport void	Clear ()
	Deletes everything.
DllExport void	ClearAndFree ()
	Deletes everything, frees all memory.
int	GetNumFaces () const
DllExport bool	SetNumFaces (int numFaces)
int	GetNumNormals () const
DllExport bool	SetNumNormals (int numNormals)
const Point3 &	Normal (int normID) const
Point3 &	Normal (int normID)
const Point3 *	GetNormalArray () const
Point3 *	GetNormalArray ()
bool	GetNormalExplicit (int normID) const
void	SetNormalExplicit (int normID, bool value)
bool	AnyExplicitNormalsSet () const
	Returns true if there are any explicit normals set.
void	SetAllExplicit (bool value=true)
	Set all normals to be explicit.
const MeshNormalFace &	Face (int faceID) const
MeshNormalFace &	Face (int faceID)
const MeshNormalFace *	GetFaceArray () const
MeshNormalFace *	GetFaceArray ()
void	SetParent (Mesh *pMesh)
DllExport const Point3 &	GetNormal (int face, int corner) const
DllExport Point3 &	GetNormal (int face, int corner)
DllExport void	SetNormal (int face, int corner, Point3 &normal)
DllExport int	GetNormalIndex (int face, int corner) const
DllExport void	SetNormalIndex (int face, int corner, int normalIndex)
DllExport int	NewNormal (Point3 normal, bool explic=true)
DllExport void	SetSelection (BitArray &newSelection)
const BitArray &	GetSelection () const
BitArray &	GetSelection ()
void	SetDisplayLength (float displayLength)
float	GetDisplayLength () const
DllExport void	Display (GraphicsWindow *gw, bool showSel)
DllExport bool	HitTest (GraphicsWindow *gw, HitRegion *hr, DWORD flags, SubObjHitList &hitList)
DllExport Box3	GetBoundingBox (const Matrix3 *tm=NULL, bool selectedOnly=false) const
DllExport void	ClearNormals ()
	This method dumps all unspecified normals. Best to use only from within CheckNormals.
DllExport void	BuildNormals ()
	Fills in the mpSpecNormal data by building all the unspecified normals, and computing non-explicit ones.
DllExport void	ComputeNormals ()
	This method just recomputes the directions of non-explicit normals, without rebuilding the normal list.
DllExport void	CheckNormals ()
	This checks our flags and calls BuildNormals, ComputeNormals as needed.
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.
DllExport MeshNormalSpec &	operator+= (const MeshNormalSpec &from)
DllExport void	MyDebugPrint (bool printAll=false)
DllExport bool	CheckAllData (int numParentFaces)
DllExport IOResult	Save (ISave *isave)
DllExport IOResult	Save (ISave *isave, ChannelMask channels)
DllExport IOResult	Load (ILoad *iload)
DllExport IOResult	Load (ILoad *iload, ChannelMask channels)
Interface_ID	GetID () override
DllExport void	DeleteInterface () override
DllExport BaseInterface *	GetInterface (Interface_ID id) override
DllExport BaseInterface *	CloneInterface (void *remapDir=NULL) override
DllExport void	ShallowCopy (IPipelineClient *from, ChannelMask channels) override
DllExport void	DeepCopy (IPipelineClient *from, ChannelMask channels) override
DllExport void	NewAndCopyChannels (ChannelMask channels) override
DllExport void	FreeChannels (ChannelMask channels, int zeroOthers=1) override
DllExport void	ZeroChannels (ChannelMask channels) override
DllExport void	AppendAllChannels (IPipelineClient *from) override
DllExport bool	Transform (const Matrix3 &transformMat, bool useSelelection=false, const BitArray *normalSelection=nullptr, bool isGeomTransform=true)
	Transforms the normals.
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)
virtual void	ShallowCopy (IPipelineClient *from, ChannelMask channels)=0
virtual void	DeepCopy (IPipelineClient *from, ChannelMask channels)=0
virtual void	NewAndCopyChannels (ChannelMask channels)=0
virtual void	FreeChannels (ChannelMask channels, int zeroOthers=1)=0
virtual void	ZeroChannels (ChannelMask channels)=0
virtual void	AppendAllChannels (IPipelineClient *from)=0
virtual Interface_ID	GetID ()
Public Member Functions inherited from BaseInterface
virtual UtilExport	~BaseInterface ()
	Destructor.
UtilExport BaseInterface *	GetInterface (Interface_ID id) override
virtual UtilExport Interface_ID	GetID ()
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=nullptr)
Public Member Functions inherited from InterfaceServer
virtual UtilExport	~InterfaceServer ()
	Destructor.
virtual UtilExport BaseInterface *	GetInterface (Interface_ID id)
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
static UtilExport void *	operator new[] (size_t size, int block_type, const char *filename, int line)
	New operator used to allocate arrays of objects.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
static UtilExport void *	operator new (size_t size, void *placement_ptr)
	Placement new operator.
static UtilExport void	operator delete (void *ptr, void *placement_ptr)
	Placement delete operator.
static UtilExport void *	aligned_malloc (size_t size, size_t alignment)
	Allocates memory on a specified alignment boundary.
static UtilExport void *	aligned_realloc (void *ptr, size_t size, size_t alignment)
	Reallocates memory on a specified alignment boundary.
static UtilExport void	aligned_free (void *ptr)
	Frees a block of memory that was allocated with aligned_malloc/aligned_realloc.

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() [1/2]

const Point3 & Normal ( int  normID ) const

inline

    {
        return mpNormal[normID];
    }

Normal() [2/2]

Point3 & Normal ( int  normID )

inline

    {
        return mpNormal[normID];
    }

GetNormalArray() [1/2]

const Point3 * GetNormalArray ( ) const

inline

    {
        return mpNormal;
    }

GetNormalArray() [2/2]

Point3 * GetNormalArray ( )

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);
    }

AnyExplicitNormalsSet()

bool AnyExplicitNormalsSet ( ) const

inline

Returns true if there are any explicit normals set.

{ return mNormalExplicit.AnyBitSet(); }

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() [1/2]

const MeshNormalFace & Face ( int  faceID ) const

inline

    {
        return mpFace[faceID];
    }

Face() [2/2]

MeshNormalFace & Face ( int  faceID )

inline

    {
        return mpFace[faceID];
    }

GetFaceArray() [1/2]

const MeshNormalFace * GetFaceArray ( ) const

inline

    {
        return mpFace;
    }

GetFaceArray() [2/2]

MeshNormalFace * GetFaceArray ( )

inline

    {
        return mpFace;
    }

SetParent()

void SetParent ( Mesh *  pMesh )

inline

    {
        mpParent = pMesh;
    }

GetNormal() [1/2]

DllExport const Point3 & GetNormal	(	int	face,
		int	corner
	)		const

GetNormal() [2/2]

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
	)		const

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() [1/2]

const BitArray & GetSelection ( ) const

inline

    {
        return mNormalSel;
    }

GetSelection() [2/2]

BitArray & GetSelection ( )

inline

    {
        return mNormalSel;
    }

SetDisplayLength()

void SetDisplayLength ( float  displayLength )

inline

    {
        mDisplayLength = displayLength;
    }

GetDisplayLength()

float GetDisplayLength ( ) const

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	(	const Matrix3 *	tm = NULL,
		bool	selectedOnly = false
	)		const

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() [1/2]

DllExport IOResult Save

(

ISave *

isave

)

Save() [2/2]

DllExport IOResult Save	(	ISave *	isave,
		ChannelMask	channels
	)

Load() [1/2]

DllExport IOResult Load

(

ILoad *

iload

)

Load() [2/2]

DllExport IOResult Load	(	ILoad *	iload,
		ChannelMask	channels
	)

GetID()

Interface_ID GetID ( )

inlineoverridevirtual

Remarks

This method returns the unique interface ID.

Reimplemented from IPipelineClient.

    {
        return MESH_NORMAL_SPEC_INTERFACE;
    }

DeleteInterface()

DllExport void DeleteInterface ( )

overridevirtual

Remarks

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

Default Implementation:

{ }

Reimplemented from BaseInterface.

GetInterface()

DllExport BaseInterface * GetInterface ( Interface_ID  id )

overridevirtual

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 )

overridevirtual

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  )

overridevirtual

Implements IPipelineClient.

DeepCopy()

DllExport void DeepCopy ( IPipelineClient *  from, ChannelMask  channels  )

overridevirtual

Implements IPipelineClient.

NewAndCopyChannels()

DllExport void NewAndCopyChannels ( ChannelMask  channels )

overridevirtual

Implements IPipelineClient.

FreeChannels()

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

overridevirtual

Implements IPipelineClient.

ZeroChannels()

DllExport void ZeroChannels ( ChannelMask  channels )

overridevirtual

Implements IPipelineClient.

AppendAllChannels()

DllExport void AppendAllChannels ( IPipelineClient *  from )

overridevirtual

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
	)