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

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

Arguments

None

Flags

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

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

Shogun 1.13 Documentation

findGap