If a supported 2d texture (see hasValidDynamics2dTexture() method documentation) is connected to the specified attribute, this method can be called to evaluate that texture at a number of (u,v) texture coordinate values. More...
Certain aspects of Maya's dynamics can be textured using 2d textures.
For example, surface particle emitters can use a 2d texture to modulate the emission rate over the surface. For these purposes, only a subset of Maya's textures are supported, namely the default 2d textures (bulge, checker, cloth, file, fluid texture 2d, fractal, grid, mountain, movie, noise, ocean, ramp, water). No other nodes are supported. This method takes an attribute and determines if there is a supported texture connected to it. If the texture is supported, then the evalDynamics2dTexture() method can be called to evaluate the texture at various (u,v) coordinate values.
Parameters
[in]
node
node to be tested for a valid texture connection.
[in]
texAttr
attribute to be tested for a valid texture connection.
[out]
status
status code.
Status Codes:
MS::kSuccess The connected texture was successfully examined.
MS::kUnknownParameter There was no node connected to the specified attribute.
Returns
true if the node connected to the specified attribute is a texture that can be evaluated using the evalDynamics2dTexture() method, false otherwise.
If a supported 2d texture (see hasValidDynamics2dTexture() method documentation) is connected to the specified attribute, this method can be called to evaluate that texture at a number of (u,v) texture coordinate values.
Parameters
[in]
node
node whose connected texture is to be evaluated.
[in]
texAttr
attribute whose connected texture is to be evaluated.
[in]
uCoords
array of u coordinate values
[in]
vCoords
array of v coordinate values
[out]
resultColors
if non-NULL, receives the result of the connected texture's outColor attribute, evaluated at all the (u,v) coordinates given by the uCoords and vCoords arrays.
[out]
resultAlphas
if non-NULL, receives the outAlpha values evaluated from the texture at these same points.
Status Codes:
MS::kSuccess The connected texture was successfully evaluated
MS::kUnknownParameter There was no texture, or an unsupported texture connected to the specified attribute, so textured values could not be evaluated.
Add this node to the list of nodes participating in runup.
The node should respond to timeChanged and delayedTimeChangedRunup messages, or have a forceDynamics attribute. The node should have lastEvalTime and lastCacheTime attributes to determine whether runup is needed. Optionally the node may have a boolean checkForRunup attribute that when false will fully disable runup checking.
Parameters
[in]
nodeTypeName
node type to be included in runup.
Returns
true if the node was added to the list, false if it was already on the list