Create retargeting constraints
- Adaptavist ScriptRunner for Confluence Cloud (Unlicensed)
Tip
When creating constraints in Shogun Post 1.6 and later, note the following shortcuts:
CTRL+T creates a retargeting constraint between the selected solving and retargeting bones, or a solving constraint between the selected solving bone and marker.
CTRL+R creates a retargeting rotation constraint between the selected solving and retargeting bones.
In the lists on the right of the Retargeting tab (or anywhere else in Shogun Post), select a matching source and target bone, then click Add Position or Add Rotation to create a constraint between them. The order of selection does not matter.
As a starting point for the constraints, add a position on hands, feet and hips; and rotation on all joints.
If your target skeleton has more joints than the Vicon source skeleton, you can constrain multiple target joints to the same Vicon source joint.
Tip: You can use HSL scripting to speed up creating constraints. For information and examples, see attach in HSL scripting with Vicon Shogun.
Another way to speed things up is to mirror the changes you make to one side of the source and target skeletons onto the other side. See Mirror constraints and Mirror joint manipulation.
You can alter multiple constraint weights in the table on the Retargeting tab.
To enable you to immediately see the changes you're making, in the toolbar at the top, ensure the Enable interactive retargeting button is selected (green).
You can also select or clear Active to turn constraints on or off.
To check targets, ensure that the View Filters option for Constraints (for Retarget) is selected.
Set weights for all rotations. The recommended value for Rotation weights is 200. To set multiple rotations to 200, on the Retargeting tab, drag to select the required rows in the table and then in the Weight column, set the value of one of them to 200.
All the selected rotation weights are updated to 200.
Tip: If you want to automatically copy your changes to weights from one side of the skeleton to the other, ensure the Mirror Weight Changes option is also selected (see Mirror weights).
To add keys, select the relevant line(s), right-click and select Set Key.
To fine-tune keyframes, you can use the controls in the Graph view. For example, you can use the right-click (context) menu in the Graph view to to cut or insert sparse keys. You can also change the time of a key by clicking and dragging on the Graph view.To save the VSR mapping file, at the top right of the Retargeting tab, click the Save button.
By default, VSR files are saved to C:\Users\Public\Documents\Vicon\Retargets.
For information on the relevant HSL commands, see the following commands in HSL Scripting with Vicon Shogun.
Mirror constraints
To make the creation of retargeting constraints faster and less error-prone, you can choose to mirror the changes you make to one side of the source and target skeletons onto the other side.
The same option enables you to mirror edits to retargeting constraints.
To mirror retargeting constraints:
In the Subject Setup panel, click the Regargeting tab.
When you create or edit retargeting constraints, at the top of the Constraints section, ensure the Mirror Creation check box is selected (the default setting).
The constraints created between the source and target skeletons on one side are automatically mirrored on the opposite side.
Mirror joint manipulation
When posing a target or source skeleton during retarget setup, you often need to make the same adjustment to each side. To speed up pose adjustments, you can automatically mirror the change you've made to one side to the other side. You can use the same mirroring option when setting up a solve to mirror changes to the pose or bone length. A new button in the manipulator toolbar enables you to do this.
To mirror changes to the pose or bone length of a skeleton:
In the Manipulator toolbar on the left of the view pane, ensure the Mirror manipulation button is selected (green). When you create or make changes to one side of the subject, they are automatically copied to the other side.
Mirror weights
When you're adding or editing weights, you can use the mirroring option, Mirror Weight Changes, to make the same changes on both sides of the skeleton simultaneously.
To mirror weight constraints:
In the Subject Setup panel, click the Regargeting tab.
At the top of the Constraints section, ensure the Mirror Weight Changes check box is selected (the default setting).
When you adjust the weight values between the source and target skeletons on one side, they are automatically mirrored on the opposite side, so that weight values adjusted between, for example, the left lower arm on the source and target skeletons, are mirrored on the right lower arm of the source and target skeletons.