Description

fillGaps operates on selected markers to fill all gaps found within the selected input curves. This command has a number of options that are extremely useful for the flexible handling of marker occlusions.

This command contains a collection of tools to address missing translation keyframes of data usually found in raw optical motion capture data. One of the most useful of these is fillGaps -rigid -all, which uses knowledge about the relationships of certain markers to one another to intelligently fill in missing translation data. This option if also flexible since the user can apply a rigid fill based on any selected markers in the scene.

Functional area

Data editing

Command syntax

Syntax

fillGaps [-all] [-ranges] [-rigid] [-useCurrentFrame] [-primaryOnly] [-maxGapWidth integer] [-labelingConstraints] [-solvingConstraints] [-rangesOnly] [-noWarning] [-minRigidRange integer integer]

Arguments

None

Flags

Name	Flag arguments	Argument type	Exclusive to	Comments
`all`	0	—	ranges, rangesOnly	Fill all gaps on selected properties of selected nodes.
`ranges`	0	—	all, rangesOnly	Fill gaps within the selected time ranges.
`rigid`	0	—	constraints	Applies a rigid body solution to all selected markers to fill all gap(s) in the selection. Can often be successfully used on several selected objects that are not very rigid across an entire move.Shogun warns you when more than 9 markers are selected due to calculation overhead.
`useCurrentFrame`	0	—	—	Bases rigid body calculations on the current frame rather than lettingShogun pick an optimal rigid body definition (Only used in conjunction with the -rigid option).
`primaryOnly`	0	—	—	Fills gaps on the primary selection only.
`maxGapWidth`	1	integer	—	Fills only gaps in which the gap duration in terms of consecutive keys is less than this number.
`labelingConstraints`	0	—		Fills gap(s) as dictated by the offset from the BoneNode attached to.
`solvingConstraints`	0	—		Fills gap(s) as dictated by the offset from the BoneNode attached to.
`rangesOnly`	0	—	all, ranges	—
`noWarning`	0	—	—	Suppresses the warning generated when the number of markers selected for a rigid fill exceeds 9.
`minRigidRange`	2	integer	—	—

Return value

integer

Examples

fillGaps -rigid -all;
// Execution of this command will result in: 
// a) the temporary application of a rigid body solution based 
// upon the selected markers 
// b) the identification of gaps within the selection set, and 
// c) the application of data held within the temp markers in the
// rigid body solution to gaps in the original markers across the
// entire play range. 
// This command will not overwrite any data pertaining to the selected
// markers, it merely fills in data where it is found to be missing.

fillGaps -maxGapWidth 5;
// Fill all gaps in the selection set that are 4 keys or 
// less in duration.

Shogun 1.12 Documentation

fillGaps