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).
ActionDeltaItem ActionDelta.AddFCurveItem( Object in_vTarget, Object in_KeyValueArray, Object in_vInterpolation, Object in_vType, Object in_vExtrapolation ); |
oReturn = ActionDelta.AddFCurveItem( Target, [KeyValueArray], [Interpolation], [Type], [Extrapolation] ); |
| 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 |
/*
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();
|