The Configuration file  -  APOLLO2.INI
 
NOTE: The drivers on this disk are set up for use with Open Book, Version
2.2 or greater. Open Book expects of find the speech synthesizer drivers
in the drive and directory selected during installation. Typically this
is C:\OPENBOOK. If you have selected a different drive and path you 
must edit the APOLLO2.INI file and change the command line:

	dictionarypath=C:\OPENBOOK 

to equal the drive and path selected during installation. For example, 
if you installed Open Book in D:\OCEANIC, the "dictionarypath" command line
in APOLLO2.INI must be changed to:

	dictionarypath=D:\OCEANIC

If you are going to use your Dolphin speech synthesizer with 
Atlas Speaks version 1.0, you will need to edit the APOLLO2.INI file 
and change the directory path in the same way. Atlas Speaks expects to 
find the speech synthesizer drivers in the driver and directory selected
during installation. Typically this is C:\ATLAS. If you have selected a 
different drive and path you must edit the APOLLO2.INI and change the 
command line:

	dictionarypath=C:\ATLAS

to equal the drive and path selected during installation. See the example 
above.

If you are using both Atlas Speaks and Open Book, you will have to make
the changes in both installation directories.

NOTE: You need only read this section if want to use more than one language 
with your synthesiser, or you want to change the basic settings, such 
as the port where you have your synthesiser connected. 

Without a configuration file the driver will default to COM1:, have 
no dictionaries, no phoneme support, one preset voice, and only 
let you use one language.

The configuration file contains a number of sections containing 
many parameters.  You can change each parameter by editing the 
file with a text editor.  Some parameters are vital, some are not.

