autoLabel
- Gisela Roberts
- Ben Stanley
Description
Autolabels trajectories
Autolabeling is Shogun's default automated mechanism to assign unlabeled markers to the markers of a calibrated character. Autolabeling examines the positions of unlabeled markers in the frame and attempts to fit them to the marker sets of the characters loaded into the scene, based on the relative distances between marker pairs. The autoLabel command autolabels trajectories based on the frame range specified by the rangeMode option.
Labeling selected ranges requires specifying whether the labeling of markers will extend beyond the selected ranges, since trajectory lifetimes may extend beyond the specified start and end times of the selected ranges.
If extending the labeling to frames outside the selected ranges is desired, use the selectedranges mode; otherwise, use the selectedrangesonly mode, which will break the trajectories where they cross the start and end of the selected ranges.
| rangeMode option | Description |
|---|---|
playrange | Autolabel over the entire play range |
selectedranges | Autolabel over selected ranges and extend labels to labeled trajectories beyond range of selection |
selectedrangesonly | Autolabel over selected ranges only within the frames within the selected ranges, breaking trajectories |
currentframe | Autolabels the current frame without breaking trajectories |
Functional area
Labeling
Command syntax
Syntax
autoLabel [-rangeMode string] |
Arguments
None
Flags
| Name | Flag arguments | Argument type | Exclusive to | Comments |
|---|---|---|---|---|
rangeMode | 1 | string | — | Set the range mode of the autolabel operation to one of the following values:playrange Autolabel the frames contained in the entire play rangeselectedranges Autolabel only the selected frames, extending labels to the entire trajectory including to frames outside the selected rangesselectedrangesonly Autolabel the selected frames, and do not extend application of labeling beyond the selected ranges, breaking trajectories if necessarycurrentframe Autolabel the trajectories in the current frame without breaking them |
Return value
void
Examples
// Autolabel the entire play range. autoLabel -rangeMode "playRange";
