C++ API Reference
Public Member Functions | Static Public Member Functions | List of all members
MDataBlock Class Reference
OpenMaya - API module for common classes

Dependency node data block. More...

#include <MDataBlock.h>

Public Member Functions

 MDataBlock (const MDataBlock &in)
 The class default copy constructor.
 
virtual ~MDataBlock ()
 The class destructor.
 
MDataHandle inputValue (const MPlug &plug, MStatus *ReturnStatus=NULL)
 Gets a handle to this data block for the given plug's data. More...
 
MDataHandle inputValue (const MObject &attribute, MStatus *ReturnStatus=NULL)
 Gets a handle to this data block for the given attribute's data. More...
 
MDataHandle outputValue (const MPlug &plug, MStatus *ReturnStatus=NULL)
 Gets a handle to this data block for the given plug's data. More...
 
MDataHandle outputValue (const MObject &attribute, MStatus *ReturnStatus=NULL)
 Gets a handle to this data block for the given attribute's data. More...
 
MArrayDataHandle inputArrayValue (const MPlug &plug, MStatus *ReturnStatus=NULL)
 Gets an array handle to this data block for the given plug's data. More...
 
MArrayDataHandle inputArrayValue (const MObject &attribute, MStatus *ReturnStatus=NULL)
 Gets an array handle to this data block for the given attribute's data. More...
 
MArrayDataHandle outputArrayValue (const MPlug &plug, MStatus *ReturnStatus=NULL)
 Gets a handle to this data block for the given plug. More...
 
MArrayDataHandle outputArrayValue (const MObject &attribute, MStatus *ReturnStatus=NULL)
 Gets a handle to this data block for the given attribute's data. More...
 
MStatus setClean (const MPlug &plug)
 Tells the dependency graph that the given plug has been updated and is now clean. More...
 
MStatus setClean (const MObject &attribute)
 Tells the dependency graph that the given attribute has been updated and is now clean. More...
 
bool isClean (const MPlug &plug)
 Queries the dependency graph to see whether the given plug is clean. More...
 
bool isClean (const MObject &attribute, MStatus *ReturnStatus=NULL)
 Queries the dependency graph to see whether the given attribute is clean. More...
 
MDGContext context (MStatus *ReturnStatus=NULL)
 Returns a copy of the dependecy graph context for which this data block was created. More...
 
MStatus setContext (const MDGContext &ctx)
 Set the dependency graph context for this data block. More...
 

Static Public Member Functions

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

Detailed Description

Dependency node data block.

An MDataBlock provides storage for the data being received by or sent by the node. It is the data for the plugs and attributes of the node. The data block is only valid during the compute method of the depend node. Pointers to the data block should not be retained after the compute method.

Access to the data in an MDataBlock is done using an MDataHandle or an MArrayDataHandle.

