---
title: "animRange"
canonical: "https://help.vicon.com/space/Shogun19/13795774/animRange"
format: markdown
---
# Description

Sets the play Range.

If `-start` is used then only the `inTime` should be specified, the end time of the play range remains unchanged from the existing.

If `-end` time is used then only `outTime` should be specified, the start time of the play range remains unchanged from the existing.

Otherwise both the start and end time must be specified.

## Functional area

Playback control

# Command syntax

## Syntax

|  |
| --- |
| `animRange inTime outTime [-r] [-start] [-end]` |

### Arguments

| **Name** | **Type** | **Required** | **Comments** |
| --- | --- | --- | --- |
| `inTime` | integer | No (dependant) | Starting Time |
| `outTime` | integer | No (dependant) | Ending Time |

> Macro (scroll-pagebreak)

### Flags

> Macro (scroll-tablelayout)

| **Name** | **Flag arguments** | **Argument type** | **Exclusive to** | **Comments** |
| --- | --- | --- | --- | --- |
| `r` | 0 | — | — | Start and end times specified are relative to the existing playrange start and end times |
| `start` | 0 | — | end | inTime is the start time, outTime is not specified |
| `end` | 0 | — | start | outTime is the end Time, inTime is not specified |

## Return value

void

## Examples

```plaintext
// set the play Range to 50 -200 
playRange 50 200;
 
// set the start of the play Range to 50
playRange 50 -start;
 
// set the end of the play Range to 200
playRange 200 -end;
 
// when existing play range start is frame 50 
// sets the start to 150 ( 50 + 100 )
playRange 100 -r -start;
```

# Additional information

## Related commands

- [fastForward](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13803919)
- [getAnimEnd](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796026)
- [getPlayEnd](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796208)
- [getPlayStart](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796210)
- [getTime](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796268)
- [play](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796376)
- [playOptions](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13803949)
- [playRange](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796380)
- [setRangesFollowActiveClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796648)
- [setTime](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796672)
- [step](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796732)
- [stepKey](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796734)
- [stop](https://vicon-help.atlassian.net/wiki/spaces/Shogun19/pages/13796736)