Match Template Mesh¶
Overview¶
Important
As of HoloEdit 2023.1, this stage name has been changed from Template Match to Match Template Mesh.
Note
Match Template Mesh uses a ‘Deformation’ algorithm to produce new poses. For in depth information on deformation, see the Deformation algorithm page.
Match Template Mesh provides more control when running the deformation process used in stabilization.
Match Template Mesh stabilizes the entire selected interval rather than creating dynamic segments, and deforms every pose to a user specified “Template” mesh instead of an automatically determined Keyframe.
Important
The Match Template Mesh stage powers two workflows in one. When used with no Template Mesh provided, this stage is used to pick a specific frame in the Mesh Stream for use as a Keyframe, and ensure the entire Interval is stabilized to that frame.
With a Template Mesh provided, this stage uses that template mesh instead as a ‘keyframe’. This way, the stage can be used to introduce mesh changes or repairs to an animated clip.
Note
This stage should be run on a cleaned mesh stream, with degenerate triangles fixed, and a vertex count under 100k, for faster processing. Higher vertex counts are supported, but compute hour costs may increase dramatically. For higher vertex count meshes, start with a higher Sample Radius Factor.
Parameters¶
Note
For the most part, Match Template Mesh shares the same parameters as the Stabilize Mesh Stage, excluding Segment Max Error, since a Match Template Mesh interval will always contain a single segment. This section only contains parameters unique to Match Template Mesh.
Template Mesh: This field can be supplied any mesh by clicking and dragging an imported mesh file from a clip’s contents in the Project Panel. If a Template Mesh is provided, this mesh will be used as the Template in this stage.
Template Offset: If no Template Mesh is provided, the mesh from this frame will be used from the last pre-stabilized stage on the current track. This can optionally be set by clicking and dragging the keyframe marker on the current Interval.
Working with Match Template Mesh¶
Important
Like the other Deformation stage, Stabilize Mesh, Match Template Mesh uses the first mesh stream that does not already contain stabilization data. Because of this, successive Stabilize Mesh or Match Template Mesh stages are not cumulative.
The Match Template Mesh stage can help you make precise fixes to your stabilized clip. The Stabilize Mesh stage is powerful, but sometimes an individual artist carefully reviewing the results can make better choices. By using the Match Template Mesh stage you can create small intervals from a specific frame selected using the ‘Template Offset’ setting.
For example, you might find a better fit for a keyframe in a frame where the hand and arm are unique meshes, compared to a frame where the hand mesh was fused to the body.
Alternatively, by using the ‘Template Mesh’ setting, you can take a use a totally different mesh, such as one manually edited by an artist and then imported back into HoloEdit as a new clip. This way you can make precise adjustments to your data when necessary.
Please refer to the Deformation algorithm page for background information on the Match Template Mesh process.