Examples:
AbcImport/AlembicNode.cpp, AbcImport/AlembicNode.h, affectsNode/affectsNode.cpp, animCubeNode/animCubeNode.cpp, anisotropicShader/anisotropicShader.cpp, apiDirectionalLightShape/apiDirectionalLightShape.cpp, apiDirectionalLightShape/apiDirectionalLightShape.h, apiMeshShape/apiMeshCreator.cpp, apiMeshShape/apiMeshCreator.h, apiMeshShape/apiMeshShape.cpp, apiMeshShape/apiMeshShape.h, arcLenNode/arcLenNode.cpp, backfillShader/backfillShader.cpp, basicBlendShape/basicBlendShape.cpp, basicBlendShapeDeformer/basicBlendShapeDeformer.cpp, basicMorphNode/basicMorphNode.cpp, basicSkinCluster/basicSkinCluster.cpp, blindDataShader/blindDataMesh.cpp, blindDataShader/blindDataMesh.h, blindDataShader/blindDataShader.cpp, blindDataShader/blindDataShader.h, brickShader/brickShader.cpp, buildRotationNode/buildRotationNode.cpp, cellShader/cellShader.cpp, cgFx/cgfxShaderNode.cpp, cgFx/cgfxShaderNode.h, cgFx/cgfxVector.cpp, cgFx/cgfxVector.h, checkerShader/checkerShader.cpp, circleNode/circleNode.cpp, clearcoat.cpp, closestPointOnCurve/closestPointOnCurveNode.cpp, closestPointOnCurve/closestPointOnCurveNode.h, compositingShader/compositingShader.cpp, constraintEvaluator/constraintEvaluator.cpp, contrastShader/contrastShader.cpp, customComponentTagNode/customComponentTagNode.cpp, cvColorNode/cvColorNode.cpp, depthShader/depthShader.cpp, displacementShader/displacementShader.cpp, dx11Shader/dx11ConeAngleToHotspotConverter.cpp, dx11Shader/dx11ConeAngleToHotspotConverter.h, dynExprField/dynExprField.cpp, dynExprField/dynExprField.h, exampleFalloff/smoothFalloffNode.cpp, exampleFalloff/smoothFalloffNode.h, exampleRampAttribute/exampleMRampAttribute.cpp, fileTexture/fileTexture.cpp, flameShader/flameShader.cpp, footPrintManip/footPrintManip.cpp, footPrintNode/footPrintNode.cpp, footPrintNode_AnimatedMaterial/footPrintNode_GeometryOverride_AnimatedMaterial.cpp, footPrintNode_GeometryOverride/footPrintNode_GeometryOverride.cpp, footPrintNode_SubSceneOverride/footPrintNode_SubSceneOverride.cpp, fullLoftNode/fullLoftNode.cpp, gameInputDevice/gameInputDevice.cpp, gammaShader/gammaShader.cpp, genericAttributeNode/genericAttributeNode.cpp, geometrySurfaceConstraint/geometrySurfaceConstraint.cpp, geometrySurfaceConstraint/geometrySurfaceConstraint.h, geometrytools.cpp, geomShader/geomShader.cpp, hwPhongShader/hwPhongShader.cpp, hwPhongShader/hwPhongShader.h, identityGeomFilter/identityGeomFilter.cpp, identityNode/identityNode.cpp, interpShader/interpShader.cpp, jitterNode/jitterNode.cpp, lambertShader/lambertShader.cpp, latticeNoise/latticeNoise.h, latticeNoise/latticeNoiseNode.cpp, lavaShader/lavaShader.cpp, lightShader/lightShader.cpp, manipOverride/rockingTransform2.cpp, meshOpCmd/meshOpNode.cpp, meshOpCmd/meshOpNode.h, MetadataSample/tweakMetadataNode.cpp, MetadataSample/tweakMetadataNode.h, mixtureShader/mixtureShader.cpp, motionPathNode/motionPathNode.cpp, multiCurveNode/multiCurveNode.cpp, noiseShader/noiseShader.cpp, offsetNode/offsetNode.cpp, onbShader/onbShader.cpp, ownerEmitter/ownerEmitter.cpp, ownerEmitter/ownerEmitter.h, particleAttrNode/particleAttrNode.cpp, particleAttrNode/particleAttrNode.h, phongShader/phongShader.cpp, pointOnMeshInfo/pointOnMeshInfoNode.cpp, pointOnMeshInfo/pointOnMeshInfoNode.h, pointOnSubdNode/pointOnSubdNode.cpp, pointOnSubdNode/pointOnSubdNode.h, polyTrgNode/polyTrgNode.cpp, randomizerDevice/randomizerDevice.cpp, rawfootPrintNode/rawfootPrintNode.cpp, renderAccessNode/renderAccessNode.cpp, rockingTransform/rockingTransform.cpp, rockingTransform/rockingTransform.h, rockingTransformCheck/rockingTransform.cpp, rockingTransformCheck/rockingTransform.h, rockingTransformCheck/rockingTransformCheck.cpp, rockingTransformCheck/rockingTransformCheck.h, shadowMatteShader/shadowMatteShader.cpp, shellNode/shellNode.cpp, shiftNode/shiftNode.cpp, simpleEmitter/simpleEmitter.cpp, simpleEmitter/simpleEmitter.h, simpleEvaluationDraw/simpleEvaluationDraw.cpp, simpleEvaluationNode/simpleEvaluationNode.cpp, simpleFluidEmitter/simpleFluidEmitter.cpp, simpleFluidEmitter/simpleFluidEmitter.h, simpleLoftNode/simpleLoftNode.cpp, simpleNoiseShader/simpleNoiseShader.cpp, simplePhysicsEngine/simplePhysicsEngine.cpp, simpleSimulationNode/simpleSimulationNode.cpp, simpleSkipNode/simpleSkipNode.cpp, simpleSpring/simpleSpring.cpp, simpleSpring/simpleSpring.h, sineNode/sineNode.cpp, slopeShader/slopeShaderNode.cpp, slopeShader/slopeShaderNode.h, solidCheckerShader/solidCheckerShader.cpp, splatDeformer/splatDeformer.cpp, splitUVCmd/splitUVNode.cpp, splitUVCmd/splitUVNode.h, squaresNode_noDepthTest/squaresNode_noDepthTest.cpp, sseDeformer/sseDeformer.cpp, stringFormatNode/stringFormatNode.cpp, sweptEmitter/sweptEmitter.cpp, sweptEmitter/sweptEmitter.h, swissArmyManip/swissArmyManip.cpp, testMTopologyEvaluator/testMTopologyEvaluator.cpp, testMTopologyEvaluator/testMTopologyEvaluator.h, testNobjectNode/testNobjectNode.cpp, testNobjectNode/testNobjectNode.h, testNpassiveNode/testNpassiveNode.cpp, testNpassiveNode/testNpassiveNode.h, testNsolverNode/testNsolverNode.cpp, testNsolverNode/testNsolverNode.h, testNucleusNode/testNucleusNode.cpp, testNucleusNode/testNucleusNode.h, topologyTrackingNode/topologyTrackingNode.cpp, torusField/torusField.cpp, torusField/torusField.h, transCircleNode/transCircleNode.cpp, udpDevice/udpDevice.cpp, volumeShader/volumeShader.cpp, vp2BlinnShader/vp2BlinnShader.cpp, vp2BlinnShader/vp2BlinnShader.h, weightListNode/weightListNode.cpp, and yTwistNode/yTwistNode.cpp.

