PlotCamSeqToActions

PlotCamSeqToActions

Introduced

v12.0 (2014)

Description

Creates and returns new actions by plotting values from consecutive Camera Sequencer frames. Actions are created under models containing animated parameters matching the specified list.

Scripting Syntax

oReturn = PlotCamSeqToActions( [InputObjs], [ActionName], [SequencerIn], [SequencerOut], [PlotWithoutGaps], [FCurve Kind], [DefaultSegKind], [Fit FCurve], [Fit Tolerance], [ProcessContRots], [Apply], [Delete] );

Return Value

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

Parameters

Parameter

Type

Description

InputObjs

List of parameters to plot into actions.

Default Value: All animated parameters in the scene (ie., every animated parameter on each object in the scene).

ActionName

Name for the new actions.

Default Value: CamSeq_PlotAction

SequencerIn

Start camera sequencer frame of the region on which to operate.

Default Value: 1

SequencerOut

End camera sequencer frame of the region on which to operate.

Default Value: 100

PlotWithoutGaps

Determine whether or not to ignore the gaps between ShotClips.

Default Value: False

FCurve Kind

What kind of fcurve do we want to plot to?

Default Value: siStandardFCurve

Possible Values:	Description:
siBooleanFCurve	BOOLEAN (value true or false)
siIntegerFCurve	INTEGER (staircase-like fcurve with integer values)
siStandardFCurve	STANDARD (fcurve with spline/linear/constant interpolation)
siRawDataFCurve	RAWDATA (linear fcurve: less storage than a standard fcurve but with linear interpolation only)

DefaultSegKind

siFCurveInterpolation

What kind of interpolation do we want for the resulting fcurves?

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

Default Value: siCubicInterpolation

Possible Values:	Description:
siConstantInterpolation	Constant function
siLinearInterpolation	Linear function
siCubicInterpolation	Bezier cubic function

Fit FCurve

Do we want to fit an fcurve through the plotted values?

Default Value: False

Fit Tolerance

What tolerance do we want for the fit?

Default Value: 0.01

ProcessContRots

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

Default Value: True

Apply

Do we want to apply the actions after plotting them?

Default Value: True

Delete

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

Default Value: False

See Also

PlotFrameSetToActions PlotCamSeqShape PlotSequencerCamera PlotCamSeqForCachedObjects ApplyCamSeqFileCacheSources GetSceneFrameSetFromCamSeq