SmoothBlendRigControls

Only in Wrap4D

Smoothes Blendshape Rig control values temporally.

Inputs

Blendshape Rig: BlendRig Input Blendshape Rig.

Output

Blendshape Rig: BlendRig Blendshape Rig with loaded and smoothed control values.

Parameters

File Name:

a sorce file path mask to load from. Supports Path Interpretation, must contain # symbols. You can read about file structure in Controls File Structure.

Neighbours:

number of frames in both directions which will affect the current frame.

Iterations:

number of iterations of smoothing algorithm. Increases number of frames required for computation.

Method:

smoothing method: Linear, Linear with Average Ratio, Gaussian.

Averaging Strength:

smoothing strength for Linear with Average Ratio method.

Gaussian Sigma:

smoothing strength for Gaussian method.

On Name Mismatch:

what to do if loaded controls differ from input Blendshape Rig controls.

Error: Stops with error.
Ignore Missed: Error on extra controls. Any missing loaded controls preserve their values from input rig.
Ignore New: Error on missing controls. Any extra loaded controls are ignored.
Ignore Both: Never stops with error, extra controls ignored, missing preserved.

Include Controls:

whitelist of control names to smooth, separated by comma. Example: JawOpen, Funnel, Blink.

Exclude Controls:

blacklist of control names, separated by comma. The values of these controls are loaded from the file without smoothing.

Note

Blacklist overrides whitelist. If each list contains one control name, this control value will not be smoothed. If the control name is not on any of the lists, this control will be excluded.

Note

In whitelist and blacklist control name depends on the order of the suffixes. For example, if you will write Jaw_L_Left, it will not select Jaw_Left_L control value.

Tip

You can use special characters to simplify whitelist and blacklist. ? equals to one arbitrary character. For example Jaw_?_Left selects Jaw_L_Left and Jaw_R_Left control values. * equals to any number of arbitrary characters. For example Jaw* selects each control value, starting with Jaw: JawOpenExtreme, Jaw_R_Left, JawOpen, Jaw_Right_L; * list value selects all control values.

Frame:: Scripted frame number, by default equals to the current frame number (starts from zero).

Visual Editor

The visual editor displays a list of output Blendshape Rig controls. In the visual editor, special controls are highlighted:

Smoothed control are white.
Excluded controls are gray.