Member Function Documentation

MDataHandle inputValue ( const MPlug &  plug,
MStatus *  ReturnStatus = NULL 
)

Gets a handle to this data block for the given plug's data.

The data represented by the handle is guaranteed to be valid for reading. If the data is from a dirty connection, then the connection will be evaluated. If no connection is present, then the value that the plug has been set to will be returned. If the plug has not been set to a particular value, then the default value will be returned.

Parameters
[in]plugthe plug whose data you wish to access
[out]ReturnStatusthe return status
Returns
Data handle for the given plug's data
Status Codes:
  • MS::kSuccess operation successful
Examples:
AbcImport/AlembicNode.cpp, affectsNode/affectsNode.cpp, animCubeNode/animCubeNode.cpp, anisotropicShader/anisotropicShader.cpp, apiDirectionalLightShape/apiDirectionalLightShape.cpp, apiMeshShape/apiMeshCreator.cpp, apiMeshShape/apiMeshShape.cpp, arcLenNode/arcLenNode.cpp, backfillShader/backfillShader.cpp, basicBlendShapeDeformer/basicBlendShapeDeformer.cpp, basicMorphNode/basicMorphNode.cpp, blindDataShader/blindDataMesh.cpp, brickShader/brickShader.cpp, buildRotationNode/buildRotationNode.cpp, cellShader/cellShader.cpp, cgFx/cgfxVector.cpp, checkerShader/checkerShader.cpp, circleNode/circleNode.cpp, clearcoat.cpp, closestPointOnCurve/closestPointOnCurveNode.cpp, compositingShader/compositingShader.cpp, contrastShader/contrastShader.cpp, customComponentTagNode/customComponentTagNode.cpp, cvColorNode/cvColorNode.cpp, depthShader/depthShader.cpp, displacementShader/displacementShader.cpp, dx11Shader/dx11ConeAngleToHotspotConverter.cpp, dynExprField/dynExprField.cpp, exampleFalloff/smoothFalloffNode.cpp, fileTexture/fileTexture.cpp, flameShader/flameShader.cpp, footPrintNode_AnimatedMaterial/footPrintNode_GeometryOverride_AnimatedMaterial.cpp, footPrintNode_GeometryOverride/footPrintNode_GeometryOverride.cpp, gameInputDevice/gameInputDevice.cpp, gammaShader/gammaShader.cpp, genericAttributeNode/genericAttributeNode.cpp, geometrySurfaceConstraint/geometrySurfaceConstraint.cpp, geometrytools.cpp, geomShader/geomShader.cpp, hwPhongShader/hwPhongShader.cpp, interpShader/interpShader.cpp, jitterNode/jitterNode.cpp, lambertShader/lambertShader.cpp, latticeNoise/latticeNoiseNode.cpp, lavaShader/lavaShader.cpp, lightShader/lightShader.cpp, meshOpCmd/meshOpNode.cpp, MetadataSample/tweakMetadataNode.cpp, mixtureShader/mixtureShader.cpp, motionPathNode/motionPathNode.cpp, multiCurveNode/multiCurveNode.cpp, noiseShader/noiseShader.cpp, offsetNode/offsetNode.cpp, onbShader/onbShader.cpp, ownerEmitter/ownerEmitter.cpp, ownerEmitter/ownerEmitter.h, particleAttrNode/particleAttrNode.cpp, phongShader/phongShader.cpp, pointOnMeshInfo/pointOnMeshInfoNode.cpp, pointOnSubdNode/pointOnSubdNode.cpp, rockingTransform/rockingTransform.cpp, rockingTransformCheck/rockingTransform.cpp, shadowMatteShader/shadowMatteShader.cpp, shiftNode/shiftNode.cpp, simpleEmitter/simpleEmitter.cpp, simpleEmitter/simpleEmitter.h, simpleEvaluationDraw/simpleEvaluationDraw.cpp, simpleEvaluationNode/simpleEvaluationNode.cpp, simpleFluidEmitter/simpleFluidEmitter.cpp, simpleLoftNode/simpleLoftNode.cpp, simpleNoiseShader/simpleNoiseShader.cpp, simpleSimulationNode/simpleSimulationNode.cpp, simpleSkipNode/simpleSkipNode.cpp, simpleSpring/simpleSpring.h, sineNode/sineNode.cpp, slopeShader/slopeShaderNode.cpp, solidCheckerShader/solidCheckerShader.cpp, splatDeformer/splatDeformer.cpp, splitUVCmd/splitUVNode.cpp, sseDeformer/sseDeformer.cpp, stringFormatNode/stringFormatNode.cpp, sweptEmitter/sweptEmitter.cpp, sweptEmitter/sweptEmitter.h, testMTopologyEvaluator/testMTopologyEvaluator.cpp, testNobjectNode/testNobjectNode.cpp, testNpassiveNode/testNpassiveNode.cpp, testNsolverNode/testNsolverNode.cpp, testNucleusNode/testNucleusNode.cpp, topologyTrackingNode/topologyTrackingNode.cpp, torusField/torusField.cpp, torusField/torusField.h, transCircleNode/transCircleNode.cpp, volumeShader/volumeShader.cpp, vp2BlinnShader/vp2BlinnShader.cpp, and yTwistNode/yTwistNode.cpp.
MDataHandle inputValue ( const MObject &  attribute,
MStatus *  ReturnStatus = NULL 
)

