Half-Life VOX/HEV presets (NetTTS VOX profile); docs

This commit is contained in:
Fisto
2026-09-21 11:17:30 +02:00
parent 4d1c31f1c9
commit 1cc18c812b
6 changed files with 200 additions and 0 deletions
+34
View File
@@ -387,6 +387,40 @@ Other NetTTS features and their relevance:
our prefix runs the engines with builtin Wine libraries.
- Win32 GUI and preset sliders: Veskslop provides the UI.
### Half-Life VOX / HEV presets
The Half-Life announcement voice (VOX / Black Mesa Announcement System) is the Flextalk
engine's **Keith Bell** voice with an adjusted speaker profile. NetTTS publishes an
approximation of Valve's settings (`scripts/winetricks/nettts_flextalk_vox_profile.reg`,
see its issues #53/#54/#67): the profile targets Keith Bell's speaker key and leaves
Kerry Watson at factory values. The wrapper implements it as a preset:
VESKSLOP_TTS_PRESET=vox # implies VOX prosody unless VESKSLOP_TTS_VOX is set
VESKSLOP_TTS_PRESET=hev # HEV suit starting point (see note below)
| Profile value | Factory (Keith) | VOX preset | HEV preset (approx.) |
| --- | --- | --- | --- |
| Pitch | 27 | 3 | 15 |
| Speaking Rate | 33 | 17 | 24 |
| Prominences | 17 | 22 | 22 |
| Head Size | 46 | 52 | 52 |
| Lowering | 40 | 40 | 40 |
| Volume | 100 | 70 | 70 |
| Expression | 59 | 59 | 59 |
- Presets apply only to `keith-bell`; every other voice keeps its defaults.
- Precedence: preset < `VESKSLOP_TTS_PROFILE` < `VESKSLOP_TTS_EXPRESSION`.
- Equivalent explicit override:
`VESKSLOP_TTS_PROFILE='pitch:3,rate:17,volume:70,prominences:22,head_size:52,lowering:40'`.
- The NetTTS profile also sets `Gender`, `Line Mode`, and a set of text-class DWORDs
(address/date/money classes, abbreviation expansion, and so on). Those affect text
normalization rather than the audible voice, so the wrapper does not write them.
- HEV suit: Half-Life 1 credits the suit sounds to Kelly Bailey; no settings were ever
published. The `hev` preset is a starting point (less extreme than VOX); tune pitch and
rate to taste. VOX prosody is optional there (`VESKSLOP_TTS_VOX=1`).
- Measured with the wrapper on the same line: VOX preset 5.83 s, HEV 3.79 s, factory
3.35 s (the VOX preset is slower and gains the VOX cadence).
### Inline rate/pitch controls (engine-side)
The wrapper consumes NetTTS-style, line-leading controls, so Veskslop and the WebUI do