MNQuadChamferParameters Class Reference

This class is used to provide parameters to the Universal Quad Chamfer interface in IMNMeshUtilities16. More...

#include <MNQuadChamferParameters.h>

Inheritance diagram for MNQuadChamferParameters:

Public Member Functions
	MNQuadChamferParameters (float amount, int segments, float tension, MN_QCHAM_TYPE resultType, DWORD flag)
	Constructor for operation as original version (3ds Max 2015)
	MNQuadChamferParameters (float amount, int segments, float tension, DWORD optionFlags, MN_QCHAM_TYPE resultType, DWORD flag, int version)
	Constructor for operation as Phoenix (Max 2016) version.
	MNQuadChamferParameters (float amount, float minAmount, float maxAmount, int segments, float tension, float depth, float insetAmount, int insetSegments, float insetOffset, float miterEndBias, DWORD optionFlags, MN_QCHAM_TYPE resultType, DWORD flag, int version)
	Constructor for operation as 3ds Max 2020 or later.
	MNQuadChamferParameters (const MNQuadChamferParameters &from)
	Copy constructor.
unsigned int	GetVersion () const
float	GetAmount () const
float	GetMinVarAmount () const
float	GetMaxVarAmount () const
int	GetSegments () const
float	GetTension () const
float	GetDepth () const
float	GetInsetAmount () const
int	GetInsetSegments () const
float	GetInsetOffset () const
float	GetMiterEndBias () const
DWORD	GetOptionFlags () const
MN_QCHAM_TYPE	GetResultType () const
DWORD	GetFlag () const

Protected Attributes
unsigned int	m_version
	The Quad Chamfer version to use (See Quad Chamfer Version Values)
float	m_amount
	The chamfer amount for non-weighted chamfers.
float	m_minVarAmount
	The chamfer amount for crease == 0.0.
float	m_maxVarAmount
	The chamfer amount for crease == 1.0.
int	m_segments
	The number of segments in the chamfers.
float	m_tension
	The tension of the chamfer (0 = no tension, 0.5 = rounded, 1.0 = linear)
float	m_depth
	The depth of the chamfer (-1 = concave, 0.0 = linear, 1.0 = convex)
float	m_insetAmount
	The amount of the inset, if in use.
int	m_insetSegments
	The number of inset segments.
float	m_insetOffset
	The inset offset.
float	m_miterEndBias
	Biasing for transition along unchamfered edge connecting to a chamfered edge.
DWORD	m_optionFlags
	Chamfer options (See Quad Chamfer Result Options)
MN_QCHAM_TYPE	m_resultType
	Chamfer result options (See MN_QCHAM_TYPE)
DWORD	m_flag
	The MN_XXX flag that indicates edges to chamfer (See GeneralMNMeshComponentFlags)

Additional Inherited Members
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 used to provide parameters to the Universal Quad Chamfer interface in IMNMeshUtilities16.

The parameter set includes all applicable parameters for Quad Chamfer operations and allows for specifying version numbers (See Quad Chamfer Version Values). In this way the IMNMeshUtilities16 interface can be used for any Quad Chamfer operations now and into the future – Various constructors are provided for ease of use, and as parameters are added in the future, constructors will be added to access that functionality.

Constructor & Destructor Documentation

MNQuadChamferParameters() [1/4]

MNQuadChamferParameters ( float  amount, int  segments, float  tension, MN_QCHAM_TYPE  resultType, DWORD  flag  )

inline

Constructor for operation as original version (3ds Max 2015)

Parameters

amount	The chamfer amount
segments	The number of segments in the chamfers
tension	The tension of the chamfer (0 = no tension, 0.5 = rounded, 1.0 = linear)
resultType	Chamfer result options (See MN_QCHAM_TYPE)
flag	The MN_XXX flag that indicates edges to chamfer (See GeneralMNMeshComponentFlags)

                                                                                                             :
        m_version(QCHAM_VERSION_ELWOOD),
        m_amount(amount),
        m_minVarAmount(0.0f),
        m_maxVarAmount(0.0f),
        m_segments(segments),
        m_tension(tension),
        m_depth(0.0f),
        m_insetAmount(0.0f),
        m_insetSegments(0),
        m_insetOffset(0.0f),
        m_miterEndBias(0.5f),
        m_optionFlags(QCHAM_OPTION_ELWOOD_DEFAULTS),
        m_resultType(resultType),
        m_flag(flag) {}

MNQuadChamferParameters() [2/4]

MNQuadChamferParameters ( float  amount, int  segments, float  tension, DWORD  optionFlags, MN_QCHAM_TYPE  resultType, DWORD  flag, int  version  )

inline

Constructor for operation as Phoenix (Max 2016) version.

(If QCHAM_OPTION_VARIABLE_EDGE_WEIGHTS option is used, the chamfers will vary from 0.0 at Crease == 0.0 to "amount" at Crease == 1.0.)

Parameters

amount	The chamfer amount
segments	The number of segments in the chamfers
tension	The tension of the chamfer (0 = no tension, 0.5 = rounded, 1.0 = linear)
optionFlags	Chamfer options (See Quad Chamfer Result Options)
resultType	Chamfer result options (See MN_QCHAM_TYPE)
flag	The MN_XXX flag that indicates edges to chamfer (See GeneralMNMeshComponentFlags)
version	The Quad Chamfer version to use (See Quad Chamfer Version Values)

                                                                                                                                             :
        m_version(version),
        m_amount(amount),
        m_minVarAmount(0.0f),
        m_maxVarAmount(amount),
        m_segments(segments),
        m_tension(tension),
        m_depth(0.0f),
        m_insetAmount(0.0f),
        m_insetSegments(0),
        m_insetOffset(0.0f),
        m_miterEndBias(0.5f),
        m_optionFlags(optionFlags),
        m_resultType(resultType),
        m_flag(flag) {}

