MShaderInstance Class Reference

Search for all occurrences

---

Detailed Description

An instance of a shader that may be used with Viewport 2.0.

This class represents a shader that may be used with the MRenderItem class for rendering in Viewport 2.0.

#include <MShaderManager.h>

List of all members.

Public Types
enum	ParameterType {   kInvalid, kBoolean, kInteger, kFloat,   kFloat2, kFloat3, kFloat4, kFloat4x4Row,   kFloat4x4Col, kTexture1, kTexture2, kTexture3,   kTextureCube, kSampler }
	Specifies parameter types. More...
typedef void(*	DrawCallback )(MDrawContext &context, const MRenderItem *renderItem)
	Pre-draw callback function pointer.
Public Member Functions Search for all occurrences
	~MShaderInstance ()
	Destructor.
DrawCallback	preDrawCallback () const
	Access the pre-draw callback function pointer set for the this shader instance.
DrawCallback	postDrawCallback () const
	Access the post-draw callback function pointer set for the this shader instance.
void	parameterList (MStringArray &list) const
	Get the names of all parameters that are settable on this shader instance.
ParameterType	parameterType (const MString &parameterName) const
	Get the type of the named parameter, returns kInvalid if parameter is not found.
bool	isArrayParameter (const MString &parameterName) const
	Determine whether the named parameter is an array.
MStatus	setParameter (const MString &parameterName, bool value)
	Set a named, boolean parameter on the shader instance.
MStatus	setParameter (const MString &parameterName, int value)
	Set a named, integer parameter on the shader instance.
MStatus	setParameter (const MString &parameterName, float value)
	Set a named, float parameter on the shader instance.
MStatus	setParameter (const MString &parameterName, const float *value)
	Set a named, float2, float3 or float4 parameter on the shader instance.
MStatus	setParameter (const MString &parameterName, const MMatrix &value)
	Set a named, matrix parameter on the shader instance.
MStatus	setParameter (const MString &parameterName, MTextureAssignment &textureAssignment)
	Set a texture parameter on the shader instance.
MStatus	setParameter (const MString &parameterName, MRenderTargetAssignment &targetAssignment)
	Set a named, texture parameter on the shader instance to a render target.
MStatus	setParameter (const MString &parameterName, const MSamplerState &sampler)
	Set a sampler parameter on the shader instance.
MStatus	setArrayParameter (const MString &parameterName, const bool *values, unsigned int count)
	Set a named, bool array parameter on the shader instance.
MStatus	setArrayParameter (const MString &parameterName, const int *values, unsigned int count)
	Set a named, integer array parameter on the shader instance.
MStatus	setArrayParameter (const MString &parameterName, const float *values, unsigned int count)
	Set a named, float array parameter on the shader instance.
MStatus	setArrayParameter (const MString &parameterName, const MMatrix *values, unsigned int count)
	Set a named, matrix array parameter on the shader instance.
Static Public Member Functions
static const char *	className ()
	Returns the name of this class.

---

Member Enumeration Documentation

enum ParameterType

Search for all occurrences

Specifies parameter types.

Enumerator:

kInvalid	Invalid element type (default value) Search for all occurrences
kBoolean	Boolean. Search for all occurrences
kInteger	Signed 32-bit integer. Search for all occurrences
kFloat	IEEE single precision floating point. Search for all occurrences
kFloat2	IEEE single precision floating point (x2) Search for all occurrences
kFloat3	IEEE single precision floating point (x3) Search for all occurrences
kFloat4	IEEE single precision floating point (x4) Search for all occurrences
kFloat4x4Row	IEEE single precision floating point row-major matrix (4x4) Search for all occurrences
kFloat4x4Col	IEEE single precision floating point column-major matrix (4x4) Search for all occurrences
kTexture1	1D texture Search for all occurrences
kTexture2	2D texture Search for all occurrences
kTexture3	3D texture Search for all occurrences
kTextureCube	Cube texture. Search for all occurrences
kSampler	Sampler. Search for all occurrences

---

Member Function Documentation

MShaderInstance::DrawCallback preDrawCallback

(

)

const

Search for all occurrences

Access the pre-draw callback function pointer set for the this shader instance.

Returns:

The pre-draw callback function pointer or NULL if not set

MShaderInstance::DrawCallback postDrawCallback

(

)

const

Search for all occurrences

Access the post-draw callback function pointer set for the this shader instance.

Returns:

