Vietnamese
The Vietnamese language processor converts Vietnamese lyric tokens into a phoneme plan. It also provides one display parameter for Plan and Timing and five optional lexical-tone parameters for Pitch.
Planning
Section titled “Planning”The package relates a syllable’s written form, note ownership, and slur membership to an ordered phone sequence. The resulting plan remains visible in the editor. A manual phone override takes priority for the affected material.
Split phoneme
Section titled “Split phoneme”| Property | Value |
|---|---|
| Key | showPhoneSplits |
| Type | Boolean |
| Default | On |
| Modes | Plan and Timing |
When enabled, Split phoneme displays the expanded phone segments supplied by the Vietnamese package. When disabled, the editor uses the less detailed phone presentation. This parameter changes what is displayed; it does not replace the lyric or manual pronunciation.
Lexical tone
Section titled “Lexical tone”Vietnamese lexical tone is represented as a relative pitch contour over the voiced part of a syllable. The contour supplements the musical note; it does not change the written score pitch. Its audible effect depends on the melody, the cast, and the pitch contour already present in the bake.
Tone amount (cents)
Section titled “Tone amount (cents)”| Property | Value |
|---|---|
| Key | toneWeight |
| Type | Number |
| Range | 0–100 cents |
| Default | 25 cents |
| Step | 1 cent |
| Neutral | 0 cents |
When a voiced syllable carries Vietnamese tone information, Tone amount sets the peak relative pitch displacement. Rising and falling contours end at approximately the selected magnitude; a dipping contour reaches a valley at the negative magnitude. At 0, lexical-tone pitch shaping is off.
Increasing the value makes lexical tone more pronounced. If the musical line already supplies the intended direction, a high value can exaggerate the movement.
Nonlinear mode
Section titled “Nonlinear mode”| Property | Value |
|---|---|
| Key | nonlinear |
| Type | Boolean |
| Default | On |
| Condition | Tone amount is greater than 0 |
When enabled, tone movement uses an eased progression. When disabled, the movement is linear. The control changes the path of the contour without changing its selected peak amount.
Peak ease (%)
Section titled “Peak ease (%)”| Property | Value |
|---|---|
| Key | peakEase |
| Type | Number |
| Range | 0–100% |
| Default | 50% |
| Step | 1% |
| Condition | Nonlinear mode is on |
At 0%, nonlinear mode follows the linear shape. Increasing the value introduces more easing near the contour’s extremes. At 100%, the eased shape is fully applied. This parameter has no audible effect when nonlinear mode is off.
Valley time (%)
Section titled “Valley time (%)”| Property | Value |
|---|---|
| Key | valleyTime |
| Type | Number |
| Range | 5–95% of the syllable |
| Default | 55% |
| Step | 1% |
| Condition | The syllable uses a dipping hỏi contour and Tone amount is greater than 0 |
Valley time places the lowest point of the dip within the syllable. Lower values move the valley earlier; higher values move it later. Other tone shapes do not use this parameter.
Offtone compensation (%)
Section titled “Offtone compensation (%)”| Property | Value |
|---|---|
| Key | offtoneCompensation |
| Type | Number |
| Range | 0–100% |
| Default | 0% |
| Step | 1% |
| Neutral | 0% |
When the existing rendered pitch moves against the lexical-tone direction, Offtone compensation increases the tone contribution. At 0%, no additional compensation is applied. Increase it only when the melody or cast consistently weakens the intended direction; a high value can produce excessive movement.
Availability
Section titled “Availability”If automatic pronunciation is unavailable, open View → Plugins… and enable Vietnamese language processor, then choose Vietnamese from the voice card’s context-menu Language submenu. Other language packages may remain enabled for other voices.