)

---

The voiceinfo( function returns information about a speech synthesis voice.

---

Parameters

This function has one parameter:

voice – name of the voice. Note: This name is case sensitive – some names are all lower case, and some begin with an initial capital letter. Use the info(“voices”) function to get a list of all available voices.

---

Description

This function returns information about a speech synthesis voice. The information is returned as a dictionary.

dumpdictionaryquoted(voiceinfo("amelie")) ☞ 

        VoiceLocaleIdentifier="fr_CA"
        VoiceGender="VoiceGenderFemale"
        VoiceIdentifier="com.apple.speech.synthesis.voice.amelie"
        VoiceVersion="4.0.5"
        VoiceLanguage="fr-CA"
        VoiceName="Amelie"
        VoiceDemoText="Bonjour, je m’appelle Amelie. Je suis une voix canadienne."
        VoiceAge="35"
        VoiceNameRoot="Amelie"
        VoiceGroup="VoiceGroupCompact"

The exact information returned will vary for different voices, but it should always include the gender, identifier, version, language and name.

This example will cause the computer to say Isn’t it nice to have a computer that will talk to you? in a female voice.

local theVoice
theVoice = "Victoria"
speak getdictionaryvalue(voiceinfo(theVoice),"VoiceDemoText"),"voice",theVoice

---

See Also

• info("defaultvoice") -- returns the current default system voice.
• info("speaking") -- returns true if talking is occuring right now.
• info("speechrate") -- returns the current Panorama speech rate (words per minute).
• info("speechvoice") -- returns the current default system voice.
• info("speechvolume") -- returns the current Panorama speech volume.
• info("voices") -- returns a list of available speech synthesis voices on this system.
• pausespeaking -- pauses any talking that is currently happening.
• resumespeaking -- resumes speaking after a pause.
• speak -- speaks a word or phrase.
• speakaddress -- buffers up a street address to be spoken later by the speaknow statement.
• speakcharacters -- buffers up one or more characters to be spoken later by the speaknow statement.
• speakcharactersslowly -- buffers up one or more characters to be spoken later by the speaknow statement. Instead of speaking words, each individual character is spoken separately and slowly.
• speakdate -- buffers up a date to be spoken later by the speaknow statement.
• speakdigitpairs -- buffers up one or more digit pairs to be spoken later by the speaknow statement.
• speakdigits -- buffers up one or more digits to be spoken later by the speaknow statement.
• speakdollars -- buffers up a dollar amount to be spoken later by the speaknow statement.
• speakdollarsandcents -- buffers up a dollar and cents amount to be spoken later by the speaknow statement.
• speakletters -- buffers up one or more characters to be spoken later by the speaknow statement. Letters will be spoken individually, as upper or lower case. Numbers will be spoken as individual digits.
• speaknow -- speaks any buffered speech.
• speakphonenumber -- buffers up a phone number to be spoken later by the speaknow statement.
• speakscript -- speaks a speech synthesis script created in the Database Options dialog.
• speakstate -- buffers up a US State to be spoken later by the speaknow statement.
• speakthisrecord -- speaks the current record in the database (using the default speech script).
• speakwords -- buffers up one or more words to be spoken later by the speaknow statement.
• speechrate -- changes the speech rate (words per minute).
• speechscripts -- returns a lists of speech scripts in a database.
• speechvoice -- changes the default speech voice.
• speechvolume -- changes the default speech volume.
• stopspeaking -- stops any talking that is currently happening.

---

History

Version	Status	Notes
10.0	New	New in this version.