Sets the source (DataSource) of the AnimationSourceItem as an FCurve. There are two ways you can use this
method:
(1) Specify a new FCurve source (eg.,
after creating a new AnimationSourceItem with ActionSource.AddSourceItem()
).
(2) Replace an existing DataSource with an FCurve source.
oReturn = AnimationSourceItem.SetAsFCurve( KeyValueArray, [Interpolation], [Type], [Extrapolation] ); |
| Parameter | Type | Description |
|---|---|---|
| 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: defined by parameter type |
| Type | siFCurveType | The type of the FCurve.
Default Value: defined by parameter type |
| Extrapolation | siFCurveExtrapolation | The extrapolation of the FCurve
Default Value: defined by parameter type |
' Create an ActionSource with one fcurve that will drive the global posx of anything called "Model".
NewScene , false
set oRoot = Application.ActiveProject.ActiveScene.Root
set oActionSource = oRoot.addactionsource("MyActionSource")
set oSourceItem = oActionSource.addsourceitem( "Model.kine.global.posx" )
set oFCurve = oSourceItem.SetAsFcurve( Array(1,-10,,,,Empty,50,0,,,,Empty,100,50,,,,Empty) )
for each oKey in oFCurve.Keys
LogMessage oKey.Time & ", " & oKey.Value
next
' Output of above script:
'INFO : 1, -10
'INFO : 50, 0
'INFO : 100, 50
|