The post-draw callback function pointer or NULL if not set

void parameterList

(

MStringArray &

list

)

const

Search for all occurrences

Get the names of all parameters that are settable on this shader instance.

Parameters:

[out]

list

The list to populate parameter names

MShaderInstance::ParameterType parameterType

(

const MString &

parameterName

)

const

Search for all occurrences

Get the type of the named parameter, returns kInvalid if parameter is not found.

Parameters:

[in]

parameterName

Name of the parameter to query

Returns:

The type of the named parameter

bool isArrayParameter

(

const MString &

parameterName

)

const

Search for all occurrences

Determine whether the named parameter is an array.

Parameters:

[in]

parameterName

Name of the parameter to query

Returns:

True if the named parameter is an array

MStatus setParameter	(	const MString &	parameterName,
		bool	value
	)

Search for all occurrences

Set a named, boolean parameter on the shader instance.

Parameters:

[in]	parameterName	Name of the parameter to set
[in]	value	Value of the parameter

Returns:

Status code

Status Codes:

• MS::kSuccess The parameter was set.
• MS::kInvalidParameter The named parameter is not a boolean parameter.
• MS::kUnknownParameter The named parameter is not a parameter of the shader instance.
• MS::kFailure An internal error prevented the parameter from being set.

MStatus setParameter	(	const MString &	parameterName,
		int	value
	)

Search for all occurrences

Set a named, integer parameter on the shader instance.

Parameters:

[in]	parameterName	Name of the parameter to set
[in]	value	Value of the parameter

Returns:

Status code

Status Codes:

• MS::kSuccess The parameter was set.
• MS::kInvalidParameter The named parameter is not an integer parameter.
• MS::kUnknownParameter The named parameter is not a parameter of the shader instance.
• MS::kFailure An internal error prevented the parameter from being set.

MStatus setParameter	(	const MString &	parameterName,
		float	value
	)

Search for all occurrences

Set a named, float parameter on the shader instance.

Parameters:

[in]	parameterName	Name of the parameter to set
[in]	value	Value of the parameter

Returns:

Status code

Status Codes:

• MS::kSuccess The parameter was set.
• MS::kInvalidParameter The named parameter is not a float parameter.
• MS::kUnknownParameter The named parameter is not a parameter of the shader instance.
• MS::kFailure An internal error prevented the parameter from being set.

MStatus setParameter	(	const MString &	parameterName,
		const float *	value
	)

Search for all occurrences

Set a named, float2, float3 or float4 parameter on the shader instance.

The floating point data stored in "value" will be interpreted based on the type of the named parameter. For example, for a parameter of type kFloat3, the data will be assumed to be an array containing three floats.

Parameters:

[in]	parameterName	Name of the parameter to set
[in]	value	Value of the parameter

Returns:

Status code

Status Codes:

• MS::kSuccess The parameter was set.
• MS::kInvalidParameter The named parameter is not a compound float parameter.
• MS::kUnknownParameter The named parameter is not a parameter of the shader instance.
• MS::kFailure An internal error prevented the parameter from being set.

MStatus setParameter	(	const MString &	parameterName,
		const MMatrix &	value
	)

Search for all occurrences

Set a named, matrix parameter on the shader instance.

Note that this method does not alter the matrix and it is up to the caller to set the values correctly depending on whether the parameter is row-major or column-major.

Parameters:

[in]	parameterName	Name of the parameter to set
[in]	value	Value of the parameter

Returns:

Status code

Status Codes:

• MS::kSuccess The parameter was set.
• MS::kInvalidParameter The named parameter is not a matrix parameter.
• MS::kUnknownParameter The named parameter is not a parameter of the shader instance.
• MS::kFailure An internal error prevented the parameter from being set.

MStatus setParameter	(	const MString &	parameterName,
		MTextureAssignment &	textureAssignment
	)

Search for all occurrences

Set a texture parameter on the shader instance.

If the texture assignment contains a NULL value for texture then the shader parameter will be set to NULL.

Parameters:

[in]	parameterName	Name of the parameter to set
[in]	textureAssignment	Texture to assign

Returns:

Status code

Status Codes:

• MS::kSuccess The parameter was set.
• MS::kInvalidParameter The named parameter is not a texture parameter.
• MS::kUnknownParameter The named parameter is not a parameter of the shader instance.
• MS::kFailure An internal error prevented the parameter from being set.

