# DECtalk Software for Digital UNIX
Programmer's Guide

March 1996

This manual provides information on installation, overview, getting started and step-by-step procedures for the DECtalk Software Runtime kit for the Digital UNIX product.

Revision/Update Information: This is a revised manual

Operating System: Digital UNIX 3.0, later

Software Product Version: 4.2A

Digital Equipment Corporation
Maynard, Massachusetts

#### Preface Chapter 1 Chapter 2 Chapter 3 Chapter 4 Chapter 5

- Preface: About this Guide
- Difference between Runtime and Development Kit
- License Requirements
- Features in DECtalk Software 4.2A
- Purpose and Audience
- Structure
- On-line Help
- Conventions

## Preface: About this Guide

This guide contains instructions for the installation of the DECtalk Software product. It also contains the tutorial and reference information you need to build a DECtalk Software application.

## What's the Difference Between the DECtalk Software Runtime Kit and the DECtalk Software Development Kit?

DECtalk Software is packaged as a Runtime kit and a Development kit. The Runtime kit gives you access to the following DECtalk Software applications: mailtalk, say, speak, emacspeak, and DECface. In order to develop your own DECtalk Software applications, you must order the DECtalk Software Developer's kit. DECtalk Software Developer's kit gives you access to the DECtalk Software API and some sample C programs.

## License Requirements

You can run one copy of any DECtalk Software application at a time without needing an LMF license. A license is required to run more than one copy of the Runtime kit or to use the DECtalk Software Development kit. See the section on LMF Licensing in Chapter 1 for more information.

## Features in DECtalk Software 4.2A

The following is a list of important features in DECtalk V4.2A:

- Expanded main dictionary

- Added user-dictionary suffix processing to help locate words in user dictionary

- Expanded pronunciation rules and improved pronunciation

- Homograph processing

- Improved inline index-mark processing

- Added the following inline commands:

- Play command to play audio files in line with text

- Tone command to generate tones

- Dial command to generate DTMF tones used to dial telephone numbers

- Stereo volume control commands

- A new version of the mailtalk program that is fully integrated with mail

- An enhanced Motif windows-based user dictionary builder that automatically translates text strings into phonemes

- An improved command-line program, say, used to run DECtalk from the Digital UNIX command line

  Improved computational efficiency

- Two new sample applications

  - DECface

  - Emacspeak

  - Support for CDE desktop environment

## Purpose and Audience

This guide is for the application programmer who wants to design and build text-to-speech applications with DECtalk Software. This guide contains instructions for installing DECtalk Software development subset. The installation procedure installs all files in subdirectories under the following directory with links to the system directory hierarchy: `/usr/opt/DTKDEV420`

### Structure

This guide is designed to provide you with quick and easy access to all information. You can easily learn about new topics and perform specific tasks related to running DECtalk Software application programs for the Digital UNIX operating system.

This guide's organization is listed below:

Chapter | Description Chapter 1 | Installing DECtalk Software
Chapter 2 | Introduction to DECtalk Software API
Chapter 3 | Using DECtalk Software Sample Programs
Chapter 4 | Creating a Customized DECtalk Software Voice
Chapter 5 | DECtalk Software API Functions

## On-line Help

DECtalk Software on-line help is accessible in two forms:

- Manpages --Invoke manpage help from the UNIX command line with the `%man speak` command

- HTML Hypertext -- Start Netscape hypertext help by launching Netscape and loading the DtkDevGuide.html file.

  ## Conventions

  This guide uses the following conventions:

      Convention      Explanation

              enter  Enter means type the required information
                     and press the Return key.
              mouse  Mouse refers to any pointing device, such
                     as a mouse, a puck, or a stylus.
                MB1  MB1 indicates the left mouse button
           click on  Click on means to press and release MB1.
       double click  Double click means to press and release
                     MB1 twice in rapid succession without
                     moving the mouse.
               drag  The phrase drag means to press and hold
                     MB1, move the mouse, and then release MB1
                     when the pointer is in the desired
                     position.
             Ctrl/x  A sequence such as Ctrl / x indicates
                     that you must press the Ctrl key while
                     you press another key.
       Menu Command  The right arrow key indicates an
                     abbreviated instruction for choosing a
                     command from a menu. For example, File
                     Exit means pull down the File menu, move
                     the pointer to the Exit command, and
                     release MB1.
       Courier type  Courier type indicates text that you type
                     and is displayed on the screen. This is
                     most often used for program code examples.
         User Input  Boldface type in interactive examples
                     indicates information you enter from the
                     keyboard. For example:
      	 % ls speak
             " xxx"  Indicates a word, words, or phrases you
                     must speak.

  Unless otherwise noted, press Return after entering commands or responses to command prompts.