---
title: "copyClip"
canonical: "https://help.vicon.com/space/ShogunPost121/1253739720/copyClip"
format: markdown
---
# 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

> Macro (scroll-tablelayout)

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

### Arguments

> Macro (scroll-tablelayout)

| 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. |

> Macro (scroll-pagebreak)

### Flags

> Macro (scroll-tablelayout)

| Name | Flag arguments | Argument type | Exclusive to | Comments |
| --- | --- | --- | --- | --- |
| `selected` | 0 | — | — | If specified, and no arguments are passed in to the command, the selected modules will have their animation data copied |
| `create` | 0 | — | 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` | 0 | — | 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

```plaintext
// 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;
```

> Macro (scroll-pagebreak)

# Additional information

## Related commands

- [addLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737807)
- [addToClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737256)
- [cropClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736523)
- [deleteClipData](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736978)
- [flatten](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738158)
- [getActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736484)
- [getClips](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737048)
- [moveClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736803)
- [offsetClips](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737528)
- [removeFromClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736603)
- [removeLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738515)
- [resetClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736672)
- [selectClipObjects](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253739060)
- [setActiveClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736878)
- [setActiveClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736878)
- [setActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737913)
- [tileClips](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738014)