Gets a handle to this data block for the given attribute's data.

The data represented by the handle is guaranteed to be valid for reading. If the data is from a dirty connection, then the connection will be evaluated. If no connection is present, then the value that the attribute has been set to will be returned. If the attribute has not been set to a particular value, then the default value will be returned.

Parameters
[in]attributethe attribute of the node that you want to access
[out]ReturnStatusthe return status
Returns
Data handle for the given attribute's data
Status Codes:
  • MS::kSuccess operation successful
  • MS::kInvalidParameter object argument is invalid
MDataHandle outputValue ( const MPlug &  plug,
MStatus *  ReturnStatus = NULL 
)

Gets a handle to this data block for the given plug's data.

The data is not guaranteed to be valid. No dependency graph evaluations will be done. Therefore, this handle should be used only for writing.

Parameters
[in]plugthe plug whose data you wish to access
[out]ReturnStatusthe return status
Returns
Data handle for the given plug's data
Status Codes:
  • MS::kSuccess operation successful
Examples:
AbcImport/AlembicNode.cpp, affectsNode/affectsNode.cpp, animCubeNode/animCubeNode.cpp, anisotropicShader/anisotropicShader.cpp, apiDirectionalLightShape/apiDirectionalLightShape.cpp, apiMeshShape/apiMeshShape.cpp, arcLenNode/arcLenNode.cpp, backfillShader/backfillShader.cpp, blindDataShader/blindDataMesh.cpp, blindDataShader/blindDataShader.cpp, brickShader/brickShader.cpp, buildRotationNode/buildRotationNode.cpp, cellShader/cellShader.cpp, cgFx/cgfxShaderNode.cpp, cgFx/cgfxVector.cpp, checkerShader/checkerShader.cpp, circleNode/circleNode.cpp, clearcoat.cpp, closestPointOnCurve/closestPointOnCurveNode.cpp, compositingShader/compositingShader.cpp, constraintEvaluator/constraintEvaluator.cpp, contrastShader/contrastShader.cpp, customComponentTagNode/customComponentTagNode.cpp, cvColorNode/cvColorNode.cpp, depthShader/depthShader.cpp, displacementShader/displacementShader.cpp, dx11Shader/dx11ConeAngleToHotspotConverter.cpp, exampleFalloff/smoothFalloffNode.cpp, fileTexture/fileTexture.cpp, flameShader/flameShader.cpp, footPrintNode_AnimatedMaterial/footPrintNode_GeometryOverride_AnimatedMaterial.cpp, footPrintNode_GeometryOverride/footPrintNode_GeometryOverride.cpp, fullLoftNode/fullLoftNode.cpp, gameInputDevice/gameInputDevice.cpp, gammaShader/gammaShader.cpp, genericAttributeNode/genericAttributeNode.cpp, geometrySurfaceConstraint/geometrySurfaceConstraint.cpp, geometrytools.cpp, geomShader/geomShader.cpp, hwPhongShader/hwPhongShader.cpp, interpShader/interpShader.cpp, jitterNode/jitterNode.cpp, lambertShader/lambertShader.cpp, latticeNoise/latticeNoiseNode.cpp, lavaShader/lavaShader.cpp, lightShader/lightShader.cpp, manipOverride/rockingTransform2.cpp, meshOpCmd/meshOpNode.cpp, MetadataSample/tweakMetadataNode.cpp, mixtureShader/mixtureShader.cpp, motionPathNode/motionPathNode.cpp, noiseShader/noiseShader.cpp, onbShader/onbShader.cpp, particleAttrNode/particleAttrNode.cpp, phongShader/phongShader.cpp, pointOnMeshInfo/pointOnMeshInfoNode.cpp, pointOnSubdNode/pointOnSubdNode.cpp, randomizerDevice/randomizerDevice.cpp, renderAccessNode/renderAccessNode.cpp, rockingTransform/rockingTransform.cpp, rockingTransformCheck/rockingTransform.cpp, rockingTransformCheck/rockingTransformCheck.cpp, shadowMatteShader/shadowMatteShader.cpp, shellNode/shellNode.cpp, shiftNode/shiftNode.cpp, simpleEvaluationNode/simpleEvaluationNode.cpp, simpleLoftNode/simpleLoftNode.cpp, simpleNoiseShader/simpleNoiseShader.cpp, simplePhysicsEngine/simplePhysicsEngine.cpp, simpleSimulationNode/simpleSimulationNode.cpp, simpleSkipNode/simpleSkipNode.cpp, sineNode/sineNode.cpp, slopeShader/slopeShaderNode.cpp, solidCheckerShader/solidCheckerShader.cpp, splatDeformer/splatDeformer.cpp, splitUVCmd/splitUVNode.cpp, sseDeformer/sseDeformer.cpp, stringFormatNode/stringFormatNode.cpp, testMTopologyEvaluator/testMTopologyEvaluator.cpp, testNobjectNode/testNobjectNode.cpp, testNpassiveNode/testNpassiveNode.cpp, topologyTrackingNode/topologyTrackingNode.cpp, transCircleNode/transCircleNode.cpp, udpDevice/udpDevice.cpp, volumeShader/volumeShader.cpp, and vp2BlinnShader/vp2BlinnShader.cpp.
MDataHandle outputValue ( const MObject &  attribute,
MStatus *  ReturnStatus = NULL 
)

