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.