v1.0
Offsets the value map for a clip. One action item must be active at the specified global time. Offsetting actions is a task that you will probably perform frequently. For example, you may need to offset an action in local space so that the animation occurs in a different location from where it was originally defined.
OffsetValueMap( [InputObjs], [Type], [Time], [Value] ); |
Parameter | Type | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
InputObjs | String |
List of animatable parameters Default Value: Current marked and selected objects |
||||||||
Type | siEffectInputType |
Type of input we expect Default Value: siSelectedParams
|
||||||||
Time | Double |
Frame number. Default Value: Current frame. |
||||||||
Value | Number |
Offset value Default Value: Current value for each parameter. Use of this argument is rare. |
' Create an animation with a cone translated along the x axis set oCone = CreatePrim( "Cone", "MeshSurface" ) SaveKey oCone & ".kine.local.posx", 5, 0 SaveKey oCone & ".kine.local.posx", 30, 5 set oAction = StoreAction( oCone, "/kine.local.pos", 2, "testStoredAction" ) AddClip "Scene_Root", oAction, , , 10 ' See what value of the x translation we get at frame 20 ' with the original clip. actualVal = GetValue( oCone & ".kine.local.posx", 20 ) LogMessage "Pre-offset, posx is: " & actualVal ' Offset the translation in x. Starts further from the left OffsetValueMap oCone & ".kine.local.posx", siSelectedParams, 20, -5 ' Confirm that indeed at frame 20 the result (using the ' offset we just set) is what we told it to be: -5. actualVal = GetValue( oCone & ".kine.local.posx", 20 ) if abs( actualVal - -5 ) < 1e-9 then LogMessage "Expected -5 and got it...the universe makes sense!" else LogMessage "Expected -5, but got " & actualVal end if |