SAMPLE DRIVER. This basic driver (APOLLO2.INI) is found in each of the 
Dolphin speech synthesizer directories.  The explainations for each
section and parameter that you need to modifiy is explained in comments
in the driver and explained in detail after the driver listing. This 
driver is set for US English in ROM1 and Spanish in ROM2.


 ;apollo driver information.
 ;apollo driver config file v1.2                 30/6/93
 ;Arkenstone modifications                       10/2/94
 ;This driver is set up for: 
 ;U.S. English as the primary menu and reading voice
 ;Spanish is the second reading voice.
 
 [apollo driver]

 ;type selection = com, lpt, europa, ...
 ;This driver DOES NOT support parallel port comms.
 ;The Apollo II MUST be connected to a COM port
 ;The Europa II PC-CARD is also supported
 
 ;type should be either "com" or "europa". These are case-sensitive.

 Type=com

 ;COM/LPT port number

 PortNumber=1

 ;Baudrate (com port only) - rates allowed are 300, 1200, 9600 and 19200
 ; Make sure that your apollo 2 is set to the same rate.

  Baudrate=9600

 ;Europa 2 PC-Card port number in decimal.
 ;Default port = 776.   In hexadecimal that is 308

 CardPort=776

 ;rom information
 ;romxid it is the standard telephone country code.
 ;romxid must be 4 digits (the 1st digit is a spare one for expansion), the 
 ;romxid is padded with zeros.
 ;romxstring is the name of the language of the ROM.

 ;romxstring is not essential, but useful for menu driven rom switching
 ;the text entered in the romxstring will appear as the prompt
 ;in the application

 rom1id=0001
 rom1string=U.S. English

 rom2id=0034
 rom2string=Spanish

 ;NOTE: To set the default voice for Open Book, you must edit the settings
 ;file (DEFAULT.INI) and set the "Language=" entry to point to the appropriate
 ;rom id.  Remember that Open Book menu items are numbered starting from 0,
 ;rather than 1.  Thus, to change the menu voice for Open Book to Spanish,
 ;find the [Menu Voice] section, and make sure the language entry is set to
 ;"Language=1".  This makes Open Book use rom number 2 for its menu voice,
 ;which should be Spanish in this case.

 ;What follows are additional rom#id and rom#strings for additional 
 ;To make active delete the ";" which proceeds the string and change #
 ;for the number of the ROM socket, which contains the ROM for that language
 ;The sequence of rom#id and rom#strings in this file must match the
 ;sequence/position of the ROM in your Apollo2
 ;The U.S. English example above means that you have only one ROM, it is
 ;U.S. English and it is in ROM socket number one and it is the only ROM in
 ;the Apollo2. If you have additional ROMs you must activate the appropriate
 ;rom#id and rom#strings in the proper sequence. To activate an additional
 ;language, delete the ; which proceeds each string and replace the # with 
 ;the number of it's ROM socket.
 
 ;rom#id=0044
 ;rom#string=U.K. English

 ;rom#id=0045
 ;rom#id=Danish

 ;rom#id=0031
 ;rom#string=Dutch

 ;rom#id=0033
 ;rom#string=French

 ;rom#id=0049
 ;rom#string=German

 ;rom#id=0039
 ;rom#string=Italian

 ;rom#id=0047
 ;rom#string=Norwegian

 ;rom#id=0351
 ;rom#string=Portuguese

 ;rom#id=0046
 ;rom#string=Swedish

 ;Exceptions dictionary, number and phoneme file names

 ;For ROM1, U.S. English
 ; No C:\WINDOWS\0001.DIC file exists for U.S. English
 ; No C:\WINDOWS\0001.NUM file exists for U.S. English 
 ; No C:\WINDOWS\0001.PHO file exists for U.S. English

 ;For ROM2, Spanish
 ; No C:\WINDOWS\0034.DIC file
 ; No C:\WINDOWS\0034.PHO file

 ;Note: The dictionary, number and phoneme file must be in the Windows 
 ;directory
 
 dictionarypath=c:\windows\

 ;SSIL specific information - used by ssil-synd translator - apollo.c
	
 [apollo ssil]

 ;number of preset voices. All preset sections are [apollo preset #]
	
 presets=5


 ; the default voice - presets are created with these parameters
 ; that are then modified. This is also the apollo default power on state

 [apollo default]
 name=Voice 1
 outputmode=0
 language=1
 rate=3
 volume=15
 pitch=8
 intonation=4
 punctuation=0
 wordpause=0
 phrasepause=11
 spellmode=0
 breath=8
 hypermode=0
 markspace=10
 gender=1
 voicesource=0

 ;NB language parameter is a virtual language number, 1 to # of roms fitted
 ;it is mapped by the driver into the actual rom number (as used by @= )
 ;the mapping process misses out any non-existent roms.
 ;EG if you only have a 4-language big rom, addressed with @=1/5/6/7
 ;you use language=1/2/3/4 respectively.

 ;presets - supported parameters and values allowed in preset sections

 ;name=string    string is max 32 characters please!

 ;COMMAND          RANGE                           APOLLO COMMAND
 ;language=n     0 to #of roms installed             @=
 ;rate=n         0 to 15                             @W
 ;volume=n       0 to 15                             @A
 ;pitch=n        0 to 15                             @F
 ;intonation=n   0 to 7                              @R
 ;wordpause=n    0 to 9                              @Q
 ;phrasepause=n  0 to 15                             @D
 ;breath=n       0 to 9                              @B
 ;hypermode=n    0 to 1                              @H
 ;markspace=n    10 to 35                            @M
 ;gender=n       1 to 6    (1-3 male, 4-6 non-male)  @V/@F/@M/@B
 ;voicesource=n  0 to 7                              @$
 ;spellmode      0 to 1                             N/A - done in driver

 [apollo preset 1]
 name=Voice 2
 gender=2

 [apollo preset 2]
 name=Voice 3
 gender=3

 [apollo preset 3]
 name=Voice 4
 gender=4

 [apollo preset 4]
 name=Voice 5
 gender=5

 [apollo preset 5]
 name=Voice 6
 gender=6

Explainations:

Section headers are surrounded in square brackets.  You should not 
change these except when defining preset voices. Parameters are 
denoted as label=value.  The label for each parameter is case insensitive.  
Make sure that you keep the parameters within the correct section.  
Comments (lines which are ignored by the system) start with a semi-colon.

[apollo driver]

This section contains the Apollo 2 hardware configuration.  You would 
only need to change the parameters in this section if you change the 
port your Apollo 2 is connected to, or want to use An Open Book with 
languages other than U.K. English.

Type=

This determines which type of Dolphin Synthesiser you have and where 
it is plugged in.  For the Apollo 2 synthesiser select Type=com.  
For the Europa 2 synthesiser select Type=europa. The parallel port 
connection for the Apollo 2 is not supported.

PortNumber=

Select the Apollo 2 port number.  This is the COM port number.  It can 
be in the range 1-4.

Baudrate=

This applies when a synthesiser is attached to a COM port.  The 
default setting of 9600 will need to be altered if you have changed 
the baud rate in the Apollo 2 with a special baud rate selection lead.  
It is recommended that the minimum baud rate you use is 9600.  
If you change the driver's baud rate you must also change the Apollo 2's 
baud rate. You may select 300, 1200, 9600 or 19200.

CardPort=

This is the card port address of the Europa 2 PC Card. The value is 
in decimal. Refer to your synthesiser manual for more information 
about the card address.

rom1id=

This tells the driver which language you have installed in ROM slot 
1 inside your synthersiser.  The code must be 4 digits and contain 
the relevant international country (dialling) code, e.g. 0044 for English.  
The language code is used to locate the correct Exceptions, Numbers and 
Phoneme files when you change languages.  If you have a big 2 or 4-language 
ROM then you should treat each language as a separate slot, each with a 
different slot number.  Make sure that you give the correct slot number 
so that you don't try to select a non-existent language.  If you try to 
switch to a language that has not been set up in this way, then no 
switch will occur and you will stay with the currently selected language.  
Similarly, if you set up a language that you do not have, and then try 
to switch to that language, then no switch will occur and you will stay 
with the currently selected language.  Refer to your synthesiser manual 
for ROM slot numbering.

rom#id=

This tells the driver which language you have installed in ROM slot 
number #.  See above.

dictionarypath=

This tells the driver where to find the Exceptions, Numbers and 
Phoneme mapping files.  The default is either c:\apollo2\ or c:\windows\ 
depending on which version of An Open Book you are using.
 
If you move these files to somewhere else, edit this line to tell the 
driver where.  Remember to put a backslash at the end of the path.  
The install program places the Apollo 2 support files on the same disk 
as your Windows directory and will set this parameter automatically.

[ssil driver]

This section contains information particular to the driver.  You need 
only change the parameters in this section if you wish to define new 
voices, in addition to the six preset voices.

presets=

This is the number of preset voices that you have defined in this file.  
You can define up to 15 extra preset voices, as well as the six default 
voices. For example, you may wish to make a female voice read out menu 
options and a male voice read out the text that is scanned in.  
Make sure that you change this value if you add or delete any preset voices.  This number only includes voices declared as [apollo preset n] and does not include the default voice (which is preset 0).

[apollo default]

This defines the speed, pitch, volume, intonation level and breathiness 
of the default synthersiser voice.  All other preset voices are based 
on this one.  When you define a preset voice, any parameters that you do 
not specify will be taken from this section.  See the Series 2 Synthersiser 
User Guide for a description of what each parameter does.  
Most parameters are equivalent to an @ ('at') command.

DO NOT change these values, as they tell the driver what state the 
synthesiser is in when it is switched on.

[apollo preset #]

This section defines one preset voice.  Preset voices are numbered 
consecutively from 1 up to the value specified in the presets= parameter.

The # should be replaced with the preset voice number. 

Each preset voice is defined by starting with the default voice, and 
changing one or more parameters.  Thus, you only need to put a parameter 
in a preset section if it is different from the default voice.

Parameter cross-reference

This table lists each parameter, its allowed range and the equivalent 
Apollo @ ('at') command.  See the Series 2 Synthesiser User Guide for a 
detailed description of how each command affects the voice.

;COMMAND          RANGE                           APOLLO COMMAND
;language=n     0 to #of roms installed             @=
;rate=n         0 to 15                             @W
;volume=n       0 to 15                             @A
;pitch=n        0 to 15                             @F
;intonation=n   0 to 7                              @R
;wordpause=n    0 to 9                              @Q
;phrasepause=n  0 to 15                             @D
;breath=n       0 to 9                              @B
;hypermode=n    0 to 1                              @H
;markspace=n    10 to 35                            @M
;gender=n       1 to 6    (1-3 male, 4-6 non-male)  @V/@F/@M/@B
;voicesource=n  0 to 7                              @$
;spellmode      0 to 1                             N/A - done in driver

Where:  b       is a binary number
		o       is an octal number
		h       is a hexadecimal number
		d       is a decimal number


