PlotKeyableToActions

Introduced

v7.5

Description

Creates new actions by plotting the keyable and animatable parameters on any specified (or selected) object. Actions are created under models containing the constrained parameters and you can choose whether or not to apply the actions back to the model and then optionally delete them.

Scripting Syntax

oReturn = PlotKeyableToActions( [InputObjs], [Name], [StartFrame], [EndFrame], [StepFrame], [FCurve Kind], [DefaultSegKind], [Fit FCurve], [Fit Tolerance], [ProcessContRots], [Apply], [Paste], [Delete] );

Return Value

Returns the created actions (a XSICollection object). Returns nothing if you chose the Delete option.

Parameters

Parameter Type Description
InputObjs String Objects that need to be plotted.

Default Value: Current selection

Name String Name for the actions

Default Value: "Action"

StartFrame Double First frame to plot

Default Value: 0

EndFrame Double Last frame to plot

Default Value: 0

StepFrame Double Step between frames

Default Value: 1

FCurve Kind Integer What kind of fcurve do we want to plot to?

Default Value: 20

Possible Values:

Description:

10 BOOLEAN (value true or false)
15 INTEGER (staircase-like fcurve with integer values)
20 STANDARD (fcurve with spline/linear/constant interpolation)
30 RAWDATA (linear fcurve: less storage than a standard fcurve but with linear interpolation only)
DefaultSegKind Integer What kind of interpolation do we want for the resulting fcurves?

Note: Only relevant when FCurveKind is 20 (Standard).

Default Value: 3

Possible Values:

Description:

1 CONSTANT
2 LINEAR
3 CUBIC
Fit FCurve Boolean Do we want to fit an fcurve through the plotted values?

Default Value: False

Fit Tolerance Double What tolerance do we want for the fit?

Default Value: 0.01

ProcessContRots Boolean Do we want to process rotation curves to ensure their continuity?

Default Value: True

Apply Boolean Do we want to apply the actions after plotting them?

Default Value: True

Paste Boolean If applying, should they be applied using paste (merging with existing fcurves on parameters)?

Default Value: False

Delete Boolean After plotting and applying, do we want to delete the actions? Only valid if Apply is specified.

Default Value: False

See Also

PlotToActions PlotAndApplyActions PlotConstrainedTransformsToActions StoreAction