Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.

Synopsis

dgValidateCurve([allCurves=boolean], [verbose=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

dgValidateCurve is NOT undoable, NOT queryable, and NOT editable.

The dgValidateCurve command is used to make sure the curve internal status matches their actual state. It forces checks on curves that might not be tagged as static, even if they are. The DG tracks static curves in order to optimize evaluation by not considering them animated. Once keys are added and modified on the curve, it is no longer static. Certain operations on the curve might make it flat / without animation, but the DG will not treat it as static because it expects it to be modified again soon. This command allows to explicitly request checks for the static state of animation curves.

Return value

intNumber of curves which changed their static status.

Keywords

dg, dependency, graph, dirty, static, curve

Related

dbpeek, dgInfo, dgdirty, dgeval

Flags

allCurves, verbose
Long name (short name) Argument types Properties
allCurves(a) boolean create
Ignore the selected or specified objects and work on all curves.
verbose(v) boolean create
Prints out all of the curves set static or not.

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds


# Check all curves.
#
cmds.dgValidateCurve(allCurves=True);
# Result: 123 #