ActionDelta.AddFCurveItem

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).

C# Syntax

ActionDeltaItem ActionDelta.AddFCurveItem( Object in_vTarget, Object in_KeyValueArray, Object in_vInterpolation, Object in_vType, Object in_vExtrapolation );

Scripting Syntax

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

Return Value

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();