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

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:

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:
ChapterDescription
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.