Gets a handle to this data block for the given attribute's data.

The data is not guaranteed to be valid. No dependency graph evaluations will be done. Therefore, this handle should be used only for writing.

Parameters
[in]attributethe attribute of the node that you want to access
[out]ReturnStatusthe return status
Returns
Data handle for the given attribute's data
Status Codes:
  • MS::kSuccess operation successful
  • MS::kInvalidParameter object argument is invalid
MArrayDataHandle inputArrayValue ( const MPlug &  plug,
MStatus *  ReturnStatus = NULL 
)

Gets an array handle to this data block for the given plug's data.

This is only valid if the given plug has array data. The data represented by the handle will be valid. If the data is from a dirty connection, then the connection will be evaluated. If no connection is present, then the value that the plug has been set to will be returned. If the plug has not been set to a particular value, then the default value will be returned.

Parameters
[in]plugthe plug whose data you wish to access
[out]ReturnStatusthe return status
Returns
Array data handle for the given plug's data
Status Codes:
  • MS::kSuccess operation successful
  • MS::kInvalidParameter current element is not an array
Examples:
anisotropicShader/anisotropicShader.cpp, backfillShader/backfillShader.cpp, basicBlendShape/basicBlendShape.cpp, basicBlendShapeDeformer/basicBlendShapeDeformer.cpp, basicSkinCluster/basicSkinCluster.cpp, constraintEvaluator/constraintEvaluator.cpp, dynExprField/dynExprField.cpp, fullLoftNode/fullLoftNode.cpp, geometrySurfaceConstraint/geometrySurfaceConstraint.cpp, lambertShader/lambertShader.cpp, onbShader/onbShader.cpp, ownerEmitter/ownerEmitter.h, phongShader/phongShader.cpp, shadowMatteShader/shadowMatteShader.cpp, simpleEmitter/simpleEmitter.h, splatDeformer/splatDeformer.cpp, sseDeformer/sseDeformer.cpp, sweptEmitter/sweptEmitter.h, testNsolverNode/testNsolverNode.cpp, and testNucleusNode/testNucleusNode.cpp.
MArrayDataHandle inputArrayValue ( const MObject &  attribute,
MStatus *  ReturnStatus = NULL 
)

