Removes the operating system's text to speech software from memory.
# Metadata
Platforms: desktop, server OS: mac, windows Introduced: 2.0 Security:
# Syntax
revUnloadSpeech
# Examples
revUnloadSpeech
if field "Speak Next" is empty then revUnloadSpeech
# Description
Use the revUnloadSpeech command to free up memory when you're done using the Speech library.
The operating system loads its text-to-speech software into memory when it's needed by any of the commands and functions in the Speech library. The revUnloadSpeech command lets you unload this software, freeing up the memory it uses, when you're done.
If your application uses text to speech, you should execute the revUnloadSpeech command either when your application is finished using text to speech, when the stack that uses text to speech is closed (in a closeStack handler), or when your application quits (in a shutdown handler). The revUnloadSpeech command must be executed at shutdown if not before in order for the application to close.
>*Important:* The revUnloadSpeech command is part of the > Speech library. To ensure that the command works in a > standalone application, you must include this > LiveCode custom library when you create your > standalone application. In the Inclusions pane of the > Standalone Application Settings window, make sure the "Speech" > library checkbox is checked.
# Tags
# See
- **library:** Speech library - **message:** closeStack, shutdown - **command:** unload, revLoadSpeech, revSpeak, revStopSpeech, revSetSpeechProvider - **object:** stack - **function:** hasMemory - **glossary:** LiveCode custom library, handler, Standalone Application Settings, standalone application, text to speech, command