Finds and selects keys that deviate over a tolerance between the active clip and another clip. Both clips must have a key at each frame for the comparison to be done.
This is useful when comparing the results of an editing operation with the second figure clip.
|string||yes||Name of the clip to compare with.|
|float||yes||Value in millimeters that key values must be deviant to be selected.|
|integer||yes||Number of consecutive frames that keys must be deviant to be selected.|
|Name||Flag arguments||Argument type||Exclusive to||Comments|
|0||—||—||Restricts the search to the selected time ranges. The default is to search the entire animation range.|
|0||—||—||Restricts the search to the primary selected node. The default is to search all selected nodes.|
|0||—||—||Specifies that the ranges of the deviant keys should be selected as well.|
|0||—||—||Set this flag to skip writing the results of the operation to the log|
|0||—||primaryOnly, selectRanges||Check position deviance only, ignoring rotational deviance|
|0||—||ranges, selectRanges||Check rotational deviance only, ignoring positional deviance|
Returns the number of deviant keys
// Import a file and create a second figure
loadFile "C:/temp/myFile.c3d" -i -createSecondFig;
// Select and filter the head markers using the current filter settings
select LFHD RFHD LBHD RBHD;
// Now select the keys that deviate from the second figure clip
// by at least 5 mm over at least 10 consecutive keys. Also select the deviant ranges.
findDeviantKeys myFilec3d_2fg 5 10 -selectRanges;
// Do something with those keys/ranges!