MStatus setParameter	(	const MString &	parameterName,
		MRenderTargetAssignment &	targetAssignment
	)

Search for all occurrences

Set a named, texture parameter on the shader instance to a render target.

If the render target assignment contains a NULL value then the shader parameter will be set to NULL.

Note, there is a significant performance penalty when binding MSAA targets (i.e. targets where multiSampleCount > 1).

Parameters:

[in]	parameterName	Name of the parameter to set
[in]	targetAssignment	Render target to assign

Returns:

Status code

Status Codes:

• MS::kSuccess The parameter was set.
• MS::kInvalidParameter The named parameter is not a texture parameter.
• MS::kUnknownParameter The named parameter is not a parameter of the shader instance.
• MS::kFailure An internal error prevented the parameter from being set.

MStatus setParameter	(	const MString &	parameterName,
		const MSamplerState &	sampler
	)

Search for all occurrences

Set a sampler parameter on the shader instance.

Parameters:

[in]	parameterName	Name of the parameter to set
[in]	sampler	Sampler state to assign

Returns:

Status code

Status Codes:

• MS::kSuccess The parameter was set.
• MS::kInvalidParameter The named parameter is not a sampler parameter.
• MS::kUnknownParameter The named parameter is not a parameter of the shader instance.
• MS::kFailure An internal error prevented the parameter from being set.

MStatus setArrayParameter	(	const MString &	parameterName,
		const bool *	values,
		unsigned int	count
	)

Search for all occurrences

Set a named, bool array parameter on the shader instance.

Parameters:

[in]	parameterName	Name of the parameter to set
[in]	values	The array of values to set
[in]	count	The number of values in the array

Returns:

Status code

Status Codes:

• MS::kSuccess The parameter was set.
• MS::kInvalidParameter The named parameter is not a bool array parameter or count is out of bounds.
• MS::kUnknownParameter The named parameter is not a parameter of the shader instance.
• MS::kFailure An internal error prevented the parameter from being set.

MStatus setArrayParameter	(	const MString &	parameterName,
		const int *	values,
		unsigned int	count
	)

Search for all occurrences

Set a named, integer array parameter on the shader instance.

Parameters:

[in]	parameterName	Name of the parameter to set
[in]	values	The array of values to set
[in]	count	The number of values in the array

Returns:

Status code

Status Codes:

• MS::kSuccess The parameter was set.
• MS::kInvalidParameter The named parameter is not an integer array parameter or count is out of bounds.
• MS::kUnknownParameter The named parameter is not a parameter of the shader instance.
• MS::kFailure An internal error prevented the parameter from being set.

MStatus setArrayParameter	(	const MString &	parameterName,
		const float *	values,
		unsigned int	count
	)

Search for all occurrences

Set a named, float array parameter on the shader instance.

This method is used for setting not just float arrays but float2, float3 and float4 array parameters as well. The floating point data stored in "values" will be interpreted based on the type of the named parameter. For example, for a parameter of type kFloat3, the data will be assumed to be a list of float-triples containing a total of "count" float-triples. So if "count" in this example is 5, that means the total number of raw floats is 3*5=15.

Parameters:

[in]	parameterName	Name of the parameter to set
[in]	values	The array of values to set
[in]	count	The number of floats stored in the array divided by the dimension of the data

Returns:

Status code

Status Codes:

• MS::kSuccess The parameter was set.
• MS::kInvalidParameter The named parameter is not a float array parameter or count is out of bounds.
• MS::kUnknownParameter The named parameter is not a parameter of the shader instance.
• MS::kFailure An internal error prevented the parameter from being set.

MStatus setArrayParameter	(	const MString &	parameterName,
		const MMatrix *	values,
		unsigned int	count
	)

Search for all occurrences

Set a named, matrix array parameter on the shader instance.

Note that this method does not alter the matrices and it is up to the caller to set the values correctly depending on whether the parameter is row-major or column-major.

Parameters:

[in]	parameterName	Name of the parameter to set
[in]	values	The array of values to set
[in]	count	The number of values in the array

Returns:

Status code

Status Codes:

• MS::kSuccess The parameter was set.
• MS::kInvalidParameter The named parameter is not a matrix array parameter or count is out of bounds.
• MS::kUnknownParameter The named parameter is not a parameter of the shader instance.
• MS::kFailure An internal error prevented the parameter from being set.

const char * className

(

)

[static]

Search for all occurrences

Returns the name of this class.

Returns:

Name of this class.