Gets an array handle to this data block for the given attribute's data.

This is only valid if the given attribute has array data. The data represented by the handle will be valid. If the data is from a dirty connection, then the connection will be evaluated. If no connection is present, then the value that the attribute has been set to will be returned. If the attribute has not been set to a particular value, then the default value will be returned.

Parameters
[in]attributeThe attribute whose data you wish to access
[out]ReturnStatusThe return status
Returns
Array data handle for the given attribute's data
Status Codes:
  • MS::kSuccess operation successful
  • MS::kInvalidParameter object argument is invalid
MArrayDataHandle outputArrayValue ( const MPlug &  plug,
MStatus *  ReturnStatus = NULL 
)

Gets a handle to this data block for the given plug.

No dependency graph evaluations will be done, and therefore the data is not guaranteed to be valid (i.e. it may be dirty). Typically, this method is used to get the handle during compute in order to write output data to it.

Another usage of this method is to access an input array attribute without evaluating any of its array elements. One can then use MArrayDataHandle::jumpToElement to get to the particular element of interest, and evaluate its value using MArrayDataHandle::inputValue.

Parameters
[in]plugthe plug whose data you wish to access
[out]ReturnStatusthe return status
Returns
Array data handle for the given plug's data
Status Codes:
  • MS::kSuccess operation successful
  • MS::kInvalidParameter current element is not an array
Examples:
apiMeshShape/apiMeshShape.cpp, basicMorphNode/basicMorphNode.cpp, dynExprField/dynExprField.cpp, footPrintNode/footPrintNode.cpp, multiCurveNode/multiCurveNode.cpp, offsetNode/offsetNode.cpp, ownerEmitter/ownerEmitter.cpp, simpleEmitter/simpleEmitter.cpp, stringFormatNode/stringFormatNode.cpp, sweptEmitter/sweptEmitter.cpp, torusField/torusField.cpp, and weightListNode/weightListNode.cpp.
MArrayDataHandle outputArrayValue ( const MObject &  attribute,
MStatus *  ReturnStatus = NULL 
)

Gets a handle to this data block for the given attribute's data.

The data is not guaranteed to be valid. No dependency graph evaluations will be done. Therefore, this handle should be used only for writing.

Parameters
[in]attributethe attribute of the node that you want to access
[out]ReturnStatusthe return status
Returns
Array data handle for the given attribute's data
Status Codes:
  • MS::kSuccess operation successful
  • MS::kInvalidParameter object argument is invalid
MStatus setClean ( const MPlug &  plug)

Tells the dependency graph that the given plug has been updated and is now clean.

This should be called after the data in the plug has been recalculated from the inputs of the node.

