C++ API Reference
MRenderPassDef Class Reference

Render pass information. More...

#include <MRenderPassDef.h>

Public Member Functions

virtual ~MRenderPassDef ()
 Destructor.
 
MPxRenderPassImplgetImplementation (const MString &renderer, MPxRenderPassImpl::PassTypeBit fbType, unsigned int numChannels, MStatus *ReturnStatus=NULL)
 Retrieve an implementation of this render pass for the given renderer. More...
 
MPxRenderPassImplgetImplementation (const MString &renderer, MStatus *ReturnStatus=NULL)
 Retrieve an implementation of this render pass for the given renderer. More...
 
MString getID (MStatus *ReturnStatus=NULL) const
 Retrieve the pass ID for this pass. More...
 
MString getName (MStatus *ReturnStatus=NULL) const
 Retrieve the pass name for this pass. More...
 
MString getGroup (MStatus *ReturnStatus=NULL) const
 Retrieve the pass group for this pass. More...
 
MString getDescription (MStatus *ReturnStatus=NULL) const
 Retrieve the description for this pass. More...
 
MString getAttributeType (const MString &attributeName, MStatus *ReturnStatus=NULL) const
 Retrieve the type of a given render pass attribute. More...
 
MStatus addFloatParameter (const MString &longName, const MString &shortName, const MString &UIName, const float &minValue, const float &maxValue, const float &defaultValue)
 Define a single-precision floating-point parameter for the pass. More...
 
MStatus addDoubleParameter (const MString &longName, const MString &shortName, const MString &UIName, const double &minValue, const double &maxValue, const double &defaultValue)
 Define a double-precision floating-point parameter for the pass. More...
 
MStatus addIntParameter (const MString &longName, const MString &shortName, const MString &UIName, const int &minValue, const int &maxValue, const int &defaultValue)
 Define an integer parameter for the pass. More...
 

Static Public Member Functions

static const char * className ()
 Returns the name of this class. More...
 

Friends

class MRenderPassRegistry
 
class MFnPlugin
 

Detailed Description

Render pass information.

This class provides a means to access information about a specific render pass. Initialize by passing to MRenderPassRegistry::getRenderPassDefinition(), or by calling create() to generate and register a new pass.

Member Function Documentation

MPxRenderPassImpl * getImplementation ( const MString renderer,
MPxRenderPassImpl::PassTypeBit  fbType,
unsigned int  numChannels,
MStatus ReturnStatus = NULL 
)

Retrieve an implementation of this render pass for the given renderer.

That supports the specified data type and the specified number of channels.

Parameters
[in]rendererThe renderer
[in]fbTypeThe base data type of the frame buffer
[in]numChannelsThe number of components per pixel in the frame buffer
[out]ReturnStatusStatus code
Returns
A pointer to the pass implementation or null if no definition exists
Status Codes:
  • MS::kSuccess The implementation was retrieved
  • MS::kFailure An object error has occured
MPxRenderPassImpl * getImplementation ( const MString renderer,
MStatus ReturnStatus = NULL 
)

Retrieve an implementation of this render pass for the given renderer.

Parameters
[in]rendererThe renderer
[out]ReturnStatusStatus code
Returns
A pointer to the pass implementation or null if no definition exists
Status Codes:
  • MS::kSuccess The implementation was retrieved
  • MS::kFailure An object error has occured
MString getID ( MStatus ReturnStatus = NULL) const

Retrieve the pass ID for this pass.

Parameters
[out]ReturnStatusStatus code
Returns
The pass ID
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occured
MString getName ( MStatus ReturnStatus = NULL) const

Retrieve the pass name for this pass.

Parameters
[out]ReturnStatusStatus code
Returns
The pass name
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occured
MString getGroup ( MStatus ReturnStatus = NULL) const

Retrieve the pass group for this pass.

Parameters
[out]ReturnStatusStatus code
Returns
The pass group
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occured
MString getDescription ( MStatus ReturnStatus = NULL) const

Retrieve the description for this pass.

Parameters
[out]ReturnStatusStatus code
Returns
The description
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occured
MString getAttributeType ( const MString attributeName,
MStatus ReturnStatus = NULL 
) const

Retrieve the type of a given render pass attribute.

Parameters
[in]attributeNameThe name of the render pass attribute to query.
[out]ReturnStatusStatus code.
Returns
The type of the given attribute.
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occured
MStatus addFloatParameter ( const MString longName,
const MString shortName,
const MString UIName,
const float &  minValue,
const float &  maxValue,
const float &  defaultValue 
)

Define a single-precision floating-point parameter for the pass.

Parameters
[in]longNameThe full name of the parameter
[in]shortNameThe short name of the parameter
[in]UINameName to display in UI for the parameter
[in]minValueThe minimum value of the parameter
[in]maxValueThe maximum value of the parameter
[in]defaultValueThe default value of the parameter
Returns
Status code
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occured
MStatus addDoubleParameter ( const MString longName,
const MString shortName,
const MString UIName,
const double &  minValue,
const double &  maxValue,
const double &  defaultValue 
)

Define a double-precision floating-point parameter for the pass.

Parameters
[in]longNameThe full name of the parameter
[in]shortNameThe short name of the parameter
[in]UINameName to display in UI for the parameter
[in]minValueThe minimum value of the parameter
[in]maxValueThe maximum value of the parameter
[in]defaultValueThe default value of the parameter
Returns
Status
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occured
MStatus addIntParameter ( const MString longName,
const MString shortName,
const MString UIName,
const int &  minValue,
const int &  maxValue,
const int &  defaultValue 
)

Define an integer parameter for the pass.

Parameters
[in]longNameThe full name of the parameter
[in]shortNameThe short name of the parameter
[in]UINameName to display in UI for the parameter
[in]minValueThe minimum value of the parameter
[in]maxValueThe maximum value of the parameter
[in]defaultValueThe default value of the parameter
Returns
Status
Status Codes:
  • MS::kSuccess The method was successful
  • MS::kFailure An object error has occured
const char * className ( )
static

Returns the name of this class.

Returns
The name of this class.

The documentation for this class was generated from the following files: