3ds Max C++ API Reference
|
Extension to INode for accessing mental ray properties. More...
#include <C:/adskgit/3dsmax/3dsmax/3dswin/src/maxsdk/include/INodeMentalRayProperties.h>
Public Types | |
enum | DisplacementMethod { kDisplacementMethod_Fine = 0 , kDisplacementMethod_Fine_NoSmoothing = 1 , kDisplacementMethod_Parametric = 2 } |
enum | CastModeFG { kCastModeFG_ObjColor = 0 , kCastModeFG_Black = 1 , kCastModeFG_Invisible =2 } |
enum | PROPERTY_ACCESSOR_ID { GET_DISPLACEMENTUSEGLOBALSETTINGS , SET_DISPLACEMENTUSEGLOBALSETTINGS , GET_DISPLACEMENTMETHOD , SET_DISPLACEMENTMETHOD , GET_VIEWDEPENDENTDISPLACEMENT , SET_VIEWDEPENDENTDISPLACEMENT , GET_DISPLACEMENTEDGELENGTH , SET_DISPLACEMENTEDGELENGTH , GET_MAXDISPLACE , SET_MAXDISPLACE , GET_DISPLACEMENTMAXLEVEL , SET_DISPLACEMENTMAXLEVEL , GET_RECEIVEFGILLUM , SET_RECEIVEFGILLUM , GET_CASTMODEFGILLUM , SET_CASTMODEFGILLUM , GET_EXCLUDEGLOBALILLUM , SET_EXCLUDEGLOBALILLUM , GET_EXCLUDECAUSTICS , SET_EXCLUDECAUSTICS } |
Public Types inherited from BaseInterface | |
enum | LifetimeType { noRelease , immediateRelease , wantsRelease , serverControlled } |
Public Member Functions | |
virtual void | CopyMentalRayPropertiesFrom (const INodeMentalRayProperties &source)=0 |
Copy properties from another interface. | |
virtual bool | MRGetDisplacementUseGlobalSettings () const =0 |
Gets the value of the "Use global displacement settings" flag. | |
virtual void | MRSetDisplacementUseGlobalSettings (bool useGlobal)=0 |
Sets the value fo the "Use global displacement settings" flag. | |
virtual DisplacementMethod | MRGetDisplacementMethod () const =0 |
Gets the displacement method to be used. | |
virtual void | MRSetDisplacementMethod (DisplacementMethod method)=0 |
Sets the displacement method to be used. | |
virtual bool | MRGetIsViewDependentDisplacement () const =0 |
Gets the value of the "View-Dependent Displacement" flag. | |
virtual void | MRSetIsViewDependentDisplacement (bool viewDependent)=0 |
Sets the value of the "View-Dependent Displacement" flag. | |
virtual float | MRGetDisplacementEdgeLength () const =0 |
Gets the value of the "Edge Length" property. | |
virtual void | MRSetDisplacementEdgeLength (float length)=0 |
Sets the value of the "Edge Length" property. | |
virtual float | MRGetMaxDisplace () const =0 |
Gets the value of the "Max. Displace" property. | |
virtual void | MRSetMaxDisplace (float maxDisplace)=0 |
Sets the value of the "Max. Displace" property. | |
virtual unsigned short | MRGetDisplacementMaxLevel () const =0 |
Gets the value of the "Displacement Max. Level" property. | |
virtual void | MRSetDisplacementMaxLevel (unsigned short maxLevel)=0 |
Sets the value of the "Displacement Max. Level" property. | |
virtual bool | MRGetReceiveFGIllum () const =0 |
Gets the value of the "Receive Illumination from Final Gather" flag. | |
virtual void | MRSetReceiveFGIllum (bool onOff)=0 |
Sets the value of the "Receive Illumination from Final Gather" flag. | |
virtual CastModeFG | MRGetCastModeFGIllum () const =0 |
Gets the mode for the "Cast Illumination from Final Gather" to be used. | |
virtual void | MRSetCastModeFGIllum (CastModeFG method)=0 |
Sets the mode for the "Cast Illumination from Final Gather" to be used. | |
virtual bool | MRGetExcludeGlobalIllum () const =0 |
Gets the value of the "Exclude from Global Illumination Calculations" flag. | |
virtual void | MRSetExcludeGlobalIllum (bool onOff)=0 |
Sets the value of the "Exclude from Global Illumination Calculations" flag. | |
virtual bool | MRGetExcludeCaustics () const =0 |
Gets the value of the "Exclude from Caustics Calculations" flag. | |
virtual void | MRSetExcludeCaustics (bool onOff)=0 |
Sets the value of the "Exclude from Caustics Calculations" flag. | |
PROP_FNS (GET_DISPLACEMENTUSEGLOBALSETTINGS, MRGetDisplacementUseGlobalSettings, SET_DISPLACEMENTUSEGLOBALSETTINGS, MRSetDisplacementUseGlobalSettings, TYPE_bool) | |
PROP_FNS (GET_DISPLACEMENTMETHOD, MRGetDisplacementMethod, SET_DISPLACEMENTMETHOD, MRSetDisplacementMethod, TYPE_ENUM) | |
PROP_FNS (GET_VIEWDEPENDENTDISPLACEMENT, MRGetIsViewDependentDisplacement, SET_VIEWDEPENDENTDISPLACEMENT, MRSetIsViewDependentDisplacement, TYPE_bool) | |
PROP_FNS (GET_DISPLACEMENTEDGELENGTH, MRGetDisplacementEdgeLength, SET_DISPLACEMENTEDGELENGTH, MRSetDisplacementEdgeLength, TYPE_FLOAT) | |
PROP_FNS (GET_MAXDISPLACE, MRGetMaxDisplace, SET_MAXDISPLACE, MRSetMaxDisplace, TYPE_WORLD) | |
PROP_FNS (GET_DISPLACEMENTMAXLEVEL, MRGetDisplacementMaxLevel, SET_DISPLACEMENTMAXLEVEL, MRSetDisplacementMaxLevel, TYPE_INT) | |
PROP_FNS (GET_RECEIVEFGILLUM, MRGetReceiveFGIllum, SET_RECEIVEFGILLUM, MRSetReceiveFGIllum, TYPE_bool) | |
PROP_FNS (GET_CASTMODEFGILLUM, MRGetCastModeFGIllum, SET_CASTMODEFGILLUM, MRSetCastModeFGIllum, TYPE_ENUM) | |
PROP_FNS (GET_EXCLUDEGLOBALILLUM, MRGetExcludeGlobalIllum, SET_EXCLUDEGLOBALILLUM, MRSetExcludeGlobalIllum, TYPE_bool) | |
PROP_FNS (GET_EXCLUDECAUSTICS, MRGetExcludeCaustics, SET_EXCLUDECAUSTICS, MRSetExcludeCaustics, TYPE_bool) | |
Public Member Functions inherited from FPMixinInterface | |
FPMixinInterface () | |
virtual LifetimeType | LifetimeControl () |
virtual CoreExport bool | RegisterNotifyCallback (InterfaceNotifyCallback *incb) |
virtual void | UnRegisterNotifyCallback (InterfaceNotifyCallback *incb) |
CoreExport | ~FPMixinInterface () |
virtual BaseInterface * | GetInterface (Interface_ID id) |
virtual FPInterfaceDesc * | GetDescByID (Interface_ID id) |
virtual Interface_ID | GetID () |
Public Member Functions inherited from FPInterface | |
virtual FPInterfaceDesc * | GetDesc ()=0 |
virtual CoreExport FPStatus | Invoke (FunctionID fid, TimeValue t=0, FPParams *params=NULL) |
virtual FPStatus | Invoke (FunctionID fid, FPParams *params) |
virtual CoreExport FPStatus | Invoke (FunctionID fid, TimeValue t, FPValue &result, FPParams *params=NULL) |
virtual FPStatus | Invoke (FunctionID fid, FPValue &result, FPParams *params=NULL) |
virtual CoreExport FunctionID | FindFn (const MCHAR *name) |
virtual CoreExport BOOL | IsEnabled (FunctionID actionID) |
virtual CoreExport BOOL | IsChecked (FunctionID actionID) |
virtual CoreExport BOOL | IsVisible (FunctionID actionID) |
virtual CoreExport FunctionID | GetIsEnabled (FunctionID actionID) |
virtual CoreExport FunctionID | GetIsChecked (FunctionID actionID) |
virtual CoreExport FunctionID | GetIsVisible (FunctionID actionID) |
virtual ActionTable * | GetActionTable () |
virtual void | EnableActions (BOOL onOff) |
Public Member Functions inherited from BaseInterface | |
virtual UtilExport | ~BaseInterface () |
Destructor. | |
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. | |
template<class InterfaceType> | |
InterfaceType * | GetTypedInterface () |
Static Public Member Functions | |
static INodeMentalRayProperties * | Get_INodeMentalRayProperties (INode &node) |
Use this function to retrieve a pointer to the INodeMentalRayProperties interface. | |
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. |
Additional Inherited Members | |
Static Public Attributes inherited from FPInterface | |
static CoreExport FPInterfaceDesc | nullInterface |
Protected Member Functions inherited from FPMixinInterface | |
FPMixinInterface (const FPMixinInterface &rhs) | |
FPMixinInterface & | operator= (const FPMixinInterface &rhs) |
Protected Member Functions inherited from FPInterface | |
virtual FPStatus | _dispatch_fn (FunctionID fid, TimeValue t, FPValue &result, FPParams *p) |
Protected Attributes inherited from FPMixinInterface | |
Tab< InterfaceNotifyCallback * > * | interfaceNotifyCBs |
Extension to INode for accessing mental ray properties.
This interface class defines a set of methods for accessing mental ray properties on an INode. To get a pointer to this interface from an INode, call:
INodeMentalRayProperties* mr_properties = Get_INodeMentalRayProperties(node);
The properties exposed by this class to the SDK are also exposed to MaxScript through the function publishing system.
enum DisplacementMethod |
Enumerator | |
---|---|
kDisplacementMethod_Fine | |
kDisplacementMethod_Fine_NoSmoothing | |
kDisplacementMethod_Parametric |
enum CastModeFG |
Enumerator | |
---|---|
kCastModeFG_ObjColor | |
kCastModeFG_Black | |
kCastModeFG_Invisible |
enum PROPERTY_ACCESSOR_ID |
|
inlinestatic |
Use this function to retrieve a pointer to the INodeMentalRayProperties interface.
[in] | node | - The node on which you want to query the interface. |
|
pure virtual |
Copy properties from another interface.
[in] | source | - The properties to be copied. |
|
pure virtual |
Gets the value of the "Use global displacement settings" flag.
|
pure virtual |
Sets the value fo the "Use global displacement settings" flag.
[in] | useGlobal | - The value to be set. |
|
pure virtual |
Gets the displacement method to be used.
|
pure virtual |
Sets the displacement method to be used.
[in] | method | - The displacement method. |
|
pure virtual |
Gets the value of the "View-Dependent Displacement" flag.
|
pure virtual |
Sets the value of the "View-Dependent Displacement" flag.
[in] | viewDependent | - The value to be set. |
|
pure virtual |
Gets the value of the "Edge Length" property.
Note: this value should be interpreted as pixels if the "view-dependent" flag is ON, and as object-space units if the "view-dependent" flag is OFF.
|
pure virtual |
Sets the value of the "Edge Length" property.
Note: this value should be interpreted as pixels if the "view-dependent" flag is ON, and as object-space units if the "view-dependent" flag is OFF.
[in] | length | - The value to be set. |
|
pure virtual |
Gets the value of the "Max. Displace" property.
|
pure virtual |
Sets the value of the "Max. Displace" property.
[in] | maxDisplace | - The value to be set. |
|
pure virtual |
Gets the value of the "Displacement Max. Level" property.
|
pure virtual |
Sets the value of the "Displacement Max. Level" property.
[in] | maxLevel | - The value to bet set. |
|
pure virtual |
Gets the value of the "Receive Illumination from Final Gather" flag.
|
pure virtual |
Sets the value of the "Receive Illumination from Final Gather" flag.
[in] | onOff | - The value to be set. |
|
pure virtual |
Gets the mode for the "Cast Illumination from Final Gather" to be used.
|
pure virtual |
Sets the mode for the "Cast Illumination from Final Gather" to be used.
[in] | method | - The mode to be used for FG Rays that hit the object. |
|
pure virtual |
Gets the value of the "Exclude from Global Illumination Calculations" flag.
|
pure virtual |
Sets the value of the "Exclude from Global Illumination Calculations" flag.
[in] | onOff | - The value to be set. |
|
pure virtual |
Gets the value of the "Exclude from Caustics Calculations" flag.
|
pure virtual |
Sets the value of the "Exclude from Caustics Calculations" flag.
[in] | onOff | - The value to be set. |
PROP_FNS | ( | GET_DISPLACEMENTUSEGLOBALSETTINGS | , |
MRGetDisplacementUseGlobalSettings | , | ||
SET_DISPLACEMENTUSEGLOBALSETTINGS | , | ||
MRSetDisplacementUseGlobalSettings | , | ||
TYPE_bool | ) |
PROP_FNS | ( | GET_DISPLACEMENTMETHOD | , |
MRGetDisplacementMethod | , | ||
SET_DISPLACEMENTMETHOD | , | ||
MRSetDisplacementMethod | , | ||
TYPE_ENUM | ) |
PROP_FNS | ( | GET_VIEWDEPENDENTDISPLACEMENT | , |
MRGetIsViewDependentDisplacement | , | ||
SET_VIEWDEPENDENTDISPLACEMENT | , | ||
MRSetIsViewDependentDisplacement | , | ||
TYPE_bool | ) |
PROP_FNS | ( | GET_DISPLACEMENTEDGELENGTH | , |
MRGetDisplacementEdgeLength | , | ||
SET_DISPLACEMENTEDGELENGTH | , | ||
MRSetDisplacementEdgeLength | , | ||
TYPE_FLOAT | ) |
PROP_FNS | ( | GET_MAXDISPLACE | , |
MRGetMaxDisplace | , | ||
SET_MAXDISPLACE | , | ||
MRSetMaxDisplace | , | ||
TYPE_WORLD | ) |
PROP_FNS | ( | GET_DISPLACEMENTMAXLEVEL | , |
MRGetDisplacementMaxLevel | , | ||
SET_DISPLACEMENTMAXLEVEL | , | ||
MRSetDisplacementMaxLevel | , | ||
TYPE_INT | ) |
PROP_FNS | ( | GET_RECEIVEFGILLUM | , |
MRGetReceiveFGIllum | , | ||
SET_RECEIVEFGILLUM | , | ||
MRSetReceiveFGIllum | , | ||
TYPE_bool | ) |
PROP_FNS | ( | GET_CASTMODEFGILLUM | , |
MRGetCastModeFGIllum | , | ||
SET_CASTMODEFGILLUM | , | ||
MRSetCastModeFGIllum | , | ||
TYPE_ENUM | ) |
PROP_FNS | ( | GET_EXCLUDEGLOBALILLUM | , |
MRGetExcludeGlobalIllum | , | ||
SET_EXCLUDEGLOBALILLUM | , | ||
MRSetExcludeGlobalIllum | , | ||
TYPE_bool | ) |
PROP_FNS | ( | GET_EXCLUDECAUSTICS | , |
MRGetExcludeCaustics | , | ||
SET_EXCLUDECAUSTICS | , | ||
MRSetExcludeCaustics | , | ||
TYPE_bool | ) |