---
title: "stepKey"
canonical: "https://help.vicon.com/space/ShogunPost115/276212782/stepKey"
format: markdown
---
# Description

Goes to the next frame that has a key on the selected modules. (Works like [findGap](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276211907), but doesn't wrap). Useful for data analysis scripts.

## Functional area

Playback control

# Command syntax

## Syntax

|  |
| --- |
| `stepKey [-b] [-any] [-s] [-primary]` |

### Arguments

None

### Flags

| **Name** | **Flag arguments** | **Argument type** | **Exclusive to** | **Comments** |
| --- | --- | --- | --- | --- |
| `b` | 0 | — | — | Steps backwards in time |
| `any` | 0 | — | — | Steps to the next or previous frame where X Y and Z all have keys |
| `s` | 0 | — | — | Set selected modules |
| `primary` | 0 | — | — | Use the primary selected modules |

## Return value

boolean

> Macro (scroll-pagebreak)

## Examples

```plaintext
//open a sample file (*.c3d)
//
//select markers
selectByType Marker;
stepKey;
```

# Additional information

## Related commands

- [animRange](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276205954)
- [fastForward](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276213607)
- [getAnimEnd](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276210472)
- [getPlayEnd](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276212497)
- [getPlayStart](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276210963)
- [getTime](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276207590)
- [play](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276206480)
- [playOptions](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276213179)
- [playRange](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276205025)
- [setRangesFollowActiveClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276202902)
- [setTime](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276208391)
- [step](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276211823)
- [stop](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost115/pages/276208879)