This information is for Vicon Shogun 1.7. For up-to-date help, see the latest Shogun documentation.

Vicon Shogun banner


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


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




NameFlag argumentsArgument typeExclusive toComments
selectGapRange2integerSelects the time range (including leading and trailing frames expressed as integers) of the gap when a gap is found.
b0Searches for gaps backward in time.
frameGraph0Frames the gap in a third the width of the graphView
firstFrame0Goes to the first frame of the gap, in the direction that it is searching
any0Query 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.
ranges0Will search selected time ranges, instead of play range
primaryOnly0Causes it to only search for a gap on the primary selected node.
noFeedback0Prevents command from printing to the command log.
rot0Find gaps on rotations channels

Return value

integer array 


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] ;

Additional information

Related commands