This reference page is linked to from the following overview topics: Extension for Autodesk Maya 2013, Rendering Overrides, 2.5 Render Targets and Render Target Manager.

Detailed Description

Class which provides a description of a hardware render target The name is the unique identifier for a render target.

#include <MRenderTargetManager.h>

List of all members.

Public Member Functions
	MRenderTargetDescription ()
	Default constructor, initalizes description with zero height and width and other simple default values.
	MRenderTargetDescription (const MString &name, unsigned int width, unsigned int height, unsigned int multiSampleCount, MHWRender::MRasterFormat rasterFormat, unsigned int arraySliceCount, bool isCubeMap)
	Constructor for a render target description.
virtual	~MRenderTargetDescription ()
	Default destructor.
const MString &	name () const
	Query the name identifier for the target description.
unsigned int	width () const
	Query the width of a 2D render target slice.
unsigned int	height () const
	Query the height of a 2D render target slice.
unsigned int	multiSampleCount () const
	Query the multi-sample count defined by the description.
MHWRender::MRasterFormat	rasterFormat () const
	Query the raster format defined by the description.
unsigned int	arraySliceCount () const
	Query the number of array slices defined by the description.
bool	isCubeMap () const
	Query whether this is a cube map target.
bool	allowsUnorderedAccess () const
	Query whether unordered access is supported.
void	setName (const MString &name)
	Set name of the target.
void	setWidth (unsigned int val)
	Set width of the target.
void	setHeight (unsigned int val)
	Set height of the target.
void	setMultiSampleCount (unsigned int val)
	Set multisample count of the target.
void	setRasterFormat (MHWRender::MRasterFormat val)
	Set the raster format of the target.
void	setArraySliceCount (unsigned int val)
	Set array slice count of the target.
void	setIsCubeMap (bool val)
	Set cube map flag for the target.
void	setAllowsUnorderedAccess (bool val)
	Set the flag for unordered data access for the target.
bool	compatibleWithDescription (const MRenderTargetDescription &desc)
	Determine if another target with a given description is 'compatible' with a target using this description.

Constructor & Destructor Documentation

MRenderTargetDescription	(	const MString &	name,
		unsigned int	width,
		unsigned int	height,
		unsigned int	multiSampleCount,
		MHWRender::MRasterFormat	rasterFormat,
		unsigned int	arraySliceCount,
		bool	isCubeMap
	)

Constructor for a render target description.

The basic description of a 2 dimensional (2D) target is the width, height, the sample count, and the raster format.

Cube maps, and generalized arrays of targets can be specified by providing an array (slice) count which is greater than zero. A "slice" is logically equivalent to a 2D render target.
If multiple slices are specified, then an additional flag is required to distinguish between a general array of 2D targets and a one which forms a cube map.

Parameters:

[in]	name	Name of the target description
[in]	width	Width in pixels
[in]	height	Height in pixels
[in]	multiSampleCount	Number of samples for a multisampled anti-aliased (MSAA) target. A value of 1 indicates no multisampling.
[in]	rasterFormat	Raster / pixel format of the target.
[in]	arraySliceCount	The number of array slices. A value of 1 means a single 2D target.
[in]	isCubeMap	A true value indicates that the target is a cube map. In this case the arraySliceCount is set to be 6 in the constructor. The argument is ignored if the number of array slices is not equal to 6.

Member Function Documentation

const MString & name ( ) const

Search for all occurrences

Query the name identifier for the target description.

Returns:: Identifier name

unsigned int width ( ) const

Search for all occurrences

Query the width of a 2D render target slice.

Returns:: Width value

unsigned int height ( ) const

Search for all occurrences

Query the height of a 2D render target slice.

Returns:: Height value

unsigned int multiSampleCount ( ) const

Search for all occurrences

Query the multi-sample count defined by the description.

Returns:: Sample value

MRasterFormat rasterFormat ( ) const

Search for all occurrences

Query the raster format defined by the description.

Returns:: The raster format.

unsigned int arraySliceCount ( ) const

Search for all occurrences

Query the number of array slices defined by the description.

Returns:: The slice count

bool isCubeMap ( ) const

Search for all occurrences

Query whether this is a cube map target.

Returns:: True if the target describes a cubemap.

bool allowsUnorderedAccess ( ) const

Search for all occurrences

Query whether unordered access is supported.

Refer to the MRenderTargetDescription::setAllowsUnorderedAccess() method for more details about the meaning of "unordered access".

Returns:: True if supported

void setName ( const MString & name )

Search for all occurrences

Set name of the target.

Parameters:

[in] name Name to set.

void setWidth ( unsigned int val )

Search for all occurrences

Set width of the target.

Parameters:

[in] val Width to set.

void setHeight ( unsigned int val )

Search for all occurrences

Set height of the target.

Parameters:

[in] val Height to set.

void setMultiSampleCount ( unsigned int val )

Search for all occurrences

Set multisample count of the target.

Parameters:

[in] val Sample count to set.

void setRasterFormat ( MHWRender::MRasterFormat val )

Search for all occurrences

Set the raster format of the target.

Parameters:

[in] val Format to set.

void setArraySliceCount ( unsigned int val )

Search for all occurrences

Set array slice count of the target.

Parameters:

[in] val Slice count to set.

void setIsCubeMap ( bool val )

Search for all occurrences

Set cube map flag for the target.

Parameters:

[in] val Cube map flag to set.

void setAllowsUnorderedAccess ( bool val )

Search for all occurrences

Set the flag for unordered data access for the target.

This indicates that read and write access to the target's data from multiple threads is supported. For example, this allows pixel and compute shaders running in parallel to have the same unordered access targets bound.

Parameters:

[in] val Value to set

bool compatibleWithDescription ( const MRenderTargetDescription & desc )

Search for all occurrences

Determine if another target with a given description is 'compatible' with a target using this description.

Compatibility implies that the targets can be used together when specifying multiple render targets.

The general minimum requirements are that the dimensions and multisampling properties are identical. Neither target can be a depth target.

Parameters:

[in] desc Description to compare with

Returns:: false if incompatible.

MRenderTargetDescription Class ReferenceOpenMayaRender - API module for rendering

Detailed Description

Public Member Functions

Constructor & Destructor Documentation

Member Function Documentation

MRenderTargetDescription Class Reference
OpenMayaRender - API module for rendering