Modules | Files | Inheritance Tree | Inheritance Graph | Name Index
module GNOME::Speech
interface EngineCentral
Files: GNOME_Speech.idl
GNOME-Speech-EngineCentral-inheritance GNOME-Speech-SpeechObject.html Bonobo-Unknown.html

Provides a list of EngineModeDesc objects that define the available operating modes of a speech engine.

Each speech engine registers an EngineCentral object with the ::GNOME::Speech::Central class. When requested by the Central class, each registered EngineCentral object provides a list with an EngineModeDesc object that describes each available operating mode of the engine.

The EngineModeDesc objects returned by in its list must implement the EngineCreate interface and be a sub-class of either RecognizerModeDesc or SynthesizerModeDesc. The Central class calls the createEngine method of the EngineCentral interface when it is requested to create an engine. (See EngineCreate for more detail.)

The engine must perform the same security checks on access to speech engines as the Central class.

Note: Application developers do not need to use this interface. EngineCentral is used internally by Central and speech engines.

See Also:
Central
EngineCreate
EngineModeDesc


Operations Summary:
 EngineListcreateEngineList(in EngineModeDesc require) raises

Operations Inherited from Bonobo::Unknown
ref, unref, queryInterface

Operation Details:
 EngineList createEngineList(in EngineModeDesc require) raises (SecurityException)

Create an EngineList containing an EngineModeDesc for each mode of operation of a speech engine that matches a set of required features. Each object in the list must be a sub-class of either RecognizerModeDesc or SynthesizerModeDesc and must implement the EngineCreate interface.

The Central class ensures that the require parameter is an instance of either RecognizerModeDesc or SynthesizerModeDesc. This enables the EngineCentral to optimize its search for either recognizers or synthesizers.

Returns null if no engines are available or if none meet the specified requirements.

The returned list should indicate the list of modes available at the time of the call (the list may change over time). The engine can create the list at the time of the call or it may be pre-stored.

Parameters:
require - an EngineModeDesc containing the feature set required.
Return:
an EngineModeList containing an EngineModeDesc for each mode of operation of a speech engine that matches the set of required features.
See Also:
EngineCreate
EngineModeDesc
::GNOME::Speech::Recognition::RecognizerModeDesc
::GNOME::Speech::Synthesis::SynthesizerModeDesc