GNOME Speech 0.4.25

1. Introduction
===============================================================================

This is GNOME Speech version 0.4.25.  It's purpose is to provide a
simple general API for producing text-to-speech output.  This version
of gnome-speech *should* be fine for GNOME 2.12 and greater.


2. Overview
===============================================================================

GNOME Speech 0.4 is made up of three basic parts:

	* IDL interface definitions
	* libgnomespeech - Convenience library for speech driver
	  development
	* Java package to aid in developing GNOME Speech drivers in
	  Java
	* Sample driver implementations


2.1: IDL Interface Definitions
===============================================================================

The IDL definitions are in the idl subdirectory.  GNOME Speech 0.4
defines three interfaces:

	* SynthesisDriver: Allows retrieval of general speech
	  synthesizer properties such as version number-- allows
	  the creation of speaker objects (see below).
	* Speaker-- the object used to produce speech-- contains
	  methods for speaking text and setting and retrieving the speech
	  parameters of the speaker object.
	* SpeechCallback-- an interface implemented by the GNOME
	  Speech to receive speech progress notifications.


2.2: libgnomespeech
===============================================================================

Libgnomespeech is a library which aids in GNOME Speech driver
development.  It provides convenience functions for specifying what
parameters are supported by a particular speaker object.


2.3 GNOME Speech Java Package
===============================================================================

If the Java SDK version 1.4.1 is detected when building GNOME Speech,
gnome-speech.jar is built.  This Java package requires code from the
java-access-bridge module, and is required to build GNOME Speech
drivers written in the Java(tm) programming language.


2.4: Sample Driver Implementations
===============================================================================

GNOME Speech 0.4 ships with driver source code for the following
synthesis engines.  This support also typically works with later
versions of the given engines, and the version numbers represent what
we had when we created the associated driver:

	* eSpeak 1.19
	* Festival Speech Synthesis System 1.4.2
	* FreeTTS 1.2
	* IBM ViaVoice TTS RTK 5.1
	* Speechworks ETI Eloquence SDK
	* DECtalk Software RT for Linux 4.61
	* Cepstral Theta 2.3
	* Cepstral Swift 4.1.4
        * Speech Dispatcher
        * Loquendo

The Festival driver has no build-time dependencies, and will be built
regardless of whether Festival is actually installed on your system.
The driver has been tested with Festival Version 1.4.2.  The only
requirement is that the festival binary be in the user's path.

Neither the eSpeak, DECtalk, IBM ViaVoice, Swift, nor Loquendo GNOME
Speech drivers will not be built unless their associated SDK is
installed.

To build the FreeTTS GNOME Speech driver, the Java SDK version 1.4.1
and FreeTTS version 1.2 are required.  If the javac binary can not
be found or is not in your path, you can specify the --with-java-home
option when configuring GNOME Speech to tell the build system where to
find the Java sdk.  In order to build the FreeTTS driver, you must
tell the build system where to find FreeTTS.   Use the
--with-freetts-dir configure option to do this.  Note, you should
specify the path to the directory under tthe FreeTTS root directory
which contains the FreeTTS jar files.

The GNOME Speech driver for the Fonix DECTalk runtime for Linux will
be built if the DECTalk libraries are found in the standard locations.
If the DECTalk software is installed in a nonstandard location, you
can specify the root of the DECTalk installation with the
--with-dectalk-dir                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       