Effect Faces
Drives singing-face models, mapping phonemes (fixed or from a timing track) and eye state onto the model's defined face nodes/images.
| Parameter | Type | Range | Description |
|---|---|---|---|
| Mouth Movements | custom control | Phoneme: AI, E, FV, L, MBP, O, U, WQ, etc, rest, (off); or Timing Track: (timing tracks in sequence) | Radio-button choice between two paired dropdowns: pick Phoneme for a single fixed mouth shape, or pick Timing Track to drive the mouth automatically from phoneme labels on the selected timing track |
| Face Definition | dropdown | (face definitions on the model) | Which face definition on the model to use; face definitions map phonemes to specific nodes or image files |
| State (Eyes) | dropdown | Open, Closed, Auto, (off) | Eye rendering state: Open keeps eyes always open, Closed keeps them shut, Auto adds periodic random blinking (blinks occur during rest or (off) phonemes), (off) disables eye rendering |
| Blink Frequency | dropdown | Slowest, Slow, Normal, Fast, Fastest | How often automatic blinks occur; only enabled when State (Eyes) is Auto |
| Blink Duration | dropdown | Short, Normal, Long, Longer | How many frames each automatic blink stays closed; only enabled when State (Eyes) is Auto |
| Show outline | checkbox | true/false | Also draws the face outline nodes, using the model's defined outline node group |
| Suppress shimmer | checkbox | true/false | Prevents the shimmer animation on phoneme shapes defined with a shimmer suffix in the face definition |
| Use State as outline | dropdown | (State effect definitions in the sequence) | Selects a State effect definition to use as the face outline instead of the default outline; only enabled when Show outline is checked |
| Suppress when not singing | checkbox | true/false | Hides the entire face (including outline) during rest phonemes or when no phoneme is active; requires a Timing Track |
| Lead In/Out Frames | spinner | 0-1000 | Number of frames to fade/hold in before the first phoneme and out after the last phoneme on the timing track; only enabled when Suppress when not singing is checked |
| Fade during lead in/out | checkbox | true/false | Fades face brightness gradually during the lead-in/out frames instead of an abrupt appear/disappear; only enabled when Suppress when not singing is checked |
| Transparent Black | custom control (checkbox + slider) | 0-300 | Checkbox that keys out face image pixels below a brightness threshold as transparent, paired with a slider/text field (0-300) setting that threshold |
- Show outline enabled -> enables Use State as outline.
- State (Eyes) = Auto -> enables Blink Frequency and Blink Duration.
- Suppress when not singing enabled -> enables Lead In/Out Frames and Fade during lead in/out.
- Settings are grouped in the panel into a "Mouth Movements" section, an "Eyes" section (State, Blink Frequency, Blink Duration), and the Transparent Black row.
Define face layouts in the model's Faces properties tab, mapping phonemes to nodes or images. Use a Timing Track with phoneme-labeled marks (e.g. from imported lyric/phoneme data) for automatic lip-sync instead of a single fixed Phoneme.
Last updated: 2026-07-01