Parameters
[in]plugthe plug that is to be marked clean
Returns
Result status code
Status Codes:
  • MS::kSuccess operation successful
  • MS::kInvalidParameter object argument is invalid
Examples:
AbcImport/AlembicNode.cpp, affectsNode/affectsNode.cpp, animCubeNode/animCubeNode.cpp, anisotropicShader/anisotropicShader.cpp, apiMeshShape/apiMeshCreator.cpp, arcLenNode/arcLenNode.cpp, blindDataShader/blindDataMesh.cpp, cgFx/cgfxVector.cpp, circleNode/circleNode.cpp, closestPointOnCurve/closestPointOnCurveNode.cpp, customComponentTagNode/customComponentTagNode.cpp, cvColorNode/cvColorNode.cpp, dynExprField/dynExprField.cpp, footPrintNode/footPrintNode.cpp, fullLoftNode/fullLoftNode.cpp, gameInputDevice/gameInputDevice.cpp, genericAttributeNode/genericAttributeNode.cpp, geometrySurfaceConstraint/geometrySurfaceConstraint.cpp, jitterNode/jitterNode.cpp, latticeNoise/latticeNoiseNode.cpp, ownerEmitter/ownerEmitter.cpp, pointOnMeshInfo/pointOnMeshInfoNode.cpp, pointOnSubdNode/pointOnSubdNode.cpp, randomizerDevice/randomizerDevice.cpp, shellNode/shellNode.cpp, simpleEmitter/simpleEmitter.cpp, simpleEvaluationNode/simpleEvaluationNode.cpp, simpleLoftNode/simpleLoftNode.cpp, simpleSimulationNode/simpleSimulationNode.cpp, simpleSkipNode/simpleSkipNode.cpp, sineNode/sineNode.cpp, splatDeformer/splatDeformer.cpp, sweptEmitter/sweptEmitter.cpp, testMTopologyEvaluator/testMTopologyEvaluator.cpp, testNobjectNode/testNobjectNode.cpp, testNsolverNode/testNsolverNode.cpp, testNucleusNode/testNucleusNode.cpp, torusField/torusField.cpp, transCircleNode/transCircleNode.cpp, and udpDevice/udpDevice.cpp.
MStatus setClean ( const MObject &  attribute)

Tells the dependency graph that the given attribute has been updated and is now clean.

This should be called after the data in the plug has been recalculated from the inputs of the node.

Parameters
[in]attributethe attribute that we have updated the data for
Returns
Result status code
Status Codes:
  • MS::kSuccess operation successful
  • MS::kInvalidParameter object argument is invalid
bool isClean ( const MPlug &  plug)

Queries the dependency graph to see whether the given plug is clean.

Parameters
[in]plugthe plug that is to be query
Returns
Result boolean code, true if plug is clean, false otherwise.
Examples:
constraintEvaluator/constraintEvaluator.cpp, and simpleSimulationNode/simpleSimulationNode.cpp.
bool isClean ( const MObject &  attribute,
MStatus *  ReturnStatus = NULL 
)

Queries the dependency graph to see whether the given attribute is clean.

Parameters
[in]attributeThe attribute to query.
[out]ReturnStatusStatus code.
Returns
true if the attribute is clean, false otherwise.
Status Codes:
  • MS::kSuccess operation successful.
  • MS::kInvalidParameter The attribute is invalid.
MDGContext context ( MStatus *  ReturnStatus = NULL)

Returns a copy of the dependecy graph context for which this data block was created.

The context is used to specify how a dependency node is going to be evaluated.

Parameters
[out]ReturnStatusStatus code
Returns
The dependency graph context
Status Codes:
  • MS::kSuccess operation successful
  • MS::kInvalidParameter object error
Examples:
apiMeshShape/apiMeshShape.cpp, and simpleEvaluationNode/simpleEvaluationNode.cpp.
MStatus setContext ( const MDGContext &  ctx)

Set the dependency graph context for this data block.

The context is used to specify how a dependency node is going to be evaluated, thus replacing the context for the given datablock. This does not modify the dirty state of the datablock so that they apply to the new context.

This function should not be used for timed evaluation.

Parameters
[in]ctxthe dependency graph context
Returns
Status code
Status Codes:
  • MS::kSuccess operation successful
  • MS::kInvalidParameter object error
const char * className ( )
static

Returns the name of this class.

Returns
Name of this class.
The documentation for this class was generated from the following files: