Template Match

Requirements

Input Streams: Mesh Stream

Output Streams: Modified Mesh Stream (Stabilized)

Overview

Note

Stabilize Mesh uses a complex ‘Deformation’ algorithm to produce new poses. For in depth information on deformation, see the Deformation algorithm page.

Template Match is a more directable way to run the Non Rigid Deformation process used in Stabilization.

Template Match 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 Template Match 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 polygon count between 10,000 and 30,000 triangles. Higher triangle counts are supported, but compute hour costs may increase dramatically. For higher triangle count meshes, start with a higher Sample Radius Factor.

Parameters

Note

For the most part, Template Match shares the same parameters as the Stabilize Mesh Stage, excluding Segment Max Error, since a template match interval will always contain a single segment. This section only contains parameters unique to Template Match.

  • 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.

Warning

The experimental “carryFrame” setting is not supported on Template Match Stages as of HoloEdit 2021.1

Working with Template Match

Important

Like the other Deformation stage, Stabilize Mesh, Template Match uses the first mesh stream that does not already contain stabilization data. Because of this, successive Stabilize Mesh or Template Match stages are not culmulative.

The Template Match stage can be a powerful tool to 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 Template Match stage to 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 both.

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 Template Match process.