MNQuadChamferParameters() [3/4]

MNQuadChamferParameters ( float  amount, float  minAmount, float  maxAmount, int  segments, float  tension, float  depth, float  insetAmount, int  insetSegments, float  insetOffset, float  miterEndBias, DWORD  optionFlags, MN_QCHAM_TYPE  resultType, DWORD  flag, int  version  )

inline

Constructor for operation as 3ds Max 2020 or later.

Parameters

amount	The chamfer amount
minAmount	When QCHAM_OPTION_VARIABLE_EDGE_WEIGHTS option is used, the chamfer amount at Crease == 0.0
maxAmount	When QCHAM_OPTION_VARIABLE_EDGE_WEIGHTS option is used, the chamfer amount at Crease == 1.0
segments	The number of segments in the chamfers
tension	The tension of the chamfer (0 = no tension, 0.5 = rounded, 1.0 = linear)
depth	The depth of the chamfer (-1.0 = concave, 0.0 = linear, 1.0 = convex)
insetAmount	The inset amount
insetSegments	The number of segments for the inset
insetOffset	The inset offset amount
miterEndBias	The miter end bias amount
optionFlags	Chamfer options (See Quad Chamfer Result Options)
resultType	Chamfer result options (See MN_QCHAM_TYPE)
flag	The MN_XXX flag that indicates edges to chamfer (See GeneralMNMeshComponentFlags)
version	The Quad Chamfer version to use (See Quad Chamfer Version Values)

                                                                                                                                                                                                                                                                         :
        m_version(version),
        m_amount(amount),
        m_minVarAmount(minAmount),
        m_maxVarAmount(maxAmount),
        m_segments(segments),
        m_tension(tension),
        m_depth(depth),
        m_insetAmount(insetAmount),
        m_insetSegments(insetSegments),
        m_insetOffset(insetOffset),
        m_miterEndBias(miterEndBias),
        m_optionFlags(optionFlags),
        m_resultType(resultType),
        m_flag(flag) {}

MNQuadChamferParameters() [4/4]

MNQuadChamferParameters ( const MNQuadChamferParameters &  from )

inline

Copy constructor.

                                                                :
        m_version(from.m_version),
        m_amount(from.m_amount),
        m_minVarAmount(from.m_minVarAmount),
        m_maxVarAmount(from.m_maxVarAmount),
        m_segments(from.m_segments),
        m_tension(from.m_tension),
        m_depth(from.m_depth),
        m_insetAmount(from.m_insetAmount),
        m_insetSegments(from.m_insetSegments),
        m_insetOffset(from.m_insetOffset),
        m_miterEndBias(from.m_miterEndBias),
        m_optionFlags(from.m_optionFlags),
        m_resultType(from.m_resultType),
        m_flag(from.m_flag)
    {
    }

Member Function Documentation

GetVersion()

unsigned int GetVersion ( ) const

inline

{ return m_version; }

GetAmount()

float GetAmount ( ) const

inline

{ return m_amount; }

GetMinVarAmount()

float GetMinVarAmount ( ) const

inline

{ return m_minVarAmount; }

GetMaxVarAmount()

float GetMaxVarAmount ( ) const

inline

{ return m_maxVarAmount; }

GetSegments()

int GetSegments ( ) const

inline

{ return m_segments; }

GetTension()

float GetTension ( ) const

inline

{ return m_tension; }

GetDepth()

float GetDepth ( ) const

inline

{ return m_depth; }

GetInsetAmount()

float GetInsetAmount ( ) const

inline

{ return m_insetAmount; }

GetInsetSegments()

int GetInsetSegments ( ) const

inline

{ return m_insetSegments; }

GetInsetOffset()

float GetInsetOffset ( ) const

inline

{ return m_insetOffset; }

GetMiterEndBias()

float GetMiterEndBias ( ) const

inline

{ return m_miterEndBias; }

GetOptionFlags()

DWORD GetOptionFlags ( ) const

inline

{ return m_optionFlags; }

GetResultType()

MN_QCHAM_TYPE GetResultType ( ) const

inline

{ return m_resultType; }

GetFlag()

DWORD GetFlag ( ) const

inline

{ return m_flag; }

Member Data Documentation

m_version

unsigned int m_version

protected

The Quad Chamfer version to use (See Quad Chamfer Version Values)

m_amount

float m_amount

protected

The chamfer amount for non-weighted chamfers.

m_minVarAmount

float m_minVarAmount

protected

The chamfer amount for crease == 0.0.

m_maxVarAmount

float m_maxVarAmount

protected

The chamfer amount for crease == 1.0.

m_segments

int m_segments

protected

The number of segments in the chamfers.

m_tension

float m_tension

protected

The tension of the chamfer (0 = no tension, 0.5 = rounded, 1.0 = linear)

m_depth

float m_depth

protected

The depth of the chamfer (-1 = concave, 0.0 = linear, 1.0 = convex)

m_insetAmount

float m_insetAmount

protected

The amount of the inset, if in use.

m_insetSegments

int m_insetSegments

protected

The number of inset segments.

m_insetOffset

float m_insetOffset

protected

The inset offset.

m_miterEndBias

float m_miterEndBias

protected

Biasing for transition along unchamfered edge connecting to a chamfered edge.

m_optionFlags

DWORD m_optionFlags

protected

Chamfer options (See Quad Chamfer Result Options)

m_resultType

MN_QCHAM_TYPE m_resultType

protected

Chamfer result options (See MN_QCHAM_TYPE)

m_flag

DWORD m_flag

protected

The MN_XXX flag that indicates edges to chamfer (See GeneralMNMeshComponentFlags)