MPxParticleAttributeMapperNode Class Reference
[OpenMayaFX - API module for effects, Proxy classes]

#include <MPxParticleAttributeMapperNode.h>

Inheritance diagram for MPxParticleAttributeMapperNode:

[legend]

Collaboration diagram for MPxParticleAttributeMapperNode:

[legend]

List of all members.

---

Detailed Description

User defined per particle attribute mapping nodes.

MPxParticleAttributeMapperNode is the parent class of all user defined per particle attribute mapping nodes. This class extends Maya's internal 'arrayMapper' node, inheriting its attributes and default behaviour.

Examples:

particleAttrNode.h.

Public Member Functions
	MPxParticleAttributeMapperNode ()
virtual	~MPxParticleAttributeMapperNode ()
virtual MPxNode::Type	type () const
virtual MStatus	compute (const MPlug &plug, MDataBlock &dataBlock)
Static Public Attributes
static MObject	computeNode
	Input node used to compute output values.
static MObject	uCoordPP
	The U component of an array of sample positions.
static MObject	vCoordPP
	The V component of an array of sample positions.
static MObject	outMinValue
	The minimum limit on the output attribute outValuePP.
static MObject	outMaxValue
	The maximum limit on the output attribute outValuePP.
static MObject	computeNodeColor
	This attribute allows the propagation of any changes to the.
static MObject	computeNodeColorR
	The R component of the computeNodeColor.
static MObject	computeNodeColorG
	The G component of the computeNodeColor.
static MObject	computeNodeColorB
	The B component of the computeNodeColor.
static MObject	time
	This attribute holds the value for time (in seconds).
static MObject	outColorPP
	The outputColor vector per-particle attribute.
static MObject	outValuePP
	The outputValue vector per-particle attribute.

---

Constructor & Destructor Documentation

MPxParticleAttributeMapperNode::MPxParticleAttributeMapperNode

(

)

Class constructor.

Any calls the MPxParticleAttributeMapperNode methods must be done in the postConstructor method and not here.

MPxParticleAttributeMapperNode::~MPxParticleAttributeMapperNode

(

)

[virtual]

Class destructor.

---

Member Function Documentation

MPxNode::Type MPxParticleAttributeMapperNode::type

(

)

const [virtual]

Returns the type of node that this is. This is used to differentiate user defined nodes that are derived off different MPx base classes.

It is not necessary to override this method.

Returns:

Type of the node (MPxNode::kDependNode)

Reimplemented from MPxNode.

MStatus MPxParticleAttributeMapperNode::compute	(	const MPlug &	plug,
		MDataBlock &	dataBlock
	)			[virtual]

This method should be overridden in user defined nodes.

Recompute the given output based on the nodes inputs. The plug represents the data value that needs to be recomputed, and the data block holds the storage for all of the node's attributes.

The MDataBlock will provide smart handles for reading and writing this node's attribute values. Only these values should be used when performing computations.

When evaluating the dependency graph, Maya will first call the compute method for this node. If the plug that is provided to the compute indicates that that the attribute was defined by the Maya parent node, the compute method should return MS::kUnknownParameter. When this occurs, Maya will call the internal Maya node from which the user-defined node is derived to compute the plug's value.

This means that a user defined node does not need to be concerned with computing inherited output attributes. However, if desired, these can be safely recomputed by this method to change the behaviour of the node.

Parameters:

[in]	plug	plug representing the attribute that needs to be recomputed
[in]	dataBlock	data block containing storage for the node's attributes

Returns:

Status code

Status Codes:

• MS::kSuccess Compute was successful
• MS::kFailure Compute failed

Reimplemented from MPxNode.

Examples:

particleAttrNode.h.