com.sun.speech.engine.synthesis.text
Class TextSynthesizer

java.lang.Object
  com.sun.speech.engine.BaseEngine
      com.sun.speech.engine.synthesis.BaseSynthesizer
          com.sun.speech.engine.synthesis.text.TextSynthesizer

All Implemented Interfaces:

javax.speech.Engine, SpeechEventDispatcher, javax.speech.synthesis.Synthesizer

public class TextSynthesizer

extends BaseSynthesizer

Supports a simple text-output-only JSAPI 1.0 Synthesizer. Intended for demonstration purposes for those developing JSAPI implementations. It may also be useful to developers who want a JSAPI synthesizer that doesn't produce any noise.

Nested Class Summary

class

TextSynthesizer.OutputHandler The output device for a TextSynthesizer.

Field Summary

Fields inherited from class com.sun.speech.engine.synthesis.BaseSynthesizer

speakableListeners, voiceList

Fields inherited from class com.sun.speech.engine.BaseEngine

audioManager, CLEAR_ALL_STATE, engineListeners, engineModeDesc, engineProperties, engineState, engineStateLock

Fields inherited from interface javax.speech.synthesis.Synthesizer

QUEUE_EMPTY, QUEUE_NOT_EMPTY

Fields inherited from interface javax.speech.Engine

ALLOCATED, ALLOCATING_RESOURCES, DEALLOCATED, DEALLOCATING_RESOURCES, PAUSED, RESUMED

Constructor Summary

TextSynthesizer(javax.speech.synthesis.SynthesizerModeDesc desc)
Creates a new Synthesizer in the DEALLOCATED state.

Method Summary

protected void	appendQueue(BaseSynthesizerQueueItem item) Puts an item on the speaking queue and sends a queue updated event.
void	cancel() Cancels the item at the top of the queue.
void	cancel(java.lang.Object source) Cancels a specific object on the queue.
void	cancelAll() Cancels all items on the output queue.
protected BaseSynthesizerQueueItem	createQueueItem() Creates a TextSynthesizerQueueItem.
java.util.Enumeration	enumerateQueue() Returns an enumeration of the queue.
protected void	handleAllocate() Starts the output thread.
protected void	handleDeallocate() Stops the output thread.
protected void	handlePause() Pauses the output.
protected void	handleResume() Resumes the output.

Methods inherited from class com.sun.speech.engine.synthesis.BaseSynthesizer

addSpeakableListener, createEngineProperties, dispatchSpeechEvent, fireQueueEmptied, fireQueueUpdated, getSynthesizerProperties, getVoiceList, phoneme, postQueueEmptied, postQueueUpdated, removeSpeakableListener, speak, speak, speak, speakPlainText, stateToString

Methods inherited from class com.sun.speech.engine.BaseEngine

addEngineListener, allocate, checkEngineState, deallocate, fireEngineAllocated, fireEngineAllocatingResources, fireEngineDeallocated, fireEngineDeallocatingResources, fireEnginePaused, fireEngineResumed, getAudioManager, getEngineModeDesc, getEngineProperties, getEngineState, getVocabManager, pause, postEngineAllocated, postEngineAllocatingResources, postEngineDeallocated, postEngineDeallocatingResources, postEnginePaused, postEngineResumed, removeEngineListener, resume, setEngineModeDesc, setEngineState, testEngineState, toString, waitEngineState

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.speech.Engine

addEngineListener, allocate, deallocate, getAudioManager, getEngineModeDesc, getEngineProperties, getEngineState, getVocabManager, pause, removeEngineListener, resume, testEngineState, waitEngineState

Constructor Detail

TextSynthesizer

public TextSynthesizer(javax.speech.synthesis.SynthesizerModeDesc desc)

Creates a new Synthesizer in the DEALLOCATED state.

Parameters:

desc - the operating mode

Method Detail

handleAllocate

protected void handleAllocate()

Starts the output thread.

Specified by:

handleAllocate in class BaseEngine

See Also:

BaseEngine.allocate()

handleDeallocate

protected void handleDeallocate()

Stops the output thread.

Specified by:

handleDeallocate in class BaseEngine

createQueueItem

protected BaseSynthesizerQueueItem createQueueItem()

Creates a TextSynthesizerQueueItem.

Overrides:

createQueueItem in class BaseSynthesizer

Returns:

a TextSynthesizerQueueItem

enumerateQueue

public java.util.Enumeration enumerateQueue()
                                     throws javax.speech.EngineStateError

Returns an enumeration of the queue.

Specified by:

enumerateQueue in interface javax.speech.synthesis.Synthesizer

Specified by:

enumerateQueue in class BaseSynthesizer

Returns:

an Enumeration of the speech output queue or null.

Throws:

javax.speech.EngineStateError - if this Synthesizer in the DEALLOCATED or DEALLOCATING_RESOURCES states

appendQueue

protected void appendQueue(BaseSynthesizerQueueItem item)

Puts an item on the speaking queue and sends a queue updated event. Expects only TextSynthesizerQueueItems.

Specified by:

appendQueue in class BaseSynthesizer

Parameters:

item - the item to add to the queue

cancel

public void cancel()
            throws javax.speech.EngineStateError

Cancels the item at the top of the queue.

Specified by:

cancel in interface javax.speech.synthesis.Synthesizer

Specified by:

cancel in class BaseSynthesizer

Throws:

javax.speech.EngineStateError - if this Synthesizer in the DEALLOCATED or DEALLOCATING_RESOURCES states

cancel

public void cancel(java.lang.Object source)
            throws java.lang.IllegalArgumentException,
                   javax.speech.EngineStateError

Cancels a specific object on the queue.

Specified by:

cancel in interface javax.speech.synthesis.Synthesizer

Specified by:

cancel in class BaseSynthesizer

Parameters:

source - object to be removed from the speech output queue

Throws:

java.lang.IllegalArgumentException - if the source object is not found in the speech output queue.

javax.speech.EngineStateError - if this Synthesizer in the DEALLOCATED or DEALLOCATING_RESOURCES states

cancelAll

public void cancelAll()
               throws javax.speech.EngineStateError

Cancels all items on the output queue.

Specified by:

cancelAll in interface javax.speech.synthesis.Synthesizer

Specified by:

cancelAll in class BaseSynthesizer

Throws:

javax.speech.EngineStateError - if this Synthesizer in the DEALLOCATED or DEALLOCATING_RESOURCES states

handlePause

protected void handlePause()

Pauses the output.

Specified by:

handlePause in class BaseEngine

handleResume

protected void handleResume()

Resumes the output.

Specified by:

handleResume in class BaseEngine