Settings: Filter

Basic preset selection and advanced filter detailed settings.

The filter settings in this tab are applied uniformly regardless of the Actor mode selected, as well as during the execution of Generate Facial Data and Batch Generator Window.

Parameters can be adjusted while Actor mode is running, and changes are applied immediately when the Apply button is pressed.

Preset Selection

Preset : Stable
- All settings except for the Preset selection are disabled.

Unlike other modes, this mode operates at a stage prior to BlendShape measurement and does not use other parameters. For standard webcams rather than specialized capture devices, manual filter adjustment may be challenging due to inherent noise. This mode is generally recommended when fast lip movement is not a critical factor.

Preset : Responsiveness, Balanced, Noise Control
- These presets represent a trade-off between responsiveness and noise reduction, categorized as responsiveness-focused, balanced, and noise-focused.

Designed primarily for typical webcams, each setting may require slight adjustments by sliding from right to left to improve responsiveness.

Preset : Custom_Ex01, Custom_Ex02
- Two preset Filter slots prepared as examples of user-defined settings.

Preset items can be added with new names. The six items listed above can have their parameters modified or reset to default, but they cannot be deleted

Terminology Explanation

The terms Live Filter, Post CSV Filter, and Secondary Filter are explained below. The Live Filter is used for both real-time processing and CSV data file generation, while the Post CSV Filter applies only during CSV file creation. To provide flexible adjustment for BlendShapes with varying noise characteristics, both filters are divided into two separate parameters. The second parameter is referred to as the Secondary Filter.

Live Filter

Static Noise : Smoothing level (window size) for reducing static noise
Static Range : Noise threshold to trigger smoothing filter
Dynamic Noise : Kalman filter sensitivity settings (Q, R) for dynamic noise

The Live Filter operates in two stages, utilizing a Moving Average and a Kalman Filter. The Moving Average is selectively applied based on the BlendShape’s rate of change—the difference between previous and current values. When movement is significant, only the Kalman Filter is active. For small, stationary noise components known as jitter, which fall below a defined static range, the Moving Average filter is applied. This approach ensures responsive performance while effectively suppressing jitter noise.

Live Secondary Filter

Use 2nd Filter : Enable or disable the Secondary Filter.
Highlight Selected BlendShapes
BlendShapes affected by the second filter are highlighted in yellow within the Value Pane. This helps identify BlendShapes filtered based on the Selection Keywords.
Selection Keywords
Enter BlendShape selection keywords, separated by commas, to specify which BlendShapes the Secondary Filter applies to.

Post CSV Filter

Cutoff Frequency : Cutoff frequency for smoothing filter

A bidirectional Butterworth filter is applied to ensure zero delay.

Post CSV Secondary Filter

CSV Export Filter

Live : Generate CSV output files using the Live filter.
Post CSV : Generate CSV output files using the Post CSV filter.

When both options are enabled, two CSV files are generated simultaneously, with the suffixes "_live" and "_post" appended to the filenames.

During real-time processing, FPS may temporarily drop depending on your PC. Data streaming continues, but saving data files simultaneously is not supported. Checking the Live option in the CSV Export Filter helps you review filter tuning results during real-time use.

Preset Management

Preset name : Enter a name for the new preset.
Save : Save the current settings to the selected preset.
Add : Add a new preset.
Reload : Discard changes made before pressing Apply and reload the previous settings.
Init : Reset parameters to their default values.
Delete : Delete user-added presets, excluding the six default presets.

PreviousSettings: Actor NextSettings: Experimental

Last updated 4 days ago