Description

The copyClip command can be used to copy either selected modules and data to a specified clip or to copy specific modules and data to a specified clip.

copyClip copies only modules and data from the currently active clip.

Functional area

Data manipulators

Command syntax

Syntax

copyClip "clipName" ["module" ...][-selected] [-create] [-leaveTimeAlone]

Arguments

Name	Type	Required	Comments
`clipName`	string	yes	Name of the clip you will be copying module and data to. If the `-create` flag is specified, then a clip with this name will be created.
`module1`	string or string array	no	Name of the module whose animation data to copy. You may pass in a string array containing a list of modules. You can also pass in multiple strings. If no strings/arrays are specified, then all modules will be copied (or selected modules, if you specify the `-selected` flag.

Flags

Name	Argument type	Exclusive to	Comments
`selected`	—	—	If specified, and no arguments are passed in to the command, the selected modules will have their animation data copied
`create`	—	leaveTimeAlone	If specified, a new clip will be created as the target clip, with the name provided by the first argument to the command
`leaveTimeAlone`	—	create	If specified, the target clip will not have it`s time related attributes changed Start_Frame, Clip_Offset, and Duration)

Return value

void

Examples

// create a Clip and a Marker
create Clip "clip1";
create Marker "marker1";
 
// animate the marker to represent data being copied
setTime 0;
setKey Translation 0 0 0;
setTime 20;
setKey Translation 100 100 100;
 
// create a 2nd Clip
// copy marker1 to clip2
copyClip clip2 marker1 -create;

Shogun 1.14 Documentation

copyClip