| Operations Summary: | |
| float | getPitch() |
| float | getPitchRange() |
| float | getSpeakingRate() |
| Voice | getVoice() |
| float | getVolume() |
| void | setPitch(in float hertz) raises |
| void | setPitchRange(in float hertz) raises |
| void | setSpeakingRate(in float wpm) raises |
| void | setVoice(in Voice voice) raises |
| void | setVolume(in float volume) raises |
| Operations Inherited from EngineProperties | |
| addPropertyChangeListener, getControlComponent, removePropertyChangeListener, reset | |
| Operations Inherited from Bonobo::Unknown | |
| ref, unref, queryInterface | |
| Operation Details: |
Get the baseline pitch for synthesis.
setPitch Get the pitch range for synthesis.
setPitchRange Get the current target speaking rate.
setSpeakingRate
Get the current synthesizer voice. Modifications to the returned
voice do not affect the Synthesizer voice - a call
to setVoice is required for a change to take effect.
setVoice Get the current volume.
setVolume Set the baseline pitch for the current synthesis voice. Out-of-range values may be ignored or restricted to engine-defined limits. Different voices have different natural sounding ranges of pitch. Typical male voices are between 80 and 180 Hertz. Female pitches typically vary from 150 to 300 Hertz.
getPitch Set the pitch range for the current synthesis voice. A narrow pitch range provides monotonous output while wide range provide a more lively voice. This setting is a hint to the synthesis engine. Engines may choose to ignore unreasonable requests. Some synthesizers may not support pitch variability. The pitch range is typically between 20% and 80% of the baseline pitch.
getPitchRange Set the target speaking rate for the synthesis voice in words per minute.
Reasonable speaking rates depend upon the synthesizer and the current voice (some voices sound better at higher or lower speed than others).
Speaking rate is also dependent upon the language because of different conventions for what is a "word". A reasonable speaking rate for English is 200 words per minute.
getSpeakingRate Set the current synthesizer voice.
The list of available voices for a Synthesizer is
returned by the getVoices method of the synthesizer's
SynthesizerModeDesc. Any one of the voices returned
by that method can be passed to setVoice to set the
current speaking voice.
Alternatively, the voice parameter may be an application-created
partially specified Voice object. If there is no
matching voice, the call is ignored.
getVoice
SynthesizerModeDesc
Engine#getEngineModeDesc Set the volume for the synthesizer's speech output as a value between 0.0 and 1.0. A value of 0.0 indicates silence. A value of 1.0 is maximum volume and is usually the synthesizer default.
A synthesizer may change the voice's style with volume. For example, a quiet volume might produce whispered output and loud might produce shouting. Most synthesizer do not make this type of change.
getVolume