nuke.curvelib.AnimAttributes

class nuke.curvelib.AnimAttributes

Bases: object

A collection of named attributes.

Each attribute is represented as a curve, parameterised over time. Convenience methods for managing the curves (adding and removing keys, etc.) are provided, as well as methods for managing the list of available attributes.

Attributes can be accessed by index or by name. This class defines constants for standard names in use by Nuke.

Methods

`add`	Add a new attribute.
`addKey`	When a name and value is specified, this method adds a new key to an existing attribute at the given time.
`getCurve`	Gets the AnimCurve object for a particular attribute.
`getKeyTime`	Gets the time a particular key is set at.
`getName`	Get the name of an attribute when you know its index.
`getNumberOfKeys`	Returns the number of keys in the curve for a particular attribute.
`getValue`	Evaluates the anim curve of an attribute at a particular time and returns the value.
`remove`	Remove an attribute.
`removeAll`	Remove all attributes.
`removeKey`	Remove a particular key from an attribute.
`removeKeys`	Remove all keys from an attribute.
`reset`	Reset the object to have no attributes.
`set`	Set the value of an attribute.
`setCurve`	Replace the current anim curve for an attribute with a new one.
`setKey`	Set a key for an attribute.
`setName`	Change the name of an existing attribute.

Attributes

`kAlphaAttribute`
`kAlphaOverlayAttribute`
`kBlendingModeAttribute`
`kBlueAttribute`
`kBlueOverlayAttribute`
`kBrushSizeAttribute`
`kBrushSpacingAttribute`
`kBrushTypeAttribute`
`kBuildUpAttribute`
`kDynamicHardnessAttribute`
`kDynamicSizeAttribute`
`kDynamicTransparencyAttribute`
`kEffectParameter1Attribute`
`kEffectParameter2Attribute`
`kEffectParameter3Attribute`
`kFeatherFallOffAttribute`
`kFeatherOnAttribute`
`kFeatherTypeAttribute`
`kFeatherXAttribute`
`kFeatherYAttribute`
`kGreenAttribute`
`kGreenOverlayAttribute`
`kHardnessAttribute`
`kInvertedAttribute`
`kLifeTimeMAttribute`
`kLifeTimeNAttribute`
`kLifeTimeTypeAttribute`
`kMotionBlurAttribute`
`kMotionBlurOnAttribute`
`kMotionBlurShutterAttribute`
`kMotionBlurShutterOffsetAttribute`
`kMotionBlurShutterOffsetTypeAttribute`
`kNumberOfViewsAttribute`
`kOpacityAttribute`
`kPlanarTrackLayerAttribute`
`kRedAttribute`
`kRedOverlayAttribute`
`kSourceAttribute`
`kSourcePivotPointXAttribute`
`kSourcePivotPointYAttribute`
`kSourceRotateAttribute`
`kSourceScaleXAttribute`
`kSourceScaleYAttribute`
`kSourceSkewOrderAttribute`
`kSourceSkewXAttribute`
`kSourceSkewYAttribute`
`kSourceTimeOffsetAttribute`
`kSourceTimeOffsetTypeAttribute`
`kSourceTranslateRoundAttribute`
`kSourceTranslateXAttribute`
`kSourceTranslateYAttribute`
`kTensionAttribute`
`kViewAttribute`
`kVisibleAttribute`
`kWriteOnEndAttribute`
`kWriteOnStartAttribute`

add(name, value) → None: Add a new attribute. The name parameter is the name for the attribute and value is the initial int or float value to assign to it.

addKey(time, name, value, view) → None
addKey(time, view) → None: When a name and value is specified, this method adds a new key to an existing attribute at the given time. When the name and value are omitted, a new key is added to all attributes at the specified time. The view parameter is optional in either case.

getCurve(attr, view) → AnimCurve: Gets the AnimCurve object for a particular attribute. The attr parameter can be the index or name of the attribute. The view parameter is optional.

getKeyTime(index, keyIndexOrHash, view) → float: Gets the time a particular key is set at. The index parameter is the index of the attribute; keyIndexOrHash is either the index of the key in the attributes AnimCurve, or its associated Hash; and view is the optional view name.

getName(index) → str: Get the name of an attribute when you know its index.

getNumberOfKeys(attr, view) → int: Returns the number of keys in the curve for a particular attribute. The attr parameter can be the index or name of the attribute. The view parameter is optional.

getValue(time, indexOrName, view) → float: Evaluates the anim curve of an attribute at a particular time and returns the value. time is the time for which to evaluate the attribute; indexOrName is either the index of the attribute to evaluate, or its name; and view is the optional view name.

remove(attributeIndexOrName) → None: Remove an attribute. You can give the name or index of the attribute.

removeAll() → None: Remove all attributes.

removeKey(time, attributeIndex, view) → None: Remove a particular key from an attribute. The view parameter is optional.

removeKeys(attributeIndex, view) → None: Remove all keys from an attribute. The view parameter is optional.

reset() → None: Reset the object to have no attributes.

set(time, attributeIndexOrName, value, view) → None: Set the value of an attribute. The time parameter is optional: if it’s present, a new key is created at that time with the specified value; if it’s not present, a constant value is set for the attribute. The attribute to set may be identified by its name or index. The view parameter is optional.

setCurve(index, curve) → None: Replace the current anim curve for an attribute with a new one. The index parameter is the index of the attribute; and curve is an AnimCurve instance.

setKey(time, attributeIndex, hash, value, view) → None: Set a key for an attribute. The time parameter is when the new key will be created for; the attributeIndex says which attribute to set the key for; the

setName(attributeIndex, newName) → None: Change the name of an existing attribute.