|SYNTAX||Say(''text'', purge = True)|
|FUNCTION|| Say() function speaks user-specified text (Windows XP, on lower-end Windows you need to install Microsoft Speech API, voice settings are in Windows Control Panel)
New in 5.20 - 'purge' parameter
when purge is set to True (the default) - any call to Say() purges all previous speak requests (queued or in-progress) and speaks specified text immediatelly.
when purge is set to False - speak request is queued and will be spoken right after previous requests are done.
Also now Say() function returns the NUMERIC value that indicates how many speak requests are pending
CAVEAT: Creative SoundBlaster X-Fi cards have a driver problems on Windows 7 and Windows Vista causing memory leak in audiodg.exe process (Windows Audio) when using audio output (esp. Say command). To workaround this X-Fi driver problem, do the following:
The Say function is used in the following formulas in AFL on-line library:
See updated/extended version on-line.