---
title: "animRange"
canonical: "https://help.vicon.com/space/Shogun111/13207627/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/Shogun111/pages/13220014)
- [getAnimEnd](https://vicon-help.atlassian.net/wiki/spaces/Shogun111/pages/13207878)
- [getPlayEnd](https://vicon-help.atlassian.net/wiki/spaces/Shogun111/pages/13208060)
- [getPlayStart](https://vicon-help.atlassian.net/wiki/spaces/Shogun111/pages/13208062)
- [getTime](https://vicon-help.atlassian.net/wiki/spaces/Shogun111/pages/13208120)
- [play](https://vicon-help.atlassian.net/wiki/spaces/Shogun111/pages/13208228)
- [playOptions](https://vicon-help.atlassian.net/wiki/spaces/Shogun111/pages/13220044)
- [playRange](https://vicon-help.atlassian.net/wiki/spaces/Shogun111/pages/13208232)
- [setRangesFollowActiveClip](https://vicon-help.atlassian.net/wiki/spaces/Shogun111/pages/13208500)
- [setTime](https://vicon-help.atlassian.net/wiki/spaces/Shogun111/pages/13208524)
- [step](https://vicon-help.atlassian.net/wiki/spaces/Shogun111/pages/13208584)
- [stepKey](https://vicon-help.atlassian.net/wiki/spaces/Shogun111/pages/13208586)
- [stop](https://vicon-help.atlassian.net/wiki/spaces/Shogun111/pages/13208588)