---
title: "getActiveClip"
canonical: "https://help.vicon.com/space/ShogunPost116/341117904/getActiveClip"
format: markdown
---
# Description

Return the name of the currently active clip.

Useful when querying the scene for the currently active clip.

## Functional area

Data retrieval

# Command syntax

## Syntax

|  |
| --- |
| `getActiveClip` |

### Arguments

None

### Flags

None

## Return value

string

## Examples

```plaintext
//create 2 Clips
create Clip "Clip_A" "Clip_B";
 
//index the Clip
string $clip = `getActiveClip`;
 
//print the currently active Clip
print $clip;
```

> Macro (scroll-pagebreak)

# Additional information

## Related commands

- [addLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341116979)
- [addToClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341117044)
- [copyClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341117326)
- [cropClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341117560)
- [deleteClipData](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341117625)
- [flatten](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341117880)
- [getActiveClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341117904)
- [getActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341117910)
- [getClips](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341118012)
- [moveClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341119045)
- [offsetClips](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341119105)
- [removeFromClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341119338)
- [removeLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341119344)
- [resetClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341119436)
- [selectClipObjects](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341119596)
- [setActiveClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341119722)
- [setActiveLayer](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341119733)
- [tileClips](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost116/pages/341120538)