---
title: "findGap"
canonical: "https://help.vicon.com/space/ShogunPost121/1253736657/findGap"
format: markdown
---
# Description

This command identifies the next gap found in any of the selected modules.

findGap is useful for quickly identifying gaps in a marker or group of markers. Gaps of one or two frames can be very difficult to detect manually and will introduce problems when the data is applied toward a skeletal solution, or imported into another animation package.

The next marker found using this command becomes the primary-selected object.

## Functional area

Data retrieval

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `findGap [-selectGapRange integer integer] [-b] [-frameGraph] [-firstFrame] [-any] [-ranges] [-primaryOnly] [-noFeedback] [-rot] [-noLoop]` |

### Arguments

None

### Flags

> Macro (scroll-tablelayout)

| Name | Flag arguments | Argument type | Exclusive to | Comments |
| --- | --- | --- | --- | --- |
| `selectGapRange` | 2 | integer | — | Selects the time range (including leading and trailing frames expressed as integers) of the gap when a gap is found. |
| `b` | 0 | — | — | Searches for gaps backward in time. |
| `frameGraph` | 0 | — | — | Frames the gap in a third the width of the graphView |
| `firstFrame` | 0 | — | — | Goes to the first frame of the gap, in the direction that it is searching |
| `any` | 0 | — | — | Query channels independently. With this option Shogun Post will find gaps on independent channels. E.g. Translation X only. Default is to only find gaps if there are gaps on all three channels. |
| `ranges` | 0 | — | — | Will search selected time ranges, instead of play range |
| `primaryOnly` | 0 | — | — | Causes it to only search for a gap on the primary selected node. |
| `noFeedback` | 0 | — | — | Prevents command from printing to the command log. |
| `rot` | 0 | — | — | Find gaps on rotations channels |
| `noLoop` | 0 | — | — | — |

## Return value

integer array

## Examples

```plaintext
findGap -b -select 5 3;
selectKeys -ranges;
// This example selects the time range of the gap immediately 
// preceding the current frame, 5 frames before the gap, and 
// 3 frames after the gap will be added to the time range.
// Then, all of the keys within the selected time range will also
// be selected.
//
// Print the gap range of selected Marker 
//
//select a Marker
int $i[] = `findGap`;
print $i[0] ;
print $i[1] ;
```

> Macro (scroll-pagebreak)

# Additional information

## Related commands

- [fillGaps](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738229)
- [findBadData](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737116)