PasteKeys
Pastes FCurveKeys from the
buffer onto one or more FCurves
for the specified timerange (from StartFrame to EndFrame). FCurve
keys are placed in the buffer by using the CutKeys or CopyKeys
commands.
Tip: You specify each fcurve to paste onto by identifying the
parameter it drives in the InputObjs argument.
PasteKeys is the command equivalent of the paste action in the
dopesheet and should be used when trying to emulate dopesheet
behaviour.
Note: This command uses output
arguments. C# and some scripting languages (such as JScript,
PerlScript and Python) don't support arguments passed by reference
so you need to use the best workaround for your situation:
For scripting languages this command returns an ISIVTCollection which you can
use to get the output arguments.
For C# you can use the XSIApplication.ExecuteCommand
method to call this command. ExecuteCommand packs the output
arguments into a C# System.Object containing an Array of the output arguments (see
Calling
Commands from C#).
PasteKeys( [InputObjs], [StartFrame], [EndFrame], [Ripple], [Merge], [Type], [Offset], [Relative], [LeftContinuity], [RightContinuity] ); |
| Parameter | Type | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| InputObjs | String | List of animatable
parameters (for example "cone*/kine.local.pos"). This parameter
uses the Type parameter to interpret which parameters to use in
this way: - If Type == siInputParameters then InputObjs is used exactly as input (either from the specified list or the animatable parameters on the selected objects). - If Type == siAnimatedParameters then InputObjs is expected to be a list of objects on which each animatable parameter will be affected. - If Type == siAllAnimatedParameters then the value of InputObjs is ignored and instead the command uses all animated parameters on all objects in the entire scene. Default Value: If no value is specified for this parameter, the Object List will use the selected objects or parameters respecting the scope indicated by the Type argument. |
||||||||
| StartFrame | Double | Lower bound of the frame interval
Default Value: 1 |
||||||||
| EndFrame | Double | Upper bound of the frame interval
Default Value: 100 |
||||||||
| Ripple | Boolean | Flag to ripple the keys
Default Value: True |
||||||||
| Merge | Boolean | Flag to specify whether we merge (default) or replace keys when
pasting
Default Value: True |
||||||||
| Type | siParameterScope | Parameter scope of the operation
Default Value: siInputParameters |
||||||||
| Offset | Double | Offset (new Upper Bound) from the Lower Bound of the pasted frame interval | ||||||||
| Relative | Boolean | Flag to specify whether the key values should be pasted
relative to the start frame.
Default Value: False |
||||||||
| LeftContinuity | Integer | This parameter controls how the first pasted key value is
determined.
Default Value: 0
|
||||||||
| RightContinuity | Integer | This parameter controls how the last pasted key value is
determined.
Default Value: 0
|