Diagnostics and Troubleshooting

Diagnostics and Troubleshooting

Diagnostic files

• festival_path_diagnostics.txt records every Festival library candidate, required files, and the selected path.
• festival_singing_trace.txt records generated Scheme, voice selection, synthesis stages, playback stages, and HRESULT results.
• M11_DRAG_DIAGNOSTIC.log records Slicer Piano Roll mouse and drag state.

Festival cannot initialize

Confirm that init.scm, singing-mode.scm, Singing.v0_1.dtd, the selected voice, and its lexicon exist in the selected Festival library.

COM DLL cannot load

Confirm that the DLL and application are both Win32/x86 and that all required runtime dependencies are available.

Voice selection returns S_FALSE

The Windows COM wrapper may expose Festival procedures that return nil even after successful selection. The project uses a Boolean wrapper so a successful call returns S_OK.

No direct playback

Verify that Festival accepts (Parameter.set 'Audio_Method 'win32audio) and inspect the singing trace for the first failing step.

Missing project audio

Open Project Folder reports missing WAV paths. Restore the files in the project's audio directory or reimport and resave the source material.