ActionDelta.AddFCurveItem

Description

Adds a new ActionDeltaItem of type siModificationDeltaFCurves to an ActionDelta created with the Delta.AddAction method.

The ActionDelta should be of type siModificationDeltaFCurves to use this method (see siModificationDeltaType for a list of ActionDelta types).

Scripting Syntax

oReturn = ActionDelta.AddFCurveItem( Target, [KeyValueArray], [Interpolation], [Type], [Extrapolation] );

Return Value

ActionDeltaItem

Parameters

Parameter Type Description
Target String Target path for source item
KeyValueArray Array of key data The array may be a 1- or 2-dimensional array. For 2-dimensional arrays the first dimension must define the key values. These contain 6 values per key for fcurves of interpolation type siCubicInterpolation (see siFCurveInterpolation) and 2 values for keys for the other fcurve interpolation types. The first value is the key time (in frames) and the second in the key value (in value units). For Cubic (or bezier) fcurves the remaining 4 values are the tangency values for: lefttanx (in frames), lefttany (in value units), righttanx (in frames), and righttany (in value units).
Interpolation siFCurveInterpolation The interpolation of the FCurve

Default Value: siCubicInterpolation

Type siFCurveType The type of the FCurve.

Default Value: siStandardFCurve

Extrapolation siFCurveExtrapolation The extrapolation of the FCurve

Default Value: siConstantExtrapolation

Examples

JScript Example

/*
        This example demonstrates how to add an ActionDeltaItem of type 
        siModificationDeltaFCurves to a ActionDelta.
*/
NewScene (null, false);
// Create a reference model from a cube
var oRoot = Application.ActiveProject.ActiveScene.Root;
var oCube = oRoot.AddGeometry("Cube", "MeshSurface");
var emdlFileRefModel = XSIUtils.BuildPath(Application.InstallationPath(siProjectPath), "Models", "MyModel.emdl"); 
CreateModelAndConvertToRef(oCube, emdlFileRefModel);
// Add the Delta object
var oDelta = AddDelta(oCube.Model);
// Add an action of type siModificationDeltaFCurves
var oDeltaAction = oDelta.AddAction(siModificationDeltaFCurve);
// Set the array
var aKeyData = Array
(
1.00, 5.00, 0, 0, 0, 0,
100.00, 8.00, 0, 0, 0, 0
);
// Add the fcurve item
var oActionDeltaItem = oDeltaAction.AddFCurveItem(oCube + ".kine.global.posx", aKeyData);
// Apply modification
oDelta.Apply();

See Also

ActionDelta.AddConstraintItem ActionDelta.AddStaticValueItem ActionDelta.AddExpressionItem