D E C t a l k "!    S o f t w a r e   
 
 P r o g r a m m e r ' s   G u i d e 
 
 
 
 A p r i l     1 9 9 8 
 
 
 
 T h i s   g u i d e   c o n t a i n s   a n   i n t r o d u c t i o n   t o   D E C t a l k   S o f t w a r e   a n d   t h e   D E C t a l k   S o f t w a r e   A P I . 
 
 
 
 
 
 
 
 
 
 
 
 R e v i s i o n   a n d   U p d a t e   I n f o r m a t i o n : 
 
 
 
 O p e r a t i n g   S y s t e m : 	 M i c r o s o f t   W i n d o w s   9 5 
 
 	 M i c r o s o f t   W i n d o w s   N T 
 
 	 D I G I T A L   U N I X 
 
 	 
 
 
 
 S o f t w a r e   V e r s i o n :   	 D E C t a l k   V e r s i o n   4 . 5 
 
   
 
 
 
 
 
 
 
 D i g i t a l   E q u i p m e n t   C o r p o r a t i o n 
 
 M a y n a r d ,   M a s s a c h u s e t t s 
 
 A p r i l   1 9 9 8 
 
 T h e   i n f o r m a t i o n   i n   t h i s   d o c u m e n t   i s   s u b j e c t   t o   c h a n g e   w i t h o u t   n o t i c e   a n d   s h o u l d   n o t   
 
 b e   c o n s t r u e d   a s   a   c o m m i t m e n t   b y   D i g i t a l   E q u i p m e n t   C o r p o r a t i o n .   D i g i t a l   E q u i p m e n t   
 
 C o r p o r a t i o n   a s s u m e s   n o   r e s p o n s i b i l i t y   f o r   a n y   e r r o r s   t h a t   m i g h t   a p p e a r   i n   t h i s   
 
 d o c u m e n t . 
 
 
 
 N o   r e s p o n s i b i l i t y   i s   a s s u m e d   f o r   t h e   u s e   o r   r e l i a b i l i t y   o f   s o f t w a r e   o r   e q u i p m e n t   t h a t   i s   n o t   s u p p l i e d   b y   D i g i t a l   E q u i p m e n t   C o r p o r a t i o n   o r   i t s   a f f i l i a t e d   c o m p a n i e s . 
 
 
 
    D i g i t a l   E q u i p m e n t   C o r p o r a t i o n   1 9 9 7 ,   1 9 9 8 . 
 
 
 
 A l l   R i g h t s   R e s e r v e d . 
 
 P r i n t e d   i n   U . S . A . 
 
 
 
 T h e   f o l l o w i n g   a r e   t r a d e m a r k s   o f   D i g i t a l   E q u i p m e n t   C o r p o r a t i o n :   
 
 D E C ,   D E C t a l k ,   D I G I T A L ,   V A X ,   a n d   t h e   D I G I T A L   l o g o . 
 
 
 
 I n t e l   i s   a   t r a d e m a r k   o f   I n t e l   C o r p o r a t i o n .   M i c r o s o f t   W o r d   f o r   W i n d o w s   i s   a   r e g i s t e r e d   t r a d e m a r k   a n d   W i n d o w s   9 5   a n d   W i n d o w s   N T   a r e   t r a d e m a r k s   o f   t h e   M i c r o s o f t   C o r p o r a t i o n .   R o b o H E L P   i s   a   r e g i s t e r e d   t r a d e m a r k   o f   B l u e   S k y   S o f t w a r e   C o m p a n y .     S o u n d B l a s t e r   i s   a   r e g i s t e r e d   t r a d e m a r k   o f   C r e a t i v e   L a b s ,   I n c .   U N I X   a n d   D I G I T A L   U N I X   a r e   r e g i s t e r e d   t r a d e m a r k s   i n   t h e   U n i t e d   S t a t e s   a n d   o t h e r   c o u n t r i e s   l i c e n s e d   e x c l u s i v e l y   t h r o u g h   X / O p e n   C o m p a n y ,   L t d .     M o t i f   i s   a   r e g i s t e r e d   t r a d e m a r k   o f   O p e n   S o f t w a r e   F o u n d a t i o n ,   I n c . 
 
 
 
 T h i s   d o c u m e n t   w a s   p r e p a r e d   u s i n g   M i c r o s o f t   W o r d   9 7   t o   g e n e r a t e   M S   W o r d   6 . 0 / 9 5   c o m p a t i b l e   f i l e s .   T h e   o n l i n e   h e l p   s y s t e m   w a s   p r e p a r e d   w i t h   M i c r o s o f t   W o r d   9 7   a n d   t h e   R o b o H E L P   4 . 0   h e l p   a u t h o r i n g   t o o l . 
 
 
 
 C o n t e n t s 
 
 P r e f a c e 	 v i i 
 
 P u r p o s e   a n d   A u d i e n c e s 	 v i i 
 
 S t r u c t u r e 	 v i i 
 
 W h a t ' s   N e w   i n   D E C t a l k   V 4 . 5 ? 	 v i i i 
 
 W h a t ' s   N e w   i n   D E C t a l k   V 4 . 4 ? 	 i x 
 
 C o n v e n t i o n s 	 x i 
 
 C h a p t e r   1   -   I n t r o d u c t i o n   t o   D E C t a l k   S o f t w a r e 	 1 - 1 
 
 D E C t a l k   S o f t w a r e   F e a t u r e s   a n d   F u n c t i o n s 	 1 - 2 
 
 L a t e s t   V e r s i o n   o f   S p e e c h - S y n t h e s i s   T e c h n o l o g y   f r o m   D I G I T A L 	 1 - 2 
 
 L e t t e r   M o d e ,   W o r d   M o d e ,   a n d   C l a u s e   M o d e 	 1 - 2 
 
 S h o r t   C o m m a n d   S t r i n g s 	 1 - 2 
 
 H i g h - Q u a l i t y   S p e e c h   a n d   W o r d   P r o n u n c i a t i o n   A c c u r a c y 	 1 - 2 
 
 P r o n u n c i a t i o n   H e u r i s t i c s 	 1 - 3 
 
 D E C t a l k   S o f t w a r e   C o m p o n e n t s 	 1 - 3 
 
 S a m p l e   P r o g r a m   A p p l e t 	 1 - 3 
 
 S p e a k   P r o g r a m   A p p l e t 	 1 - 5 
 
 T e x t - t o - S p e e c h   D D E   S e r v e r 	 1 - 6 
 
 P r o g r a m m i n g   A i d s 	 1 - 6 
 
 D E C t a l k   S o f t w a r e   A P I s 	 1 - 6 
 
 D E C t a l k   S o f t w a r e   I n - L i n e   C o m m a n d s 	 1 - 6 
 
 D E C t a l k   S o f t w a r e   D i c t i o n a r i e s 	 1 - 7 
 
 U s i n g   t h e   C o m p o n e n t s 	 1 - 9 
 
 A p p l i c a t i o n   P r o g r a m m e r 	 1 - 9 
 
 G e n e r a l   U s e r 	 1 - 9 
 
 H o w   I t   W o r k s 	 1 - 1 1 
 
 C h a p t e r   2   -   U s i n g   t h e   P r o g r a m   A p p l e t s   t o   L e a r n   D E C t a l k   S o f t w a r e   B a s i c s 	 2 - 1 
 
 S t a r t i n g   t h e   S a m p l e   A p p l e t   a n d   O p e n i n g   a   T e x t   F i l e 	 2 - 2 
 
 I n s e r t i n g   D E C t a l k   S o f t w a r e   I n - L i n e   C o m m a n d s   ( S y n t a x   R u l e s ) 	 2 - 4 
 
 A d d i t i o n a l   S y n t a x   R u l e s 	 2 - 5 
 
 C h a n g i n g   S p e a k i n g   V o i c e 	 2 - 6 
 
 E d i t i n g   a   T e x t   F i l e   a n d   C h a n g i n g   t h e   S p e a k i n g   R a t e 	 2 - 8 
 
 O v e r v i e w   o f   t h e   U s e r   D i c t i o n a r y   B u i l d   T o o l 	 2 - 1 0 
 
 B u i l d i n g   a   U s e r   D i c t i o n a r y 	 2 - 1 2 
 
 U s i n g   t h e   D E C t a l k   S o f t w a r e   S p e a k   A p p l e t 	 2 - 1 6 
 
 R u n n i n g   D E C t a l k   S o f t w a r e   f r o m   O t h e r   A p p l i c a t i o n s 	 2 - 1 9 
 
 S t e p   1   -   C r e a t i n g   a   W o r d   M a c r o   a n d   A s s o c i a t i n g   i t   w i t h   a   F i l e   o r   D o c u m e n t   T e m p l a t e   ( f o r   W o r d   7 . 0 ) 	 2 - 2 0 
 
 S t e p   2   -   A s s o c i a t i n g   t h e   M a c r o   w i t h   a   T o o l b a r   B u t t o n 	 2 - 2 3 
 
 S t e p   3   -   L a u n c h i n g   a n d   C o n f i g u r i n g   t h e   D E C t a l k   S o f t w a r e   T e x t - t o - S p e e c h   S e r v e r 	 2 - 2 5 
 
 S t e p   4   -   S p e a k i n g   T e x t   i n   a   M i c r o s o f t   W o r d   . d o c   F i l e   w i t h   t h e   D E C t a l k   T T S   S e r v e r 	 2 - 2 7 
 
 U s i n g   t h e   S a y   C o m m a n d - L i n e   A p p l e t 	 2 - 2 9 
 
 C h a p t e r   3   -   I n t r o d u c t i o n   t o   t h e   D E C t a l k   S o f t w a r e   A P I 	 3 - 1 
 
 T h e   C o r e   A P I   C a l l s 	 3 - 4 
 
 T e x t T o S p e e c h S p e a k 	 3 - 4 
 
 I m p o r t a n t   T e x t - Q u e u i n g   I n f o r m a t i o n 	 3 - 5 
 
 C l a u s e - B a s e d   S y n t h e s i s 	 3 - 5 
 
 C a l l b a c k   R o u t i n e s   a n d   W i n d o w   P r o c e d u r e s 	 3 - 6 
 
 E r r o r   M e s s a g e s 	 3 - 7 
 
 I n d e x   M a r k   M e s s a g e s 	 3 - 8 
 
 B u f f e r   M e s s a g e s 	 3 - 8 
 
 A u d i o   O u t p u t   C o n t r o l   C a l l s 	 3 - 1 1 
 
 B l o c k i n g   S y n c h r o n i z a t i o n   C a l l 	 3 - 1 1 
 
 C o n t r o l   a n d   S t a t u s   C a l l s 	 3 - 1 1 
 
 S p e c i a l   T e x t - T o - S p e e c h   M o d e s 	 3 - 1 2 
 
 W a v e - F i l e   M o d e 	 3 - 1 2 
 
 L o g - F i l e   M o d e 	 3 - 1 3 
 
 S p e e c h - T o - M e m o r y   M o d e 	 3 - 1 3 
 
 D i c t i o n a r y   C a l l s   ( U N I X   o n l y ) 	 3 - 1 8 
 
 C r e a t i n g   a   U s e r   D i c t i o n a r y 	 3 - 1 8 
 
 L o a d i n g   t h e   M a i n   D i c t i o n a r y 	 3 - 1 8 
 
 L o a d i n g   t h e   U s e r   D i c t i o n a r y 	 3 - 1 9 
 
 D i c t i o n a r y   C a l l s   ( W i n d o w s   o n l y ) 	 3 - 1 9 
 
 C r e a t i n g   a   U s e r   D i c t i o n a r y 	 3 - 1 9 
 
 L o a d i n g   t h e   M a i n   D i c t i o n a r y 	 3 - 2 0 
 
 L o a d i n g   t h e   U s e r   D i c t i o n a r y 	 3 - 2 1 
 
 S a m p l e   P r o g r a m s   ( U N I X   o n l y ) 	 3 - 2 2 
 
 B u i l d i n g   S a m p l e   P r o g r a m s 	 3 - 2 3 
 
 H e a d e r   F i l e s 	 3 - 2 3 
 
 S h a r e a b l e   L i b r a r i e s 	 3 - 2 4 
 
 S a m p l e   P r o g r a m s   ( W i n d o w s   o n l y ) 	 3 - 2 5 
 
 C h a p t e r   4   -   H o w   t o   d o   M u l t i - L a n g u a g e   P r o g r a m m i n g 	 4 - 1 
 
 S t a r t i n g   a   l a n g u a g e 	 4 - 2 
 
 S e l e c t i n g   a   l a n g u a g e 	 4 - 2 
 
 C l o s i n g   a   l a n g u a g e 	 4 - 2 
 
 E x a m p l e 	 4 - 3 
 
 G l o s s a r y 
 
 I n d e x 
 
 
 
 
 
 F i g u r e s 
 
 F i g u r e   1 - 1   V i s u a l   O v e r v i e w   o f   t h e   S a m p l e   P r o g r a m   A p p l e t 	 1 - 4 
 
 F i g u r e   1 - 2   V i s u a l   O v e r v i e w   o f   t h e   S p e a k   P r o g r a m   A p p l e t 	 1 - 5 
 
 F i g u r e   1 - 3   I n - L i n e   C o m m a n d   C o m p o n e n t s 	 1 - 7 
 
 F i g u r e   1 - 4   F l o w   o f   t h e   D E C t a l k   S o f t w a r e   T e x t - T o - S p e e c h   C o n v e r s i o n   P r o c e s s 	 1 - 1 1 
 
 F i g u r e   2 - 1   S t a r t i n g   t h e   S a m p l e   A p p l e t   a n d   O p e n i n g   a   T e x t   F i l e 	 2 - 2 
 
 F i g u r e   2 - 2   R u l e s   f o r   D E C t a l k   S o f t w a r e   I n - L i n e   C o m m a n d   S y n t a x 	 2 - 4 
 
 F i g u r e   2 - 3   C h a n g i n g   D E C t a l k   S o f t w a r e   V o i c e s 	 2 - 7 
 
 F i g u r e   2 - 4   E d i t i n g   a   T e x t   F i l e   a n d   C h a n g i n g   t h e   S p e a k i n g   R a t e 	 2 - 8 
 
 F i g u r e   2 - 5   C o m p o n e n t s   o f   t h e   U s e r   D i c t i o n a r y   B u i l d   T o o l 	 2 - 1 0 
 
 F i g u r e   2 - 6   B u i l d i n g   a   U s e r   D i c t i o n a r y 	 2 - 1 2 
 
 F i g u r e   2 - 7   S a v i n g   a n d   C o m p i l i n g   t h e   D i c t i o n a r y 	 2 - 1 4 
 
 F i g u r e   2 - 8   U s i n g   t h e   D E C t a l k   S o f t w a r e   S p e a k   A p p l e t 	 2 - 1 6 
 
 F i g u r e   2 - 9   H i g h l i g h t i n g   S p o k e n   T e x t 	 2 - 1 8 
 
 F i g u r e   2 - 1 0   C r e a t i n g   a   W o r d   M a c r o 	 2 - 2 0 
 
 F i g u r e   2 - 1 1   A s s o c i a t i n g   t h e   M a c r o   w i t h   a   T o o l b a r   B u t t o n 	 2 - 2 3 
 
 F i g u r e   2 - 1 2   L a u n c h i n g   a n d   C o n f i g u r i n g   t h e   D E C t a l k   S e r v e r 	 2 - 2 5 
 
 F i g u r e   2 - 1 3   S p e a k i n g   T e x t   i n   a   M i c r o s o f t   W o r d   . d o c   F i l e   w i t h   t h e   D E C t a l k   S o f t w a r e   T T S   S e r v e r 	 2 - 2 7 
 
 
 
 T a b l e s 
 
 T a b l e   2 - 1   S t a r t i n g   t h e   S a m p l e   A p p l e t   a n d   O p e n i n g   a   T e x t   F i l e 	 2 - 3 
 
 T a b l e   2 - 2   D E C t a l k   V o i c e s   a n d   t h e i r   A s s o c i a t e d   V a l u e s 	 2 - 6 
 
 T a b l e   2 - 3   C h a n g i n g   V o i c e s 	 2 - 7 
 
 T a b l e   2 - 4   E d i t i n g   a   T e x t   F i l e   a n d   C h a n g i n g   t h e   S p e a k i n g   R a t e 	 2 - 9 
 
 T a b l e   2 - 5   B u i l d i n g   a   U s e r   D i c t i o n a r y 	 2 - 1 3 
 
 T a b l e   2 - 6   S a v i n g   a n d   C o m p i l i n g   t h e   D i c t i o n a r y 	 2 - 1 5 
 
 T a b l e   2 - 7   U s i n g   t h e   D E C t a l k   S p e a k   A p p l i c a t i o n 	 2 - 1 7 
 
 T a b l e   2 - 8   C r e a t i n g   a   W o r d   M a c r o 	 2 - 2 1 
 
 T a b l e   2 - 9   A s s o c i a t i n g   t h e   M a c r o   w i t h   a   T o o l b a r   B u t t o n 	 2 - 2 4 
 
 T a b l e   2 - 1 0   L a u n c h i n g   a n d   C o n f i g u r i n g   t h e   D E C t a l k   T T S   S e r v e r 	 2 - 2 6 
 
 T a b l e   2 - 1 1   S p e a k i n g   T e x t   i n   a   M i c r o s o f t   W o r d   . d o c   f i l e   w i t h   t h e   D E C t a l k   T T S   S e r v e r 	 2 - 2 8 
 
 T a b l e   3 - 1   T e x t - T o - S p e e c h   C a l l s   b y   C a t e g o r y 	 3 - 2 
 
 T a b l e   3 - 2   A P I   C o n t r o l   a n d   S t a t u s   C a l l s 	 3 - 1 1 
 
 T a b l e   3 - 3   S p e c i a l   T e x t - T o - S p e e c h   M o d e s 	 3 - 1 2 
 
 
 
 P r e f a c e 
 
 P u r p o s e   a n d   A u d i e n c e s 
 
 T h i s   g u i d e ,   D E C t a l k   S o f t w a r e   P r o g r a m m e r ' s   G u i d e ,   i s   f o r   t h e   a p p l i c a t i o n   p r o g r a m m e r   w h o   w a n t s   t o   d e s i g n   a n d   b u i l d   t e x t - t o - s p e e c h   a p p l i c a t i o n s   w i t h   D E C t a l k   S o f t w a r e .   T h i s   g u i d e   s h o u l d   b e   u s e d   i n   c o n j u n c t i o n   w i t h   t h e   D E C t a l k   S o f t w a r e   R e f e r e n c e   G u i d e   a n d   t h e   D E C t a l k   S o f t w a r e   I n s t a l l a t i o n   G u i d e . 
 
 S t r u c t u r e 
 
 T h i s   g u i d e ' s   d e s i g n   g i v e s   y o u   q u i c k   a n d   e a s y   a c c e s s   t o   i n f o r m a t i o n .   I t s   o r g a n i z a t i o n   c a n   h e l p   y o u   e a s i l y   l e a r n   a b o u t   n e w   t o p i c s   a n d   p e r f o r m   s p e c i f i c   t a s k s   r e l a t e d   t o   t h e   u s e   o f   t h e   p r o g r a m   a p p l e t s   o r   d e v e l o p m e n t   o f   a   D E C t a l k   S o f t w a r e   a p p l i c a t i o n . 
 
 T h e   g u i d e   i s   o r g a n i z e d   a s   f o l l o w s : 
 
 C h a p t e r   1 
 
 I n t r o d u c t i o n   t o   D E C t a l k   S o f t w a r e 
 
 C h a p t e r   2 
 
 U s i n g   t h e   P r o g r a m   A p p l e t s   t o   L e a r n   D E C t a l k   S o f t w a r e   B a s i c s 
 
 C h a p t e r   3 
 
 I n t r o d u c t i o n   t o   t h e   D E C t a l k   S o f t w a r e   A P I 
 
 C h a p t e r   4 
 
 H o w   t o   d o   M u l t i - L a n g u a g e   P r o g r a m m i n g 
 
 D E C t a l k   S o f t w a r e   I m p l e m e n t a t i o n s   a n d   L i c e n s i n g 
 
 D E C t a l k   S o f t w a r e   i s   p a c k a g e d   t o   r u n   o n   t h e   D i g i t a l   U N I X ,   W i n d o w s   N T ,   a n d   W i n d o w s   9 5   o p e r a t i n g   s y s t e m s .   T h e   D E C t a l k   S o f t w a r e   d o c u m e n t a t i o n   l i b r a r y   i s   d e s i g n e d   a s   a   s i n g l e   l i b r a r y   o f   h a r d c o p y   a n d   o n l i n e   d o c u m e n t a t i o n   f o r   a l l   p l a t f o r m s .   E a c h   o f   t h e   D E C t a l k   S o f t w a r e   i m p l e m e n t a t i o n s   a n d   i t s   s u p p o r t i n g   d o c u m e n t a t i o n   i s   c h a r t e d   i n   t h e   f o l l o w i n g   t a b l e . 
 
 
 
 D E C t a l k   S o f t w a r e   f o r   D i g i t a l   U N I X 
 
 T h e   U N I X   R u n t i m e   k i t   i s   f a c t o r y   i n s t a l l e d   w i t h   t h e   U N I X   o p e r a t i n g   s y s t e m   g i v e s   y o u   a c c e s s   t o   t h e   f o l l o w i n g   D E C t a l k   S o f t w a r e   a p p l i c a t i o n s :   m a i l t a l k ,   s a y ,   s p e a k ,   e m a c s p e a k ,   a n d   D E C f a c e .   I n   o r d e r   t o   d e v e l o p   y o u r   o w n   D E C t a l k   S o f t w a r e   a p p l i c a t i o n s ,   y o u   m u s t   o r d e r   t h e   D E C t a l k   S o f t w a r e   D e v e l o p e r ' s   k i t .   D E C t a l k   S o f t w a r e   D e v e l o p e r ' s   k i t   g i v e s   y o u   a c c e s s   t o   t h e   D E C t a l k   S o f t w a r e   A P I   a n d   s o m e   s a m p l e   C   p r o g r a m s . 
 
 
 
 W h a t ' s   N e w   i n   D E C t a l k   V 4 . 5 ? 
 
 D E C t a l k   S o f t w a r e   V 4 . 5   f o r   W i n d o w s   9 5   a n d   W i n d o w s   N T   c o n t a i n s   t h e   f o l l o w i n g   n e w   f e a t u r e s : 
 
 D i s t r i b u t e d   o n   C D - R O M . 
 
 Y e a r   2 0 0 0   s u p p o r t   s p e a k s   f o u r - d i g i t   y e a r   s p e c i f i c a t i o n s   a s   f o u r - d i g i t   y e a r   s p e c i f i c a t i o n s ,   f o r   e x a m p l e ,   t h e   y e a r   1 9 9 8   i s   s p o k e n   a s   n i n e t e e n   n i n e t y   e i g h t ,   a n d   s p e a k s   2 - d i g i t   y e a r   s p e c i f i c a t i o n s   a s   a   2 - d i g i t   n u m b e r   w i t h o u t   a s s s u m i n g   t h e   c e n t u r y ,   f o r   e x a m p l e ,   t h e   y e a r   9 8   i s   s p o k e n   a s   n i n e t y   e i g h t . 
 
 U n i t e d   K i n g d o m   E n g l i s h   i s   a d d e d . 
 
 S A P I   m a r k   s y n t a x   ( \ m r k = \   t a g )   i s   w o r k i n g .     T h e   T e x t D a t a   i n t e r f a c e   n o w   a c c e p t s   t a g g e d   t e x t .     T h e   \ m r k = \   t a g   i s   t h e   o n l y   t a g   s u p p o r t e d .     O t h e r   t a g s   a r e   i g n o r e d . 
 
 I T T S B u f N o t i f y S i n k :   T h e   B o o k M a r k   a n d   W o r d P o s i t i o n   i n t e r f a c e s   a r e   n o w   f u n c t i o n a l .   T h e   t i m i n g   o f   t h e   T e x t D a t a S t a r t e d   a n d   T e x t D a t a D o n e   n o t i f i c a t i o n s   i s   c o r r e c t e d . 
 
 I T T S N o t i f y S i n k :   T h e   V i s u a l   i n t e r f a c e   i s   n o w   f u n c t i o n a l ;   t h e   t i m i n g   o f   t h e   A u d i o S t a r t   a n d   A u d i o S t o p   n o t i f i c a t i o n s   i s   c o r r e c t e d . 
 
 D E C t a l k   S o f t w a r e   V 4 . 5   p r o v i d e s   b e t t e r   i n d e x i n g   p e r f o r m a n c e   t h a n   p r e v i o u s   v e r s i o n s . 
 
 M u l t i - L a n g u a g e   ( M L )   s u p p o r t   i s   f u n c t i o n a l . 
 
 S a m p l e   p r o g r a m s   S p e a k   a n d   d t s a m p l e   a r e   u p d a t e d   t o   M u l t i - L a n g u a g e   ( M L ) f u n c t i o n a l i t y .   A l l   s a m p l e   a p p l e t s   a r e   M L - c o m p l i a n t   c o d e .   S o m e   s a m p l e   a p p l e t s   d e m o n s t r a t e   M L - a p p l i c a t i o n   p r o g r a m m i n g .   
 
 T h e   U s e r   D i c t i o n a r y   c o m p i l e r   n o w   h a n d l e s   a c c e n t   c h a r a c t e r s   ( e x t e n d e d   A S C I I ) . 
 
 O L E   n o t i f i c a t i o n   s u p p o r t ,   A u d i o S t a r t   a n d   A u d i o S t o p ,   n o w   r e t u r n e d . 
 
 T h e   c u r r e n t   D E C t a l k   S o f t w a r e   i m p l e m e n t a t i o n   o f   t h e   M i c r o s o f t   S p e e c h   A P I   ( S A P I )   i s   d e s c r i b e d   i n   t h e   a p p e n d i x 3 . t x t   f i l e   t h a t   i s   i n c l u d e d   w i t h   t h e   D E C t a l k   S o f t w a r e   i n s t a l l a t i o n   f i l e s . 
 
 
 
 W h a t ' s   N e w   i n   D E C t a l k   V 4 . 4 ? 
 
 D E C t a l k   S o f t w a r e   v e r s i o n   4 . 4   c o n t a i n s   t h e   f o l l o w i n g   n e w   f e a t u r e s : 
 
 S u p p o r t   f o r   m u l t i p l e   i n s t a n c e s   o f   t h e   t e x t - t o - s p e e c h   o b j e c t s   i n   a   s i n g l e   p r o c e s s . 
 
 A   n e w   s t a r t u p   f u n c t i o n ,   T e x t T o S p e e c h S t a r t u p E x ( ) ,   h a s   b e e n   a d d e d   t o   c o m p l e m e n t   t h e   p l a t f o r m   s p e c i f i c   T e x t T o S p e e c h S t a r t u p ( )   f u n c t i o n   f o r   W i n d o w s .   T h e   W i n d o w s   s t a r t u p   f u n c t i o n   s u p p o r t s   w i n d o w i n g   m e s s a g e s ,   w h i l e   t h e   n e w   e x t e n d e d   s t a r t u p   f u n c t i o n   s u p p o r t s   c a l l b a c k s .   O n   U N I X ,   b o t h   s t a r t u p   f u n c t i o n s   w o r k   s i m i l a r   t o   t h e   W i n d o w s   e x t e n d e d   s t a r t u p   f u n c t i o n ,   i n   o t h e r   w o r d s ,   t h e y   s u p p o r t   c a l l b a c k s   n o t   w i n d o w   m e s s a g e s . 
 
 A   n e w   d o c u m e n t ,   t h e   D E C t a l k   S o f t w a r e   R e f e r e n c e   G u i d e ,   h a s   b e e n   a d d e d .   T h i s   g u i d e   p r o v i d e s   a n   o v e r v i e w   a n d   r e f e r e n c e   l i s t i n g s   o f   t h e   D E C t a l k   S o f t w a r e   i n - l i n e   c o m m a n d s .   I t   a l s o   c o n t a i n s   a   l i s t i n g   o f   a l l   r e f e r e n c e   t a b l e s   f o r   p h o n e m i c   s y m b o l s ,   s t r e s s   a n d   s y n t a c t i c   s y m b o l s ,   t o n e   t a b l e s ,   a n d   h o m o g r a p h s . 
 
 E - m a i l   p a r s i n g   h a s   b e e n   a d d e d   t o   t h e   M o d e   i n - l i n e   c o m m a n d . 
 
 C h a n g e s   h a v e   b e e n   m a d e   t o   t h e   U N I X   c o d e   t o   a l l o w   f o r   p o s i x   t h r e a d   c h a n g e s . 
 
 I m p l e m e n t a t i o n   o f   t h e   T e x t T o S p e e c h R e s e t ( )   f u n c t i o n   h a s   b e e n   c h a n g e d . 
 
 T h e   T e x t T o S p e e c h P a u s e ( )   f u n c t i o n   h a s   b e e n   m a d e   a s y n c h r o n o u s . 
 
 N e w   l i c e n s e   s p e c i f i c   r e t u r n   v a l u e s   h a v e   b e e n   a d d e d   t o   t h e   s t a r t u p   f u n c t i o n s ,   T e x t T o S p e e c h S t a r t u p ( )   a n d   T e x t T o S p e e c h S t a r t u p E x ( ) .   T h e y   a r e   M M S Y S E R R _ A L L O C A T E D   a n d   M M S Y S E R R _ N O T E N A B L E D . 
 
 T h e   t t s a p i   h e a d e r   f i l e   ( t t s a p i . h )   w a s   m o d i f i e d   f o r   4 . 4 .   T h e   f o l l o w i n g   i s   a   l i s t   o f   c h a n g e s   t h a t   w e r e   m a d e . 
 
 S y m b o l   i n   T T S A P I . H 
 
 O l d   V a l u e 
 
 N e w   V a l u e 
 
 O U T P U T _ T O _ A F _ D E V I C E 
 
 0 1 0 0 0 0 0 0 
 
 n o   l o n g e r   e x i s t s 
 
 O U T P U T _ T O _ M M E _ D E V I C E 
 
 8 0 0 0 0 0 0 0 
 
 n o   l o n g e r   e x i s t s 
 
 O W N _ A U D I O _ D E V I C E 
 
 1 0 0 0 0 0 0 0 
 
 0 0 0 0 0 0 0 1 
 
 R E P O R T _ O P E N _ E R R O R 
 
 2 0 0 0 0 0 0 0 
 
 0 0 0 0 0 0 0 2 
 
 D O _ N O T _ U S E _ A U D I O _ D E V I C E 
 
 4 0 0 0 0 0 0 0 
 
 8 0 0 0 0 0 0 0 
 
 
 
 F o r   c o m p a t i b i l i t y   r e a s o n s ,   t h e   I N D E X _ M A R K   a n d   M E S S A G E _ B U F F E R   s y m b o l s   w e r e   c h a n g e d .   T h e   v a r i a b l e s   w e r e   r e n a m e d   t o   f o r c e   a   r e c o m p i l e   o f   a n y   c o d e   t h a t   u s e s   t h e   o l d   n a m e s   s i n c e   t h e   v a l u e s   w e r e   n o t   g u a r a n t e e d   t o   m e a n   t h e   s a m e   t h i n g   b e t w e e n   4 . 2 A   a n d   4 . 4 .   
 
 O l d   S y m b o l 
 
 V a l u e 
 
 N e w   S y m b o l 
 
 V a l u e 
 
 I N D E X _ M A R K 
 
 0 
 
 T T S _ M S G _ I N D E X _ M A R K 
 
 1 
 
 M E S S A G E _ B U F F E R 
 
 1 
 
 T T S _ M S G _ B U F F E R 
 
 0 
 
 
 
 
 
 T T S _ M S G _ S T A T U S 
 
 2 
 
 
 
 T h e   c a l l b a c k   r o u t i n e s   d e f i n e d   i n   b o t h   T e x t T o S p e e c h S t a r t u p   a n d   T e x t T o S p e e c h S t a r t u p E x   h a v e   b e e n   c h a n g e d . 
 
 T h e   o l d   c a l l b a c k   r o u t i n e ,   d e f i n e d   i n   D E C t a l k   S o f t w a r e   4 . 2 A   w a s   d e f i n e d   a s : 
 
 C a l l b a c k   ( D W O R D   p a r a m 1 ,   L O N G   p a r a m 2 ,   L O N G   u s e r D e f i n e d )   
 
 p a r a m 1 : 
 
 T y p e   o f   c a l l b a c k   ( I N D E X _ M A R K   o r   M E M O R Y _ B U F F E R )   o r   e r r o r   
 
 p a r a m 2 : 
 
 F o r   I N D E X _ M A R K ,   t h i s   w o u l d   b e   t h e   i n d e x   m a r k   v a l u e 
 
 
 
 F o r   M E M O R Y _ B U F F E R ,   t h i s   w o u l d   b e   a   p o i n t e r   t o   t h e   m e m o r y   b u f f e r 
 
 u s e r D e f i n e d : 
 
 P o i n t e r   t o   u s e r - d e f i n e d   d a t a   t h a t   w a s   p a s s e d   i n   T e x t T o S p e e c h S t a r t u p ( ) 
 
 
 
 T h e   n e w   c a l l b a c k   r o u t i n e ,   d e f i n e d   i n   D E C t a l k   S o f t w a r e   4 . 4   i s   d e f i n e d   a s : 
 
 C a l l b a c k   ( D W O R D   p a r a m 1 ,   L O N G   p a r a m 2 ,   L O N G   u s e r D e f i n e d ,   U I N T   u i M s g ) 
 
 p a r a m 1 : 
 
 F o r   T T S _ M S G _ S T A T U S ,   t h i s   w i l l   i n d i c a t e   t h e   e r r o r / s t a t u s   c o d e 
 
 p a r a m 2 : 
 
 F o r   T T S _ M S G _ B U F F E R ,   t h i s   w i l l   b e   a   p o i n t e r   t o   t h e   m e m o r y   b u f f e r 
 
 
 
 F o r   T T S _ M S G _ I N D E X _ M A R K ,   t h i s   w i l l   b e   t h e   i n d e x   m a r k   v a l u e 
 
 
 
 F o r   T T S _ M S G _ S T A T U S ,   t h i s   i s   a d d i t i o n a l   i n f o r m a t i o n   f o r   t h e   e r r o r / s t a t u s . 
 
 u s e r D e f i n e d : 
 
 P o i n t e r   t o   u s e r - d e f i n e d   d a t a   t h a t   w a s   p a s s e d   i n   T e x t T o S p e e c h S t a r t u p ( ) 
 
 u i M s g : 
 
 T T S _ M S G _ B U F F E R   f o r   m e m o r y   b u f f e r s 
 
 
 
 T T S _ M S G _ S T A T U S   f o r   e r r o r   a n d   s t a t u s   i n f o r m a t i o n 
 
 
 
 T T S _ M S G _ I N D E X _ M A R K   f o r   i n d e x   m a r k s 
 
 
 
 D E C t a l k . l i b   h a s   b e e n   p l a c e d   i n   \ P r o g r a m   F i l e s \ D E C t a l k \ l i b . 
 
 T h e   8   k H z ,   1 6   b i t   m o n o   o u t p u t   i s   n o w   s u p p o r t e d . 
 
 C o n v e n t i o n s 
 
 T h e   f o l l o w i n g   c o n v e n t i o n s   a r e   u s e d   i n   t h i s   g u i d e : 
 
 C o n v e n t i o n 
 
 M e a n i n g 
 
 e n t e r 
 
 E n t e r   m e a n s   t y p e   t h e   r e q u i r e d   i n f o r m a t i o n   a n d   p r e s s   t h e   E n t e r   k e y . 
 
 m o u s e 
 
 M o u s e   r e f e r s   t o   a n y   p o i n t i n g   d e v i c e ,   s u c h   a s   a   m o u s e ,   a   p u c k ,   o r   a   s t y l u s . 
 
 M B 1 
 
 M B 1   i n d i c a t e s   t h e   l e f t   m o u s e   b u t t o n . 
 
 c l i c k   
 
 C l i c k   m e a n s   t o   p r e s s   a n d   r e l e a s e   M B 1 .   
 
 D o u b l e   c l i c k   
 
 D o u b l e   c l i c k   m e a n s   t o   p r e s s   a n d   r e l e a s e   M B 1   t w i c e   i n   r a p i d   s u c c e s s i o n   w i t h o u t   m o v i n g   t h e   m o u s e . 
 
 d r a g 
 
 T h e   p h r a s e   d r a g   m e a n s   t o   p r e s s   a n d   h o l d   M B 1 ,   m o v e   t h e   m o u s e ,   a n d   t h e n   r e l e a s e   M B 1   w h e n   t h e   p o i n t e r   i s   i n   t h e   d e s i r e d   p o s i t i o n . 
 
 C t r l / x 
 
 P r e s s   t h e   C t r l   k e y   w h i l e   y o u   p r e s s   a n o t h e r   k e y . 
 
 M e n u   !C o m m a n d 
 
 T h e   r i g h t   a r r o w   k e y   i n d i c a t e s   a n   a b b r e v i a t e d   i n s t r u c t i o n   f o r   c h o o s i n g   a   c o m m a n d   f r o m   a   m e n u .   F o r   e x a m p l e ,   F i l e   !E x i t     m e a n s   p u l l   d o w n   t h e   F i l e   m e n u ,   m o v e   t h e   p o i n t e r   t o   t h e   E x i t   c o m m a n d ,   a n d   r e l e a s e   M B 1 .   
 
 C o u r i e r   t y p e 
 
 C o u r i e r   t y p e   i n d i c a t e s   t e x t   t h a t   i s   t y p e d   o r   d i s p l a y e d   o n   t h e   s c r e e n .   T h i s   i s   m o s t   o f t e n   u s e d   f o r   p r o g r a m   c o d e   e x a m p l e s . 
 
 U s e r   I n p u t 
 
 B o l d f a c e   t y p e   i n   i n t e r a c t i v e   e x a m p l e s   i n d i c a t e s   i n f o r m a t i o n   y o u   e n t e r   f r o m   t h e   k e y b o a r d .   F o r   e x a m p l e :   
 
 A : > S E T U P 
 
 X X   Y Y   a n d   
 
 X X n   Y Y n 
 
 I n   D E C t a l k   S o f t w a r e   i n - l i n e   c o m m a n d   s y n t a x ,   X X   a n d   Y Y   i n d i c a t e   o p t i o n s   a n d   p a r a m e t e r s .   W h e n   m o r e   t h a n   o n e   c h o i c e   o f   o p t i o n s   o r   p a r a m e t e r s   i s   a l l o w e d ,   t h e   s y m b o l   X X n   o r   Y Y n   w i t h   n   r e p l a c e d   b y   a   n u m e r a l   i n d i c a t e s   e a c h   o p t i o n   o r   p a r a m e t e r   i n   t h e   s y m b o l i c   r e p r e s e n t a t i o n s ,   s u c h   a s   [ : p h o n e m e   X X 1   X X 2   Y Y ] .   N o t e   t h a t   t h e   n u m b e r   o f   c h a r a c t e r s   i n   t h e   s y m b o l i c   r e p r e s e n t a t i o n   d o e s   N O T   r e p r e s e n t   t h e   n u m b e r   o f   c h a r a c t e r s   a l l o w e d   i n   t h e   a c t u a l   o p t i o n   o r   p a r a m e t e r   n a m e . 
 
 D D   a n d   D D n 
 
 I n   D E C t a l k   S o f t w a r e   i n - l i n e   c o m m a n d   s y n t a x ,   D D   i n d i c a t e s   a   d e c i m a l   ( b a s e   1 0 )   v a l u e .   W h e n   m o r e   t h a n   o n e   d e c i m a l   v a l u e s   a r e   a l l o w e d ,   t h e   s y m b o l   D D n   w i t h   n   r e p l a c e d   b y   a   n u m e r a l   r e p r e s e n t s   e a c h   a l l o w e d   v a l u e ,   s u c h   a s   [ : v o l u m e   X X   D D 1   D D 2 ] .   N o t e   t h a t   t h e   n u m b e r   o f   c h a r a c t e r s   i n   t h e   s y m b o l i c   r e p r e s e n t a t i o n   d o e s   N O T   r e p r e s e n t   t h e   n u m b e r   o f   c h a r a c t e r s   a l l o w e d   i n   t h e   a c t u a l   d e c i m a l   v a l u e . 
 
 C o n v e n t i o n s   u s e d   i n   A P I   c a l l s 
 
 b o l d 
 
 B o l d   t e x t   i n d i c a t e s   c a l l   n a m e s ,   d a t a   s t r u c t u r e s ,   a n d   f i e l d   n a m e s .   
 
 I t a l i c s 
 
 I t a l i c   t e x t   i n d i c a t e s   c a l l   a r g u m e n t s   a n d   e m p h a s i z e s   i m p o r t a n t   i n f o r m a t i o n . 
 
 U n l e s s   o t h e r w i s e   n o t e d ,   p r e s s   E n t e r   a f t e r   t y p i n g   r e s p o n s e s   t o   c o m m a n d   p r o m p t s . 
 
 
 
 
 
 C h a p t e r   1 - 
 
 I n t r o d u c t i o n   t o   D E C t a l k   S o f t w a r e 
 
 D E C t a l k   S o f t w a r e   p r o v i d e s   p r o g r a m m i n g   r e s o u r c e s   t o   s u p p o r t   a p p l i c a t i o n   s o l u t i o n s   t h a t   r e q u i r e   t e x t - t o - s p e e c h   o u t p u t .   T h i s   c h a p t e r   p r o v i d e s   a   g e n e r a l   o v e r v i e w   o f   D E C t a l k   S o f t w a r e .   T o p i c s   i n c l u d e :   
 
 D E C t a l k   S o f t w a r e   F e a t u r e s   a n d   F u n c t i o n s 
 
 D E C t a l k   S o f t w a r e   C o m p o n e n t s 
 
 T e x t - t o - S p e e c h   D D E   S e r v e r 
 
 P r o g r a m m i n g   A i d s 
 
 U s i n g   t h e   C o m p o n e n t s 
 
 H o w   i t   w o r k s 
 
 D E C t a l k   S o f t w a r e   F e a t u r e s   a n d   F u n c t i o n s 
 
 D E C t a l k   S o f t w a r e   e n a b l e s   a p p l i c a t i o n s   t o   e x t e n d     t h e   c a p a b i l i t i e s   o f   y o u r   p e r s o n a l   c o m p u t e r   b y   t u r n i n g   t e x t   f i l e s   i n t o   s p o k e n   w o r d s .     W i t h   o n l y   a   s t a n d a r d   P C   s o u n d   c a r d   f o r   a u d i o   o u t p u t ,   t h e   p r o g r a m m i n g   r e s o u r c e s   p r o v i d e d   b y   D E C t a l k   S o f t w a r e   a l l o w   a p p l i c a t i o n s   t o   a c c u r a t e l y   r e a d   A S C I I   t e x t   f r o m   a   v a r i e t y   o f   s o u r c e s ,   s u c h   a s   e l e c t r o n i c   m a i l   a n d   w o r d   p r o c e s s o r s .   N i n e   d i f f e r e n t   v o i c e s   a r e   p r o v i d e d ,   a n d   u s e r s   c a n   c o n t r o l   v o i c e   p i t c h ,   r a t e   o f   s p e e c h ,   a n d   w o r d   o r   p h r a s e   e m p h a s i s .   
 
 L a t e s t   V e r s i o n   o f   S p e e c h - S y n t h e s i s   T e c h n o l o g y   f r o m   D I G I T A L 
 
 D E C t a l k   S o f t w a r e   c o n t a i n s   t h e   l a t e s t   v e r s i o n   o f   D E C t a l k   S o f t w a r e   s p e e c h   s y n t h e s i s .   T h i s   i n c o r p o r a t e s   a   n u m b e r   o f   i m p r o v e m e n t s   f r o m   e a r l i e r   v e r s i o n s   o f   D E C t a l k   a n d   i s   a   s o f t w a r e - o n l y   v e r s i o n . 
 
 L e t t e r   M o d e ,   W o r d   M o d e ,   a n d   C l a u s e   M o d e 
 
 D E C t a l k   S o f t w a r e   c a n   i m m e d i a t e l y   s p e a k   s i n g l e   c h a r a c t e r s   w i t h o u t   w a i t i n g   f o r   a n   e n t i r e   c l a u s e   t o   b e   b u f f e r e d .   D E C t a l k   S o f t w a r e   a l s o   p r o v i d e s   n o r m a l   c l a u s e   b u f f e r i n g   f o r   n a t u r a l   s p e e c h .   D E C t a l k   S o f t w a r e   c a n   s p e a k   l e t t e r s ,   w o r d s ,   p h r a s e s ,   c l a u s e s ,   p a r a g r a p h s ,   a n d   w h o l e   d o c u m e n t s .   D E C t a l k   S o f t w a r e   a l l o w s   t h e   a p p l i c a t i o n   t o   t e r m i n a t e   s p e e c h   i m m e d i a t e l y   i n s t e a d   o f   w a i t i n g   f o r   t h e   b u f f e r e d   t e x t   t o   c o m p l e t e   p r o c e s s i n g .   
 
 S h o r t   C o m m a n d   S t r i n g s 
 
 M a n y   o f   t h e   D E C t a l k   S o f t w a r e   i n - l i n e   c o m m a n d   s t r i n g s ,   s u c h   a s   c h a n g e   r a t e ,   c h a n g e   v o i c e ,   s t a r t ,   s t o p ,   a n d   i n d e x   m a r k s   c a n   b e   a b b r e v i a t e d   f o r   g r e a t e r   e a s e   o f   u s e   i n   a p p l i c a t i o n s .   
 
 H i g h - Q u a l i t y   S p e e c h   a n d   W o r d   P r o n u n c i a t i o n   A c c u r a c y 
 
 D E C t a l k   S o f t w a r e   s p e e c h   r e t a i n s   i t s   h i g h   q u a l i t y .   I n   a d d i t i o n ,   f u n c t i o n a l i t y   a n d   a c o u s t i c   p h o n e t i c   q u a l i t y   a r e   i m p r o v e d .   A l s o ,   D E C t a l k   S o f t w a r e   h a s   a   l a r g e   b u i l t - i n   d i c t i o n a r y   t h a t   e n a b l e s   a c c u r a t e   p r o n u n c i a t i o n   o f   i n d i v i d u a l   w o r d s   a s   w e l l   a s   e n h a n c i n g   t h e i r   r h y t h m i c   n a t u r a l n e s s .   
 
 P r o n u n c i a t i o n   H e u r i s t i c s 
 
 D E C t a l k   S o f t w a r e   i n c l u d e s   p r o n u n c i a t i o n   h e u r i s t i c s   t h a t   r e c o g n i z e   a n d   p a r s e   u n p r o n o u n c e a b l e   s e q u e n c e s ,   s u c h   a s   s e q u e n c e s   o f   u p p e r c a s e   i n i t i a l s   ( F B I ,   A A A ,   a n d   s o   f o r t h )   a n d   s e q u e n c e s   w i t h   n o   v o w e l s   ( C B S ,   N B C ,   f o r   e x a m p l e ) . 
 
 D E C t a l k   S o f t w a r e   C o m p o n e n t s 
 
 D E C t a l k   S o f t w a r e   c o m p o n e n t s   i n c l u d e : 
 
 S a m p l e   a n d   S p e a k   p r o g r a m   a p p l e t s   ( d t s a m p l e . e x e   a n d   s p e a k . e x e ) 
 
 A   c o m m a n d - l i n e   p r o g r a m   t h a t   s p e a k s   t e x t   ( s a y . e x e ) 
 
 P r o g r a m m i n g   a i d s ,   i n c l u d i n g   t h e   A P I ,   v o i c e - c o n t r o l   c o m m a n d s ,   a n d   t h e   U s e r - D i c t i o n a r y   B u i l d   T o o l 
 
 T e x t - t o - S p e e c h   S e r v i c e s   i n c l u d i n g   t h e   D y n a m i c   D a t a   E x c h a n g e   ( D D E )   T e x t - t o - S p e e c h   s e r v e r . 
 
 S a m p l e   c o d e   f o r   t h e   S a m p l e   p r o g r a m   a p p l e t ,   t h e   c o m m a n d   l i n e   p r o g r a m   ( s a y . e x e ) ,   a n d   a   s p e e c h - t o - m e m o r y   s a m p l e   p r o g r a m .   
 
 S a m p l e   P r o g r a m   A p p l e t 
 
 T h e   S a m p l e   p r o g r a m   a p p l e t   a n d   c o m p o n e n t s   a r e   p r o v i d e d   t o   g i v e   y o u   s o m e   i d e a s   o n   h o w   t o   g e t   s t a r t e d   w i t h   y o u r   a p p l i c a t i o n .   B o t h   t h e   g r a p h i c   u s e r   i n t e r f a c e   a n d   s o u r c e   c o m p o n e n t s   u s e d   t o   d e v e l o p   t h a t   u s e r   i n t e r f a c e   a r e   i n c l u d e d   a s   p a r t   o f   t h e   S a m p l e   p r o g r a m .   S e e     F i g u r e   1 - 1   f o r   a   v i s u a l   o v e r v i e w   o f   t h e   D E C t a l k   S a m p l e   A p p l i c a t i o n   d i a l o g .     S e e   t h e   U s i n g   t h e   P r o g r a m   A p p l e t s   t o   L e a r n   D E C t a l k   S o f t w a r e   B a s i c s   f o r   a d d i t i o n a l   d e s c r i p t i o n   o f   t h e   S a m p l e   p r o g r a m .   N o t e   t h a t   a v a i l a b l e   l a n g u a g e s   n o t   i n s t a l l e d   w i t h   t h e   D E C t a l k   S o f t w a r e   a r e   g r a y e d   o u t   o n   t h e   L a n g u a g e s   m e n u .     L a n g u a g e s   s h o w n   i n   d a r k   l e t t e r i n g   a r e   i n s t a l l e d   a n d   r e a d y   t o   b e   u s e d . 
 
 F i g u r e   1 - 1   V i s u a l   O v e r v i e w   o f   t h e   S a m p l e   P r o g r a m   A p p l e t 
 
 
 
 L e g e n d 
 
 
 
 D i a l o g 
 
 
 
 
 
 
 
     M e n u   b a r :   F i l e ,   E d i t ,   S p e a k ,   V o i c e ,   R a t e ,   L a n g u a g e s ,   a n d   H e l p   m e n u s 
 
 
 
 S t a r t ,   p a u s e ,   a n d   s t o p   p u s h   b u t t o n s 
 
 
 
 
 
 
 
 S p e e c h   s p e e d - c o n t r o l   s l i d e r 
 
 
 
 
 
 
 
 E d i t   w i n d o w   f o r   t e x t   i n p u t 
 
 
 
 
 
 
 
 S p e a k   P r o g r a m   A p p l e t 
 
 T h e   S p e a k   p r o g r a m   a p p l e t   i s   i n c l u d e d   a s   a   p r a c t i c a l   e x a m p l e   o f   h o w   t h e   D E C t a l k   S o f t w a r e   A P I   c a n   b e   u s e d   t o   p r o d u c e   a n   i n n o v a t i v e   T e x t - T o - S p e e c h   a p p l i c a t i o n   t h a t   m a x i m i z e s   u s e r   i n t e r a c t i o n   t h r o u g h   a   h i g h l y   g r a p h i c a l   i n t e r f a c e .     F i g u r e   1 - 2   s h o w s   a   v i s u a l   o v e r v i e w   o f   t h e   S p e a k   p r o g r a m   a p p l e t . 
 
 F i g u r e   1 - 2   V i s u a l   O v e r v i e w   o f   t h e   S p e a k   P r o g r a m   A p p l e t 
 
 
 
 L e g e n d 
 
 
 
 M e n u   b a r :   F i l e ,   E d i t ,   a n d   H e l p   m e n u s 
 
 
 
 S p e e c h   s p e e d - c o n t r o l   s l i d e r 
 
 
 
 V o i c e - a c t i v a t i o n   b u t t o n s   
 
 
 
 S t a r t ,   p a u s e ,   a n d   s t o p   p u s h   b u t t o n s 
 
 
 
 E d i t   w i n d o w   f o r   t e x t   i n p u t 
 
 
 
 
 
 *   N o t e   t h a t   t h e   f a c e s   b e c o m e   c a r t o o n   c h a r a c t e r s   w h e n   u s i n g   V G A   1 6 - c o l o r   m o d e . 
 
 
 
 T e x t - t o - S p e e c h   D D E   S e r v e r 
 
 T h e   D E C t a l k   S o f t w a r e   T e x t - t o - S p e e c h   s e r v e r   m a k e s   i t   p o s s i b l e   f o r   a n y   W i n d o w s   a p p l i c a t i o n   t h a t   c a n   c a l l   D D E   a n d   t h a t   c o n t a i n s   A S C I I   E n g l i s h   t e x t   t o   s p e a k   t h a t   t e x t   t h r o u g h   D E C t a l k   S o f t w a r e .   T h e   s e r v e r   i s   l a u n c h e d   a u t o m a t i c a l l y   w h e n e v e r   y o u   s t a r t   M i c r o s o f t   M a i l   o r   m a n u a l l y   w h e n e v e r   y o u   c l i c k   o n   t h e   T e x t - t o - S p e e c h   s e r v e r   i c o n   i n   t h e   D E C t a l k   S o f t w a r e   p r o g r a m   g r o u p . 
 
 P r o g r a m m i n g   A i d s   
 
 T h e   D E C t a l k   S o f t w a r e   p r o g r a m m i n g   a i d s   i n c l u d e   t h e   a p p l i c a t i o n   p r o g r a m m e r ' s   i n t e r f a c e   ( A P I ) ,   i n - l i n e   c o m m a n d s ,   a n d   U s e r   D i c t i o n a r y   B u i l d   T o o l .   E a c h   c o m p o n e n t   i s   i n t r o d u c e d   i n   t h i s   s e c t i o n   a n d   e x p l a i n e d   i n   d e t a i l   i n   C h a p t e r   3 . 
 
 D E C t a l k   S o f t w a r e   A P I s 
 
 D E C t a l k   S o f t w a r e   c o n t a i n s   t w o   A P I s :   t h e   D E C t a l k   S o f t w a r e   A P I   ( D A P I )   a n d   t h e   M i c r o s o f t   S p e e c h   A p p l i c a t i o n   P r o g r a m m e r ' s   I n t e r f a c e   ( S A P I ) .     T h e   D E C t a l k   S o f t w a r e   d o c u m e n t a t i o n   s e t   d e s c r i b e s   t h e   D A P I   i n t e r f a c e .     R e f e r   t o   M i c r o s o f t   d o c u m e n t a t i o n   a n d / o r   t h e   M i c r o s o f t   w e b   s i t e   f o r   i n f o r m a t i o n   a b o u t   S A P I .   
 
 T h e   D E C t a l k   S o f t w a r e   T e x t - T o - S p e e c h   A P I   i s   a   D I G I T A L   e x t e n s i o n   t o   t h e   M P C   ( M u l t i m e d i a   P C )   A P I   s p e c i f i e d   b y   t h e   W i n d o w s   o p e r a t i n g   s y s t e m . 
 
 T h e   A P I   f u n c t i o n   s e t   g i v e s   y o u   a   f l e x i b l e   m e t h o d   o f   u s i n g   a n d   c o n t r o l l i n g   D E C t a l k   S o f t w a r e   f u n c t i o n a l i t y   f r o m   w i t h i n   y o u r   a p p l i c a t i o n .   T h e s e   f u n c t i o n s   p e r f o r m   a   w i d e   r a n g e   o f   t a s k s   a s s o c i a t e d   w i t h   t h e   T e x t - T o - S p e e c h   s y s t e m .   S e e   t h e   D E C t a l k   S o f t w a r e   P r o g r a m m e r ' s   G u i d e   f o r   t h e   c o m p l e t e   l i s t   o f   A P I   f u n c t i o n s . 
 
 D E C t a l k   S o f t w a r e   I n - L i n e   C o m m a n d s 
 
 D E C t a l k   S o f t w a r e   i n c l u d e s   i n - l i n e   c o m m a n d s   t h a t   c o n t r o l   v o i c e   c h a r a c t e r i s t i c s .   Y o u   c a n   u s e   t h e s e   c o m m a n d s   t o   p e r f o r m   s i m p l e   v o i c e - c o n t r o l   o p e r a t i o n s ,   s u c h   a s   c h a n g i n g   t h e   s p e a k i n g   r a t e   o r   s p e a k i n g   v o i c e   w h i l e   D E C t a l k   S o f t w a r e   i s   s p e a k i n g .   I n - l i n e   c o m m a n d s   c a n   b e   i n s e r t e d   i n t o   t h e   t e x t   e n t e r e d   i n t o   t h e   e d i t   w i n d o w   o r   b o x   a v a i l a b l e   i n   m o s t   a p p l i c a t i o n s   s u p p l i e d   w i t h   D E C t a l k   S o f t w a r e .     I n - l i n e   c o m m a n d s   a l s o   c a n   b e   i n c l u d e d   i n   d a t a   b u f f e r s   p a s s e d   t o   t h e   D E C t a l k   S o f t w a r e   D L L s   b y   w a y   o f   v a r i o u s   T e x t T o S p e e c h . . . ( )   A P I   c a l l s .     F o r   m o r e   i n f o r m a t i o n ,   s e e   t h e   D E C t a l k   S o f t w a r e   R e f e r e n c e   G u i d e . 
 
 D E C t a l k   S o f t w a r e   a l s o   h a s   a   m o r e   c o m p l e x   s e t   o f   v o i c e - c o n t r o l   c o m m a n d s   t o   m o d i f y   t h e   c h a r a c t e r i s t i c s   o f   e a c h   v o i c e ,   c o n t r o l   i n t o n a t i o n   a n d   s t r e s s   w i t h i n   w r i t t e n   t e x t ,   o r   t o   c r e a t e   s p e c i a l   e f f e c t s ,   s u c h   a s   s i n g i n g .   
 
 I n - l i n e   c o m m a n d s   h a v e   s p e c i a l   s y n t a x   r u l e s   a n d   c o m p o n e n t s   t h a t   y o u   n e e d   t o   u s e   w h e n   y o u   i n s e r t   t h e m   i n t o   f i l e s .   A   f e w   s i m p l e   c o m m a n d s   a n d   c o m m a n d   c o m p o n e n t s   a r e   i l l u s t r a t e d   i n   F i g u r e   1 - 3 .   R e f e r   t o   t h e   D E C t a l k   S o f t w a r e   R e f e r e n c e   G u i d e   a n d   o n l i n e   h e l p   f o r   m o r e   i n f o r m a t i o n   o n   v o i c e - c o n t r o l   i n - l i n e   c o m m a n d s . 
 
 F i g u r e   1 - 3   I n - L i n e   C o m m a n d   C o m p o n e n t s 
 
 
 
 
 
 L e g e n d 
 
 
 
 
 
 I n - l i n e   c o m m a n d s   a r e   i n s e r t e d   i n t o   A S C I I   t e x t   f i l e s ,   b e g i n   w i t h   a   c o l o n ,   a n d   a r e   a l w a y s   i n s e r t e d   b e t w e e n   b r a c k e t s .   ( T h e   c o m m a n d   h e r e   t e l l s   D E C t a l k   S o f t w a r e   t o   s p e a k   t h i s   l i n e   a t   1 5 0   w o r d s   p e r   m i n u t e . )   M o s t   c o m m a n d s   h a v e   p a r a m e t e r s   ( F o r   e x a m p l e ,   :   r a t e   1 5 0     =   r a t e   o f   1 5 0   w o r d s   p e r   m i n u t e . ) 
 
 
 
 T w o   o r   m o r e   c o m m a n d s   c a n   b e   i n s e r t e d   a f t e r   e a c h   o t h e r   b y   e n c l o s i n g   e a c h   c o m m a n d   w i t h i n   a   s e t   o f   s q u a r e   b r a c k e t s .   ( F o r   e x a m p l e ,   t h e   r a t e   a n d   v o i c e   s e l e c t i o n s   a r e   s h o w n   h e r e . ) 
 
 
 
 P h o n e t i c   s p e l l i n g s   o f   w o r d s   c a n   b e   i n c l u d e d   a l s o .     P h o n e t i c   s p e l l i n g s   a r e   e n c l o s e d   w i t h i n   a   s e t   o f   s q u a r e   b r a c k e t s .   ( F o r   e x a m p l e ,   [ r ' i y l i y ]   f o r   r e a l l y   )       N o t e :   i f   y o u   w a n t   t o   u s e   p h o n e t i c   s p e l l i n g s ,   y o u   m u s t   u s e   t h e   [ : p h o n e m e   a r p a b e t   s p e a k   o n ]   c o m m a n d   t o   t u r n   o n   r e c o g n i t i o n   o f   p h o n e t i c   s p e l l i n g s . ) 
 
 
 
 
 
 	 D E C t a l k   S o f t w a r e   D i c t i o n a r i e s 
 
 D E C t a l k   S o f t w a r e   h a s   t w o   p r o n u n c i a t i o n   d i c t i o n a r i e s   -   a   l a r g e   i n t e r n a l   ( b u i l t - i n )   d i c t i o n a r y   a n d   a   u s e r - d e f i n e d   d i c t i o n a r y .   W i t h   t h e   l a r g e   b u i l t - i n   d i c t i o n a r y ,   y o u   c a n   e a s i l y   u s e   m a n y   p r o p e r   n a m e s   a n d   n o r m a l l y   u n p r o n o u n c e a b l e   s e q u e n c e s ,   s u c h   a s   u p p e r c a s e   i n i t i a l s ,   i n   t h e i r   a p p l i c a t i o n s .   W i t h   t h e   u s e r   d i c t i o n a r y   b u i l d   t o o l ,   y o u   c a n   l o a d   a p p l i c a t i o n - s p e c i f i c   w o r d s ,   o r   c u l t u r a l   o r   l a n g u a g e - s p e c i f i c   t e r m s   i n t o   t h e   u s e r   d i c t i o n a r y .   A   s a m p l e   u s e r - d i c t i o n a r y   f i l e   i s   i n s t a l l e d   w i t h   t h e   s o f t w a r e . 
 
 U s i n g   t h e   C o m p o n e n t s 
 
 D E C t a l k   S o f t w a r e   a p p l i c a t i o n s   a n d   a p p l i c a t i o n - b u i l d i n g   c o m p o n e n t s   a r e   i n t e n d e d   f o r   t w o   s p e c i f i c   a u d i e n c e s :   t h e   a p p l i c a t i o n   p r o g r a m m e r   a n d   t h e   g e n e r a l   u s e r   o f   t e x t - t o - s p e e c h   a p p l i c a t i o n s   d e v e l o p e d   w i t h   t h e   D E C t a l k   S o f t w a r e   A P I . 
 
 A p p l i c a t i o n   P r o g r a m m e r 
 
 
 
 A s   a   D E C t a l k   S o f t w a r e   a p p l i c a t i o n   p r o g r a m m e r ,   y o u   c a n   u s e   t h e   D E C t a l k   S o f t w a r e   p r o g r a m m i n g   a i d s   a n d   A P I   c o m p o n e n t s   t o   c r e a t e   a p p l i c a t i o n s   t h a t   u s e   D E C t a l k   S o f t w a r e .   T h e s e   a p p l i c a t i o n s   c a n   i n c o r p o r a t e   t e x t   f i l e s   a n d   u s e   D E C t a l k   S o f t w a r e   i n - l i n e   c o m m a n d s   a s   p e r m a n e n t   p a r t s   o f   t h e   a p p l i c a t i o n . 
 
 G e n e r a l   U s e r 
 
 
 
 T h e   g e n e r a l   u s e r   c o n v e r t s   A S C I I   t e x t   f i l e s   t o   s p e e c h   b y   u s i n g   a n   a p p l i c a t i o n   t h a t   i n c o r p o r a t e s   D E C t a l k   S o f t w a r e .     B y   u s i n g   a n   a b b r e v i a t e d   s e t   o f   D E C t a l k   S o f t w a r e   i n - l i n e   c o m m a n d s   a n d   t h e   u s e r - d e f i n e d   d i c t i o n a r y ,   t h e   g e n e r a l   u s e r   c a n   f i n e - t u n e   t h e   b a s i c   p r o n u n c i a t i o n   a n d   v o i c e   c h a r a c t e r i s t i c s   d e f i n e d   i n   t h e   a p p l i c a t i o n . 
 
 H o w   I t   W o r k s   
 
 D E C t a l k   S o f t w a r e   c o n v e r t s   E n g l i s h   l a n g u a g e   A S C I I   t e x t   i n t o   s p e e c h   o u t p u t   t h r o u g h   a   s p e e c h   s y n t h e s i z e r .   T h e   t w o   w a y s   t o   f e e d   t e x t   i n t o   t h e   s p e e c h   s y n t h e s i z e r   a r e :   
 
 T h r o u g h   t h e   D E C t a l k   s a m p l e   a p p l i c a t i o n   u s e r   i n t e r f a c e .   
 
 	 o r 
 
 B y   w a y   o f   p r o g r a m m i n g   c a l l s   i n   y o u r   o w n   a p p l i c a t i o n   p r o g r a m   u s i n g   t h e   D E C t a l k   S o f t w a r e   A P I .   
 
 T h e   f l o w   o f   t h e   t e x t - t o - s p e e c h   p r o c e s s   i s   s h o w n   i n   F i g u r e   1 - 4 . 
 
 F i g u r e   1 - 4   F l o w   o f   t h e   D E C t a l k   S o f t w a r e   T e x t - T o - S p e e c h   C o n v e r s i o n   P r o c e s s 
 
 
 
 L e g e n d 
 
 
 
 
 
 T e x t   i s   s e l e c t e d   f o r   p r o c e s s i n g   b y   D E C t a l k   S o f t w a r e . 
 
 
 
 A   s e n t e n c e   p a r s e r   b r e a k s   t h e   i n p u t   s t r e a m   i n t o   s e p a r a t e   w o r d s   a n d   l o c a t e s   s o m e   c l a u s e   b o u n d a r i e s   ( i n d i c a t e d   b y   c o m m a s   a n d   o t h e r   p u n c t u a t i o n   m a r k s   a s   w e l l   a s   b y   s p e c i a l   w o r d s   l o a d e d   i n   t h e   D E C t a l k   S o f t w a r e   i n t e r n a l   d i c t i o n a r y ) .   T h e   s e n t e n c e   p a r s e r   a l s o   r e c o g n i z e s   a n d   d e a l s   w i t h   p h o n e m i c   s y m b o l s   a n d   c o m m a n d s   t h a t   y o u   m i g h t   h a v e   a d d e d   t o   t h e   i n p u t   t e x t . 
 
 A   w o r d   p a r s e r   b r e a k s   w o r d s   i n t o   t h e i r   c o m p o n e n t   p a r t s ,   d i v i d i n g   w o r d s   b y   t h e i r   f i n a l   p r o n o u n c e a b l e   f o r m .   S t r i n g s   o f   t e x t   t h a t   d o   n o t   f o r m   p r o n o u n c e a b l e   E n g l i s h   w o r d s   a r e   s p e l l e d   o u t   l e t t e r   b y   l e t t e r .   A   n u m b e r   f o r m a t t e r   i s   u s e d   i f   t h e   t e x t   c o n t a i n s   n u m e r a l s .   T h e   n u m b e r   f o r m a t t e r   a p p l i e s   t h e   r u l e s   f o r   m a n y   c o m m o n   n u m b e r   f o r m a t s   a n d   c o n v e r t s   t h e   n u m b e r s   i n t o   E n g l i s h   w o r d s .   
 
 
 
 A   d i c t i o n a r y   l o o k u p   r o u t i n e   s e a r c h e s   t h e   p r o n u n c i a t i o n   d i c t i o n a r i e s .   D E C t a l k   S o f t w a r e   h a s   a   b u i l t - i n   d i c t i o n a r y   o f   m a n y   c o m m o n l y   u s e d   w o r d s .   D E C t a l k   S o f t w a r e   a l s o   h a s   a   u s e r   d i c t i o n a r y   f o r   p r o g r a m m e r s   a n d   g e n e r a l   u s e r s   t h a t   c a n   b e   f i l l e d   w i t h   w o r d s   s p e c i f i c   t o   a n   a p p l i c a t i o n .   T h i s   d i c t i o n a r y   a n d   h o w   t o   l o a d   i t   a r e   d e s c r i b e d   i n   C h a p t e r   3 .   
 
 A   l e t t e r - t o - s o u n d   m o d u l e   u s e s   a   s e t   o f   E n g l i s h   p r o n u n c i a t i o n   r u l e s   t o   a s s i g n   p h o n e m i c   f o r m   a n d   l e x i c a l   s t r e s s   p a t t e r n s   t o   w o r d s   n o t   f o u n d   i n   t h e   d i c t i o n a r y .   S e e   C h a p t e r   3   f o r   m o r e   i n f o r m a t i o n   o n   m o d i f y i n g   t h e   p h o n e m i c   f o r m   o f   w o r d s ,   a n d   t h e   D E C t a l k   S o f t w a r e   R e f e r e n c e   G u i d e   f o r   e n h a n c i n g   s p e c i a l   v o i c e   q u a l i t i e s ,   s u c h   a s   e m p h a s i s   a n d   s i n g i n g . 
 
 
 
 A   p h r a s e   s t r u c t u r e   m o d u l e   r e c o m b i n e s   a l l   p h o n e m i c   o u t p u t   f r o m   t h e   d i c t i o n a r y   s e a r c h   a n d   o t h e r   m o d u l e s .   D u r a t i o n   o f   p h o n e m e s   a n d   p i t c h   c o m m a n d s   i s   c o m p u t e d   f o r   t h e   c l a u s e ,   a n d   a p p r o p r i a t e   s o u n d   v a r i a n t s   a r e   s e l e c t e d   f o r   t h o s e   p h o n e m e s   t h a t   c a n   b e   p r o n o u n c e d   i n   m o r e   t h a n   o n e   w a y . 
 
 T h e   p h o n e m e - t o - v o i c e   m o d u l e   p r o c e s s e s   c l a u s e s   p a s s e d   f r o m   t h e   p h r a s e   s t r u c t u r e   m o d u l e   a n d   c o n v e r t s   t h e m   t o   c o n t r o l   s i g n a l s   f o r   t h e   s p e e c h   s y n t h e s i z e r .   T h i s   m o d u l e   m o d i f i e s   t h e   c l a u s e s   b y   c h a n g i n g   t h e   p h o n e m e s / a l l o p h o n e s   i n t o   p a r a m e t e r s   t h a t   d e t e r m i n e   t h e   n a t u r a l   r e s o n a n t   f r e q u e n c i e s   o f   t h e   v o c a l   t r a c t   ( f o r m a n t s ) ,   a n d   s o u n d   s o u r c e   a m p l i t u d e s .   T h e   c o n t r o l   p a r a m e t e r s   a r e   s e n t   t o   t h e   s p e e c h   s y n t h e s i z e r   f o r   o u t p u t . 
 
 
 
 T h e   D I G I T A L   s p e e c h   s y n t h e s i z e r   c o m p u t e s   a   s p e e c h   w a v e f o r m   w i t h   a c o u s t i c   c h a r a c t e r i s t i c s   t h a t   a r e   d e t e r m i n e d   b y   t h e   s y n t h e s i z e r   c o n t r o l   c o m m a n d s . 
 
 
 
 
 
 C h a p t e r   2 - 
 
 U s i n g   t h e   P r o g r a m   A p p l e t s   t o   L e a r n   D E C t a l k   S o f t w a r e   B a s i c s 
 
 T h i s   c h a p t e r   i n t r o d u c e s   t h e   b a s i c   o p e r a t i o n s   i n v o l v e d   i n   D E C t a l k   S o f t w a r e   v o i c e   a n d   p r o g r a m   c o n t r o l .   I f   y o u   a r e   a   g e n e r a l   u s e r ,   t h i s   c h a p t e r   g i v e s   y o u   t h e   i n f o r m a t i o n   y o u   n e e d   t o   u s e   t h e   S a m p l e ,   S p e a k ,   a n d   U s e r   D i c t i o n a r y   B u i l d   T o o l   p r o g r a m   a p p l e t s .   I f   y o u   a r e   a n   a p p l i c a t i o n   p r o g r a m m e r   a n d   n o t   f a m i l i a r   w i t h   D E C t a l k   S o f t w a r e ,   t h i s   c h a p t e r   i n t r o d u c e s   t h e   b a s i c   v o i c e   a n d   p r o g r a m   c o n t r o l   f u n c t i o n s   u s e d   t o   c o n t r o l   D E C t a l k   S o f t w a r e   f r o m   w i t h i n   a n   a p p l i c a t i o n   p r o g r a m .   T o p i c s   i n c l u d e : 
 
 S t a r t i n g   t h e   s a m p l e   a p p l e t   a n d   o p e n i n g   a   t e x t   f i l e 
 
 I n s e r t i n g   D E C t a l k   S o f t w a r e   i n - l i n e   c o m m a n d s 
 
 C h a n g i n g   v o i c e   s e l e c t i o n s 
 
 E d i t i n g   a   t e x t   f i l e   a n d   c h a n g i n g   t h e   s p e a k i n g   r a t e 
 
 O v e r v i e w   o f   t h e   U s e r   D i c t i o n a r y   B u i l d   T o o l 
 
 B u i l d i n g   a   u s e r   d i c t i o n a r y 
 
 U s i n g   t h e   D E C t a l k   S o f t w a r e   S p e a k   a p p l e t 
 
 R u n n i n g   D E C t a l k   S o f t w a r e   f r o m   o t h e r   a p p l i c a t i o n s 
 
 U s i n g   t h e   S a y   c o m m a n d - l i n e   a p p l e t 
 
 S t a r t i n g   t h e   S a m p l e   A p p l e t   a n d   O p e n i n g   a   T e x t   F i l e 
 
 T h e   f a s t e s t   w a y   t o   s t a r t   l e a r n i n g   a b o u t   D E C t a l k   S o f t w a r e   i s   b y   u s i n g   t h e   S a m p l e   p r o g r a m   a p p l e t   t o   c o n v e r t   a n   A S C I I   t e x t   f i l e   t o   s p e e c h .   A f t e r   y o u   s t a r t   t h e   p r o g r a m   a p p l e t   a n d   s p e a k   a   t e x t   f i l e ,   y o u   c a n   t h e n   l e a r n   m o r e   a b o u t   c o n t r o l l i n g   v o i c e   c h a r a c t e r i s t i c s   t h r o u g h   D E C t a l k   S o f t w a r e   i n - l i n e   c o m m a n d s   a n d   t h e   u s e r   d i c t i o n a r y ,   w h i c h   a r e   c o v e r e d   l a t e r   i n   t h i s   c h a p t e r .   
 
 F i g u r e   2 - 1   S t a r t i n g   t h e   S a m p l e   A p p l e t   a n d   O p e n i n g   a   T e x t   F i l e 
 
 
 
 T a b l e   2 - 1   S t a r t i n g   t h e   S a m p l e   A p p l e t   a n d   O p e n i n g   a   T e x t   F i l e 
 
 T a s k / L o c a t i o n 
 
 
 
 A c t i o n 
 
 R e s u l t 
 
 S p e a k i n g   a   F i l e   u s i n g   t h e   S a m p l e   A p p l e t 
 
 D E C t a l k   S o f t w a r e   p r o g r a m   g r o u p   ( 1 ) 
 
 1 . 
 
 D o u b l e   c l i c k   t h e   S a m p l e   a p p l e t   i c o n   ( 2 ) 
 
 T h e   S a m p l e   a p p l e t   d i a l o g   i s   d i s p l a y e d .   ( 3 ) 
 
 
 
 2 . 
 
 P u l l   d o w n   t h e   L a n g u a g e   m e n u   a n d   s e l e c t   t h e   l a n g u a g e   o f   y o u r   c h o i c e . 
 
 
 
 
 
 3 . 
 
 P u l l   d o w n   t h e   F i l e   m e n u   a n d   s e l e c t   O p e n .   ( 4 ) 
 
 T h e   O p e n   a   F i l e   d i a l o g   b o x   i s   d i s p l a y e d .   ( 5 ) 
 
 O p e n   F i l e   d i a l o g   b o x   ( 5 ) 
 
 4 . 
 
 S e l e c t   t h e   f i l e   y o u   w a n t   D E C t a l k   S o f t w a r e   t o   s p e a k .   ( 6 ) 
 
 T h e   f i l e   i s   d i s p l a y e d   i n   t h e   S a m p l e   a p p l e t   d i a l o g . ( 7 ) 
 
 S t a r t   b u t t o n   ( 8 )   
 
 5 . 
 
 C l i c k   t h e   s t a r t   b u t t o n .   
 
 D E C t a l k   S o f t w a r e   s t a r t s   s p e a k i n g   t h e   f i l e . 
 
 P a u s e   a n d   s t o p   b u t t o n s   ( 9 )   ( 1 0 ) 
 
 6 . 
 
 C l i c k   t h e   P a u s e   o r   S t o p   b u t t o n   a s   n e e d e d .   
 
 D E C t a l k   S o f t w a r e   p a u s e s   o r   s t o p s   t h e   s p e a k i n g   s e s s i o n .   
 
 S p e a k i n g   a   F i l e   u s i n g   D r a g   a n d   D r o p 
 
 F i l e   m a n a g e r   w i t h   t e x t   f i l e   n a m e   v i s i b l e   ( n o t   s h o w n   h e r e ) 
 
 1 . 
 
 C l i c k   t h e   f i l e   n a m e ,   a n d   d r a g   t o   s a m p l e   a p p l e t   d i a l o g   o r   t o   t h e   m i n i m i z e d   D E C t a l k   S o f t w a r e   i c o n .   
 
 T h e   f i l e   i s   s p o k e n . 
 
 I n s e r t i n g   D E C t a l k   S o f t w a r e   I n - L i n e   C o m m a n d s   ( S y n t a x   R u l e s )   
 
 B e f o r e   y o u   c a n   u s e   D E C t a l k   S o f t w a r e   i n - l i n e   c o m m a n d s   t o   m o d i f y   s p e e c h   o u t p u t ,   y o u   n e e d   t o   k n o w   t h e   p r o p e r   s y n t a x   w i t h   w h i c h   t o   i n c l u d e   t h o s e   c o m m a n d s   i n t o   a   t e x t   f i l e .   F i g u r e   2 - 2   i l l u s t r a t e s   t h e   r u l e s   o f   D E C t a l k   S o f t w a r e   i n - l i n e   c o m m a n d   s y n t a x .     F o r   c o m p l e t e   d e t a i l s   a b o u t   D E C t a l k   S o f t w a r e   i n - l i n e   c o m m a n d s ,   s e e   t h e   D E C t a l k   S o f t w a r e   R e f e r e n c e   G u i d e . 
 
 F i g u r e   2 - 2   R u l e s   f o r   D E C t a l k   S o f t w a r e   I n - L i n e   C o m m a n d   S y n t a x 
 
 
 
 L e g e n d 
 
 ( 
 
 E n c l o s e   e v e r y   c o m m a n d   w i t h i n   b r a c k e t s .   
 
 ( 
 
 S o m e   c o m m a n d s   h a v e   a n   a l t e r n a t e   c o m m a n d   t o   s i m p l i f y   i n p u t .     H e r e   t h e   : n a m e   c o m m a n d   a n d   i t s   a r g u m e n t   B e t t y   c a n   b e   r e p l a c e d   b y   t h e   a l t e r n a t e   c o m m a n d   : n b . 
 
 (   
 
 B e g i n   e v e r y   c o m m a n d   w i t h   a   c o l o n .   
 
 ( 
 
 S e p a r a t e   e a c h   c o m m a n d   n a m e   a n d   i t s   o p t i o n   o r   p a r a m e t e r   f r o m   t h e   c o m m a n d   n a m e   t e x t   b y   a   v a l i d   w o r d   b o u n d a r y   m a r k e r .     T h e   v a l i d   w o r d   b o u n d a r y   m a r k e r s   a r e   a   s p a c e   a n d   a     t a b .   A   s p a c e   i s   u s e d   h e r e . 
 
 ( 
 
 I n c l u d e   s e v e r a l   o p t i o n s   a n d   p a r a m e t e r s   w i t h i n   t h e   s a m e   b r a c k e t s   i f   t h e   c o m m a n d   a l l o w s   m o r e   t h a n   o n e   o p t i o n   a n d   p a r a m e t e r .     I n   t h i s   e x a m p l e ,   t h e   o p t i o n   a n d   p a r a m e t e r   g r o u p i n g   m o d i f i e s   t h e   [ : d v ]   c o m m a n d . 
 
 ( 
 
 I f   y o u   g i v e   t w o   c o n f l i c t i n g   c o m m a n d s ,   D E C t a l k   S o f t w a r e   u s e s   t h e   l a s t   c o m m a n d   i n   t h e   s e q u e n c e .   I n   t h i s   e x a m p l e ,   D E C t a l k   S o f t w a r e   u s e s   P a u l ' s   v o i c e . 
 
 ( 
 
 I f   y o u   e n a b l e   p h o n e m e   i n t e r p r e t a t i o n   b y   u s i n g   t h e   [ : p h o n e m e   a r p a b e t   s p e a k   o n ]   c o m m a n d ,   y o u   c a n   i n c l u d e   p h o n e t i c   s p e l l i n g   f o r   t e x t - t o - s p e e c h   s y n t h e s i s .     T h e   p h o n e t i c   s p e l l i n g   r e p l a c e s   t h e   a c t u a l   s p e l l i n g   a n d   i s   e n c l o s e d   w i t h i n   b r a c k e t s .     I n   t h i s   e x a m p l e ,   t h e   p h o n e t i c   s p e l l i n g   o f   w o r d   r e a l l y   ( r ' i y l i y )   i s   i n c l u d e d . 
 
 A d d i t i o n a l   S y n t a x   R u l e s 
 
 I f   t h e   v a l u e   i n   a   [ : d v ]   c o m m a n d   i s   t o o   l o w ,   D E C t a l k   S o f t w a r e   u s e s   t h e   m i n i m u m   v a l i d   v a l u e .   I f   t h e   v a l u e   i s   t o o   h i g h ,   i t   u s e s   t h e   m a x i m u m   v a l i d   v a l u e . 
 
 A f t e r   y o u   e n t e r   a   c o m m a n d ,   t h a t   c o m m a n d   a p p l i e s   t o   t h e   r e m a i n i n g   t e x t   u n t i l   i t   i s   o v e r r i d d e n   b y   a n o t h e r   c o m m a n d .   F o r   e x a m p l e ,   t h e   c o m m a n d   [ : n k ]   i n v o k e s   K i t ' s   v o i c e   o n   a l l   e n t e r e d   t e x t   u n t i l   y o u   e n t e r   a n o t h e r   v o i c e - s e l e c t i o n   c o m m a n d . 
 
 I n v a l i d   c o m m a n d s   a r e   i g n o r e d .   B y   s e t t i n g   t h e   [ : e r r o r   s p e a k ]   c o m m a n d ,   y o u   c a n   r e c e i v e   a n   a u d i b l e   w a r n i n g   t h a t   a n   i n v a l i d   c o m m a n d   h a s   b e e n   e n t e r e d . 
 
 D o   n o t   p u t   a r p a b e t   p a r a m e t e r s   w i t h i n   t h e   b r a c k e t s   f o r   a n o t h e r   c o m m a n d . 
 
 D E C t a l k   S o f t w a r e   i n t e r p r e t s   t e x t   b e t w e e n   b r a c k e t s   a s   p h o n e m e s   o n l y   a f t e r   t h e   [ : p h o n e m e   a r p a b e t   s p e a k   o n ]   c o m m a n d   i s   s e n t   t o   t h e   a p p l i c a t i o n .   I f   [ : p h o n e m e   a r p a b e t   s p e a k   o n ]   h a s   n o t   b e e n   s e n t ,   D E C t a l k   S o f t w a r e   i n t e r p r e t s   t h e   b r a c k e t s   a n d   c h a r a c t e r s   b e t w e e n   t h e m   l i t e r a l l y .   T h e   [ : p h o n e m e   a r p a b e t   s p e a k   o f f ]   c o m m a n d   m u s t   b e   s e n t   w i t h   l i t e r a l   c h a r a c t e r s   i f   y o u   w a n t   t o   i n s e r t   b r a c k e t s   i n   n o r m a l   t e x t . 
 
 I f   t h e   c o m m a n d   [ : p h o n e m e   a r p a b e t   s p e a k   o n ]   i s   s e t   a n d   y o u   f o r g e t   t h e   r i g h t   b r a c k e t   (   ]   ) ,   D E C t a l k   S o f t w a r e   a t t e m p t s   t o   i n t e r p r e t   a l l   t e x t   f o l l o w i n g   t h e   A S C I I   t e x t   a s   p h o n e m e s ,   s k i p p i n g   o v e r   i l l e g a l   l e t t e r   c o m b i n a t i o n s .   T h e   r e s u l t i n g   t e x t   s o u n d s   g a r b l e d .   E n t e r   a   r i g h t   b r a c k e t   t o   f i x   t h i s   p r o b l e m . 
 
 C h a n g i n g   S p e a k i n g   V o i c e 
 
 Y o u   c a n   c h a n g e   a   s p e a k i n g   v o i c e   b y   i n s e r t i n g   D E C t a l k   S o f t w a r e   c o m m a n d s   i n t o   t h e   e d i t   w i n d o w   o f   t h e   S a m p l e   p r o g r a m   a p p l e t   d i a l o g   o r   b y   s e l e c t i n g   t e x t   a n d   t h e n   s e l e c t i n g   a   d i f f e r e n t   n a m e   f r o m   t h e   V o i c e   p u l l - d o w n   m e n u   i n   t h e   S a m p l e   p r o g r a m   a p p l e t   d i a l o g .   V o i c e   c h a n g e s   m a d e   w i t h   c o m m a n d s   a r e   p e r m a n e n t   f o r   t h e   s e s s i o n   a n d   r e m a i n   i n t a c t   a s   l o n g   a s   t h e   c o m m a n d   r e m a i n s   i n   t h e   f i l e .   V o i c e   c h a n g e s   m a d e   f r o m   t h e   m e n u   o n l y   r e m a i n   i n   e f f e c t   a s   l o n g   a s   t h e   c u r r e n t   D E C t a l k   S o f t w a r e   s e s s i o n   i s   r u n n i n g .   E a c h   v o i c e   s e l e c t i o n   i s   i n s e r t e d   i n t o   t h e   c o m m a n d   [ : n X X ] ,   w h e r e   X X   i s   a   v a l u e   r e p r e s e n t i n g   o n e   o f   t h e   v o i c e s .   T a b l e   2 - 2   l i s t s   t h e   n a m e s   a n d   t h e i r   c o r r e s p o n d i n g   v a l u e s .   
 
 Y o u   c a n   c h a n g e   v o i c e s   w i t h   a   c o m m a n d   a s   s h o w n   i n   t h e   f o l l o w i n g   e x a m p l e . 
 
 [ : n b ]   H e l l o .   I ' m   B e t t y . 
 
 Y o u   c a n   a l s o   c h a n g e   v o i c e s   i n   t h e   m i d d l e   o f   a   s e n t e n c e . 
 
 [ : n p ]   T h i s   i s   a   d e m o   [ : n b ]   o f   a   s u d d e n   c h a n g e   i n   v o i c e . 
 
 I f   a   v o i c e - c h a n g e   r e q u e s t   o c c u r s   i n   t h e   m i d d l e   o f   a   s e n t e n c e ,   D E C t a l k   S o f t w a r e   a u t o m a t i c a l l y   p a u s e s .   T h e   p a u s e   i s   t h e   e q u i v a l e n t   o f   i n s e r t i n g   a   c o m m a ,   o r   a b o u t   h a l f   a   s e c o n d . 
 
 [ : n p ]   T h i s   i s   a   d e m o ,   [ : n b ]   o f   a   s u d d e n   c h a n g e   i n   v o i c e . 
 
 T a b l e   2 - 2   D E C t a l k   V o i c e s   a n d   t h e i r   A s s o c i a t e d   V a l u e s 
 
 N a m e 
 
 V a l u e 
 
 N a m e 
 
 V a l u e 
 
 P a u l   
 
 P 
 
 B e t t y   
 
 B 
 
 H a r r y 
 
 H 
 
 U r s u l a 
 
 U 
 
 F r a n k 
 
 F 
 
 W e n d y 
 
 W 
 
 D e n n i s   
 
 D 
 
 R i t a 
 
 R 
 
 K i t   
 
 K 
 
 
 
 
 
 F i g u r e   2 - 3   C h a n g i n g   D E C t a l k   S o f t w a r e   V o i c e s 
 
 
 
 T a b l e   2 - 3   C h a n g i n g   V o i c e s 
 
 T a s k / L o c a t i o n 
 
 
 
 A c t i o n 
 
 R e s u l t 
 
 U s i n g   t h e   V o i c e   m e n u 
 
 S a m p l e   a p p l e t   d i a l o g   ( 1 )   
 
 1 . 
 
 S e l e c t   t h e   d e s i r e d   s p e a k i n g   v o i c e   f r o m   t h e   V o i c e   m e n u .   ( 2 ) 
 
 
 
 
 
 2 . 
 
 P r e s s   t h e   s t a r t   b u t t o n .   ( 3 ) 
 
 T h e   e n t i r e   f i l e   o r   s e l e c t e d   s e c t i o n   i s   s p o k e n . 
 
 U s i n g   D E C t a l k   S o f t w a r e   i n - l i n e   c o m m a n d s 
 
 S a m p l e   a p p l e t   d i a l o g   ( 1 ) 
 
 1 . 
 
 I n s e r t   c o m m a n d s   i n   t h e   t e x t   a t   t h e   p o i n t s   w h e r e   y o u   w a n t   a   n e w   v o i c e   t o   t a k e   e f f e c t . ( 4 ) 
 
 D E C t a l k   S o f t w a r e   c h a n g e s   t h e   s p e a k i n g   v o i c e   a t   t h e   p o i n t   w h e r e   y o u   i n s e r t   c o m m a n d s . 
 
 E d i t i n g   a   T e x t   F i l e   a n d   C h a n g i n g   t h e   S p e a k i n g   R a t e   
 
 D E C t a l k   S o f t w a r e   l e t s   y o u   e d i t   t e x t   -   s e l e c t ,   c u t ,   p a s t e ,   a p p e n d   o t h e r   t e x t   f i l e s   -   t h a t   i s   d i s p l a y e d   i n   t h e   S a m p l e   p r o g r a m   a p p l e t   w i n d o w   a n d   t h e n   p l a y   s e g m e n t s   o r   a l l   o f   t h e   e d i t e d   t e x t . 
 
 Y o u   c a n   a l s o   i n c r e a s e   a n d   d e c r e a s e   t h e   r a t e   a t   w h i c h   D E C t a l k   S o f t w a r e   s p e a k s   a   f i l e   o r   a   s e c t i o n   o f   a   f i l e .   
 
 F i g u r e   2 - 4   E d i t i n g   a   T e x t   F i l e   a n d   C h a n g i n g   t h e   S p e a k i n g   R a t e 
 
 
 
 
 
 T a b l e   2 - 4   E d i t i n g   a   T e x t   F i l e   a n d   C h a n g i n g   t h e   S p e a k i n g   R a t e 
 
 T a s k / L o c a t i o n 
 
 
 
 A c t i o n 
 
 R e s u l t 
 
 E d i t i n g   t h e   t e x t 
 
 D E C t a l k   S o f t w a r e   S a m p l e   a p p l e t   d i a l o g   ( 1 ) 
 
 1 . 
 
 S e l e c t   t h e   r a n g e   o f   t e x t   y o u   w a n t   t o   e d i t .   ( 2 ) 
 
 
 
 
 
 2 . 
 
 U s e   c u t ,   c o p y ,   p a s t e ,   a n d   d e l e t e   s e l e c t i o n s   f r o m   t h e   E d i t   p u l l - d o w n   m e n u     ( 3 )     t o   m a n i p u l a t e   t h e   s e l e c t e d   t e x t .     Y o u   c a n   a l s o   i n s e r t   t e x t   a n d   D E C t a l k   S o f t w a r e   c o m m a n d s   b y   p l a c i n g   t h e   c u r s o r   a n y w h e r e   i n   t h e   t e x t   a n d   t y p i n g . 
 
 
 
 
 
 3 . 
 
 C l i c k   o n   t h e   S t a r t   b u t t o n .   ( 4 ) 
 
 D E C t a l k   S o f t w a r e   s p e a k s   t h e   e d i t e d   f i l e   i n   t h e   n e w ,   e d i t e d   f o r m a t . 
 
 P l a y i n g   s e l e c t e d   t e x t 
 
 D E C t a l k   S o f t w a r e   S a m p l e   a p p l e t   d i a l o g   ( 1 ) 
 
 1 . 
 
 S e l e c t   t h e   r a n g e   o f   t e x t   y o u   w a n t   t o   p l a y .     ( 2 )   
 
 
 
 
 
 2 . 
 
 C l i c k   o n   t h e   r i g h t   m o u s e   
 
 ( M B 2   o r   3 )   b u t t o n . 
 
 D E C t a l k   s p e a k s   t h e   s e l e c t e d   t e x t . 
 
 C h a n g i n g   t h e   s p e a k i n g   r a t e 
 
 S a m p l e   a p p l e t   d i a l o g   a s   D E C t a l k   S o f t w a r e   i s   s p e a k i n g   a   f i l e   ( 1 ) 
 
 1 . 
 
 U s e   t h e   m o u s e   t o   p o s i t i o n   t h e   p o i n t e r   o n   t h e   r a t e   s l i d e r   b a r .   P r e s s   t h e   l e f t   m o u s e   ( M B 1 )   a n d   d r a g   t h e   s l i d e r   t o   t h e   l e f t   a n d   w a i t   f o r   t h e   s p e a k i n g   v o i c e   c h a n g e   t o   o c c u r .   T h e n   d r a g   t h e   s l i d e r   t o   t h e   r i g h t   ( 5 ) 
 
 T h e   s p e e d   a t   w h i c h   D E C t a l k   S o f t w a r e   s p e a k s   t h e   f i l e   c h a n g e s .   I t   i n c r e a s e s   i f   y o u   d r a g   t o   t h e   r i g h t   a n d   d e c r e a s e s   i f   y o u   d r a g   t o   t h e   l e f t .   T h e   r a t e   i n   w o r d s   p e r   m i n u t e   i s   d i s p l a y e d   t o   t h e   r i g h t   o f   t h e   s l i d e r   b a r .   C h a n g e s   i n   t h e   s p e a k i n g   r a t e   o c c u r   o n l y   o n   a   c l a u s e   b o u n d a r y   a f t e r   a l l   t h e   p r e v i o u s l y   q u e u e d   a u d i o   h a s   p l a y e d . 
 
 D E C t a l k   S a m p l e   a p p l e t   d i a l o g .   ( 1 ) 
 
 2 . 
 
 Y o u   c a n   a l s o   i n s e r t   D E C t a l k   S o f t w a r e   r a t e   c o m m a n d s   i n   t h e   t e x t .   ( 6 ) 
 
 W h e n   t h e   t e x t   i s   p l a y e d ,   D E C t a l k   c h a n g e s   t h e   r a t e   a c c o r d i n g   t o   t h e   c o m m a n d s . 
 
 O v e r v i e w   o f   t h e   U s e r   D i c t i o n a r y   B u i l d   T o o l 
 
 T h e   U s e r   D i c t i o n a r y   B u i l d   T o o l   c r e a t e s   a   l o a d a b l e   d i c t i o n a r y   f i l e   ( . d i c )   f r o m   a   l i s t   o f   w o r d s   a n d   t h e i r   c o r r e s p o n d i n g   p r o n u n c i a t i o n s .   T h e   d i c t i o n a r y   i s   l o a d e d   w i t h   a   c a l l   t o   t h e   T e x t T o S p e e c h L o a d U s e r D i c t i o n a r y   A P I   c a l l   o r   f r o m   t h e   F i l e   m e n u   i n   t h e   S p e a k   p r o g r a m   a p p l e t . 
 
 U s e   t h e   T r a n s l a t e   c o m m a n d   t o   c r e a t e   p h o n e m i c   t r a n s l a t i o n s   o f   w o r d s   o r   p h r a s e s . 
 
 F i g u r e   2 - 5   C o m p o n e n t s   o f   t h e   U s e r   D i c t i o n a r y   B u i l d   T o o l 
 
 
 
 L e g e n d 
 
 
 
 
 
 
 
 ( 1 ) 
 
 E d i t   W i n d o w   
 
 I n   t h e   e d i t   w i n d o w ,   e n t e r   w o r d - p r o n u n c i a t i o n   p a i r s   t h a t   a r e   n o t   p r e d e f i n e d   o r   n o t   p r o n o u n c e d   a s   d e s i r e d   i n   t h e   D E C t a l k   S o f t w a r e   u s e r   d i c t i o n a r y .       A   w o r d - p r o n u n c i a t i o n   p a i r   i s   a   w o r d ,   f o l l o w e d   b y   i t s   p h o n e m i c   s p e l l i n g   e n c l o s e d   i n   s q u a r e   b r a c k e t s . 
 
 ( 2 ) 
 
 F i l e   p u l l - d o w n   m e n u   
 
 O p e n . . .   A   p o p - u p   d i a l o g   b o x   t h a t   o p e n s   u p   a   d i c t i o n a r y   d e f i n i t i o n   f i l e   ( * . t a b ) .   
 
 C l o s e       C l o s e s   t h e   d i c t i o n a r y   d e f i n i t i o n   f i l e .     I f   t h e   e n t r i e s   i n   t h e   e d i t   w i n d o w   h a v e   b e e n   m o d i f i e d ,   i t   p o p s   a   d i a l o g   b o x   a s k i n g   i f   y o u   w i s h   t o   s a v e   c h a n g e s . 
 
 C o m p i l e   D i c t i o n a r y       C o m p i l e s   t h e   c u r r e n t   f i l e   t o   a   . d i c   f i l e   w i t h   t h e   s a m e   n a m e .   
 
 S a v e . . .   A   p o p - u p   d i a l o g   b o x   t h a t   s a v e s   t h e   f i l e   a n d   c a l l s   t h e   c o m p i l e r   t o   c r e a t e   a   d i c t i o n a r y   f i l e   ( * . d i c ) .   
 
 S a v e   a s . . .   A   p o p - u p   d i a l o g   b o x   t h a t   l e t s   t h e   u s e r   r e n a m e   t h e   f i l e .   T h i s   a l s o   c a l l s   t h e   c o m p i l e r   t o   c r e a t e   a   d i c t i o n a r y   f i l e   ( * . d i c ) .   
 
 E x i t       E x i t s   t h e   p r o g r a m ,   a n d   i f   t h e   e n t r i e s   i n   t h e   e d i t   w i n d o w   h a v e   b e e n   m o d i f i e d ,   i t   p o p s   a   d i a l o g   b o x   a s k i n g   i f   y o u   w i s h   t o   s a v e   c h a n g e s . 
 
 
 
 
 
 ( 3 ) 
 
 E d i t   p u l l - d o w n   m e n u   
 
 U n d o         U n d o   t h e   p r e v i o u s   c o m m a n d .   
 
 C u t               C u t   t h e   s e l e c t e d   r e g i o n .   
 
 C o p y         C o p y   t h e   s e l e c t e d   r e g i o n .   
 
 P a s t e         P a s t e   t h e   s e l e c t e d   r e g i o n .   
 
 D e l e t e       D e l e t e   t h e   s e l e c t e d   r e g i o n .   
 
 S e l e c t   A l l         S e l e c t   a l l   o f   t h e   w o r d - p r o n u n c i a t i o n   p a i r s   f r o m   t h e   e d i t   w i n d o w .   
 
 F i n d . . .   A   p o p - u p   d i a l o g   b o x   t h a t   p r o m p t s   y o u   t o   s e a r c h   f o r   s e l e c t e d   t e x t . 
 
 
 
 
 
 ( 4 ) 
 
 T r a n s l a t e   m e n u 
 
 T r a n s l a t e s   s e l e c t e d   t e x t   i n t o   p h o n e m i c   s p e l l i n g . 
 
 
 
 
 
 ( 5 ) 
 
 L a n g u a g e   p u l l - d o w n   m e n u 
 
 L i s t s   t h e   D E C t a l k   l a n g u a g e s .     U n i n s t a l l e d   l a n g u a g e s   a r e   g r a y e d   o u t . 
 
 
 
 
 
 ( 6 ) 
 
 H e l p   p u l l - d o w n   m e n u   
 
 S e l e c t s   t h e   o n l i n e   h e l p . 
 
 
 
 
 
 ( 7 ) 
 
 P r o n o u n c e   W o r d   b u t t o n 
 
 W h e n   c l i c k e d ,   t h e   s e l e c t e d   t e x t   i n   t h e   e d i t   w i n d o w   i s   s p o k e n .     I f   a   w o r d - p r o n u n c i a t i o n   p a i r   i s   s e l e c t e d ,   t h e   p h o n e m i c   p r o n u n c i a t i o n   i s   u s e d .     I f   o n l y   t h e   w o r d   i s   s e l e c t e d ,   t h e   c u r r e n t l y   s t o r e d   p r o n u n c i a t i o n   i s   u s e d . 
 
 ( 8 ) 
 
 P r e v i o u s   b u t t o n 
 
 W h e n   c l i c k e d ,   t h e   p r e v i o u s   w o r d - p r o n u n c i a t i o n   p a i r   i n   t h e   l i s t   i s   s p o k e n . 
 
 ( 9 ) 
 
 N e x t   b u t t o n 
 
 W h e n   c l i c k e d ,   t h e   n e x t   w o r d - p r o n u n c i a t i o n   p a i r   i n   t h e   l i s t   i s   s p o k e n . 
 
 B u i l d i n g   a   U s e r   D i c t i o n a r y 
 
 B u i l d i n g   a   u s e r   d i c t i o n a r y   i s   a   t w o - s t e p   p r o c e s s .   F i r s t   y o u   c r e a t e   a   . t a b   s o u r c e   f i l e   w i t h   t h e   U s e r   D i c t i o n a r y   B u i l d   T o o l   t o   d e f i n e   t h e   p r o n u n c i a t i o n   o f   s p e c i a l   w o r d s   y o u   w a n t   t o   p l a c e   i n   t h e   d i c t i o n a r y .   
 
 F i g u r e   2 - 6   B u i l d i n g   a   U s e r   D i c t i o n a r y 
 
 
 
 
 
 T a b l e   2 - 5   B u i l d i n g   a   U s e r   D i c t i o n a r y 
 
 T a s k / L o c a t i o n 
 
 
 
 A c t i o n 
 
 R e s u l t 
 
 C r e a t i n g   o r   m o d i f y i n g   d i c t i o n a r y   e n t r i e s 
 
 D E C t a l k   S o f t w a r e       ( 1 )   p r o g r a m   g r o u p   
 
 1 . 
 
 D o u b l e   c l i c k   o n   t h e   U s e r   D i c t i o n a r y   i c o n .   
 
 T h e   D E C t a l k   S o f t w a r e   D i c t i o n a r y   B u i l d e r   d i a l o g   i s   d i s p l a y e d .   ( 2 ) 
 
 F i l e   p u l l - d o w n   m e n u   ( 3 ) 
 
 2 . 
 
 S e l e c t   O p e n   t o   o p e n   a n   e x i s t i n g   d i c t i o n a r y   d e f i n i t i o n   ( . t a b )   f i l e .     
 
 Y o u   c a n   a l s o   c r e a t e   a   n e w   d i c t i o n a r y   d e f i n i t i o n   f i l e   b y   e n t e r i n g   w o r d s   d i r e c t l y . 
 
 T h e   O p e n   a   F i l e   d i a l o g   b o x   i s   d i s p l a y e d   ( n o t   s h o w n ) .     T h e   f i l e   y o u   s e l e c t   i s   d i s p l a y e d   i n   t h e   e d i t   w i n d o w . 
 
 E d i t   w i n d o w 
 
 3 . 
 
 E n t e r   w o r d s   t h a t   a r e   n o t   p r e d e f i n e d   o r   p r o n o u n c e d   a s   d e s i r e d   i n   t h e   D E C t a l k   u s e r   d i c t i o n a r y .     D E C t a l k   n e e d s   t o   k n o w   b o t h   t h e   w o r d   a n d   t h e   p h o n e m i c   s p e l l i n g   y o u   w a n t   t o   a s s o c i a t e   w i t h   i t .     
 
 I f   y o u   k n o w   t h e   p h o n e m i c   s p e l l i n g ,   e n t e r   i t   u s i n g   t h e   f o l l o w i n g   f o r m a t : 
 
 w o r d 	 [ p h o n e m i c   s p e l l i n g ]   
 
 I f   y o u   d o   n o t   k n o w   t h e   p h o n e m i c   s p e l l i n g ,   e n t e r   t h e   w o r d   a s   i t   s o u n d s ,   r a t h e r   t h a n   a s   i t   i s   s p e l l e d .   
 
 
 
 4 . 
 
 S e l e c t   t h e   w o r d   a n d   c l i c k   T r a n s l a t e .     ( 4 )   
 
 F o r   e x a m p l e ,   t h e   Y u g o s l a v i a n   n a m e   J o v i c i c   s o u n d s   l i k e 
 
 Y o e v e e c h e e c h 
 
 T h e   U s e r   D i c t i o n a r y   B u i l d   T o o l   c o n v e r t s   w h a t   y o u   e n t e r e d   i n t o   a   p h o n e m i c   s p e l l i n g . 
 
 T h e   U s e r   D i c t i o n a r y   B u i l d   T o o l   c o n v e r t s   t h e   n a m e   t o : 
 
 [ y x '   o w v   i y c h i y c h ] 
 
 
 
 5 . 
 
 T o   h e a r   h o w   D E C t a l k   i n t e r p r e t s   t h e   p h o n e m i c   s p e l l i n g ,   s e l e c t   i t ,   a n d   c l i c k   P r o n o u n c e   W o r d .     ( 5 ) . 
 
 D E C t a l k   s p e a k s   t h e   w o r d . 
 
 
 
 6 . 
 
 B e s i d e s   p r o n u n c i a t i o n ,   y o u   c a n   a l s o   d e f i n e   w o r d   u s a g e . 
 
 F o r   e x a m p l e ,   t o   d e f i n e   t h e   w o r d   s o d a   t o   b e   e q u i v a l e n t   t o   p o p ;   d e f i n e   w a t e r   t o   b e   p r o n o u n c e d   w i t h   a   N e w   E n g l a n d   a c c e n t ;   a n d   t a k e   i n t o   a c c o u n t   t h e   d i a l e c t i c   r e g i o n a l   p r e f e r e n c e s   s o   t h a t   t h e   w o r d   s u b   i s   c a l l e d   a   h e r o ,   y o u   w o u l d   u s e   t h e   f o l l o w i n g   p r o n u n c i a t i o n   p a i r s : 
 
 S o d a   	 [ p   '   a a p ] 
 
 w a t e r   	 [ w   '   a o t r r ] 
 
 s u b s   	 [ h x '   i y r   o w ] 
 
 R e f e r   t o   t h e   D E C t a l k   S o f t w a r e   R e f e r e n c e   G u i d e   o r   o n l i n e   h e l p   ( t h e   R e f e r e n c e   T a b l e s )   f o r   a   c o m p l e t e   l i s t   o f   p h o n e m i c ,   s t r e s s ,   a n d   s y n t a c t i c   s y m b o l s .   B o t h   o f   t h e s e   s o u r c e s   p r o v i d e   m o r e   i n f o r m a t i o n   o n   m o d i f y i n g   a n d   e n h a n c i n g   p r o n u n c i a t i o n . 
 
 A f t e r   y o u   h a v e   c r e a t e d   t h e   . t a b   s o u r c e   f i l e ,   y o u   c o m p i l e   i t   t o   p r o d u c e   a   . d i c   f i l e .   T h i s   f i l e   i s   l o a d e d   i n t o   a   D E C t a l k   S o f t w a r e   s e s s i o n   t h r o u g h   t h e   S p e a k   a p p l e t   o r   a n   A P I   c a l l . 
 
 F i g u r e   2 - 7   S a v i n g   a n d   C o m p i l i n g   t h e   D i c t i o n a r y 
 
 
 
 T a b l e   2 - 6   S a v i n g   a n d   C o m p i l i n g   t h e   D i c t i o n a r y 
 
 T a s k / L o c a t i o n 
 
 
 
 A c t i o n 
 
 R e s u l t 
 
 S a v i n g   a n d   c o m p i l i n g   a   n e w   d i c t i o n a r y 
 
 F i l e   p u l l - d o w n   m e n u   ( 1 ) 
 
 1 . 
 
 D i s p l a y   t h e   f i l e   m e n u . 
 
 I f   y o u   h a v e   n o t   y e t   g i v e n   y o u r   f i l e   a   n a m e ,   c h o o s e   o n e   o f   t h e   f o l l o w i n g 
 
 C o m p i l e   D i c t i o n a r y     ( 2 ) 
 
 S a v e     ( 3 ) 
 
 S a v e   A s . . .     ( 4 )   
 
 T h e   S a v e   d i a l o g   b o x   i s   d i s p l a y e d   i n   a l l   t h r e e   c a s e s .     ( 5 ) 
 
 S a v e   a s   d i a l o g   b o x 
 
 2 . 
 
 N a v i g a t e   t o   t h e   l o c a t i o n   w h e r e   y o u   w a n t   t o   s a v e   t h e   d i c t i o n a r y   s e s s i o n   a n d   e n t e r   a   f i l e   n a m e .     ( 6 ) 
 
 A   s u c c e s s   m e s s a g e   ( 7 )   i s   d i s p l a y e d ,   i n d i c a t i n g   t h a t   b o t h   t h e   t e x t   f i l e   ( i n   . t a b   f o r m a t )   a n d   a   d i c t i o n a r y   f i l e   ( i n   . d i c   f o r m a t )   h a v e   b e e n   s a v e d . 
 
 S a v i n g   a n d   c o m p i l i n g   a n   e x i s t i n g   d i c t i o n a r y 
 
 F i l e   p u l l - d o w n   m e n u   ( 1 ) 
 
 1 . 
 
 C h o o s e   O p e n   f r o m   t h e   F i l e   m e n u   t o   o p e n   a n   e x i s t i n g   f i l e . 
 
 T h e   O p e n   a   F i l e   d i a l o g   b o x   i s   d i s p l a y e d   ( n o t   s h o w n ) .     T h e   d i c t i o n a r y   f i l e   ( . t a b   f i l e   t y p e )   y o u   c h o o s e   i s   d i s p l a y e d   i n   t h e   t e x t - c o l l e c t i o n   a r e a . 
 
 
 
 2 . 
 
 E d i t   t h e   f i l e   a s   d e s c r i b e d   i n   T a b l e   2 - 5 . 
 
 
 
 F i l e   p u l l - d o w n   m e n u   ( 1 ) 
 
 3 . 
 
 T o   s a v e   t h e   c h a n g e s   y o u   h a v e   m a d e   t o   t h e   . t a b   f i l e   w i t h o u t   c o m p i l i n g   t h e   d i c t i o n a r y ,     p u l l   d o w n   t h e   F i l e   m e n u   ( 1 )   a n d   c l i c k   S a v e   ( 3 ) . 
 
 T h e   c h a n g e s   y o u   h a v e   m a d e   a r e   s a v e d . 
 
 F i l e   p u l l - d o w n   m e n u   ( 1 ) 
 
 4 . 
 
 T o   s a v e   y o u r   c h a n g e s   a n d   c o m p i l e   t h e   d i c t i o n a r y ,   p u l l   d o w n   t h e   F i l e   m e n u   ( 1 )   a n d   c l i c k   C o m p i l e   D i c t i o n a r y .     ( 2 )   
 
 A   s u c c e s s   m e s s a g e   ( 7 )   i s   d i s p l a y e d   a n d   i n d i c a t e s   t h a t   b o t h   t h e   t e x t   f i l e   ( i n   . t a b   f o r m a t )   a n d   a   d i c t i o n a r y   f i l e   ( i n   . d i c   f o r m a t )   h a v e   b e e n   s a v e d . 
 
 U s i n g   t h e   D E C t a l k   S o f t w a r e   S p e a k   A p p l e t 
 
 T h e   S p e a k   p r o g r a m   a p p l e t   d e m o n s t r a t e s   t h e   D E C t a l k   S o f t w a r e   v o i c e   s e t .   E a c h   p i c t u r e   *   d i s p l a y e d   i n   t h e   S p e a k   d i a l o g   r e p r e s e n t s   o n e   o f   t h e   n i n e   b u i l t - i n   v o i c e s .   Y o u   c a n   s e l e c t   a   s p e c i f i c   v o i c e   b y   c l i c k i n g   t h e   p i c t u r e .   D E C t a l k   S o f t w a r e   t h e n   u s e s   t h e   s e l e c t e d   v o i c e   t o   s p e a k   t h e   c o n t e n t s   o f   a   t e x t   f i l e   d i s p l a y e d   i n   t h e   e d i t   w i n d o w   o r   f r o m   a   f i l e   y o u   d r a g   a n d   d r o p   f r o m   t h e   W i n d o w s   F i l e   M a n a g e r   i n t o   t h e   e d i t   w i n d o w   o f   t h e   S p e a k   d i a l o g .   
 
 *   N o t e   t h a t   t h e   f a c e s   a r e   c a r t o o n   c h a r a c t e r s   w h e n   u s i n g   V G A   1 6 - c o l o r   m o d e . 
 
 F i g u r e   2 - 8   U s i n g   t h e   D E C t a l k   S o f t w a r e   S p e a k   A p p l e t 
 
 
 
 T a b l e   2 - 7   U s i n g   t h e   D E C t a l k   S p e a k   A p p l i c a t i o n 
 
 T a s k / L o c a t i o n 
 
 
 
 A c t i o n 
 
 R e s u l t 
 
 E d i t i n g   a   t e x t   f i l e   a n d   p l a y i n g   s e l e c t e d   s e g m e n t s 
 
 D E C t a l k   p r o g r a m   g r o u p     ( 1 ) 
 
 1 . 
 
 D o u b l e - c l i c k   o n   t h e   S p e a k   i c o n . 
 
 T h e   S p e a k   a p p l e t   d i a l o g     ( 2 )   d i s p l a y s . 
 
 F i l e   p u l l - d o w n   m e n u     ( 3 ) 
 
 2 . 
 
 C h o o s e   o p e n   ( 4 )   t o   c h o o s e   a   t e x t   f i l e ,   o r   e n t e r   t e x t   i n   t h e   e d i t   w i n d o w . 
 
 T h e   O p e n   A   F i l e   d i a l o g   b o x   d i s p l a y s   ( n o t   s h o w n ) .     T h e   f i l e   y o u   c h o o s e   i s   d i s p l a y e d   i n   t h e   e d i t   w i n d o w 
 
 S p e a k   a p p l e t   d i a l o g   ( 2 ) 
 
 3 . 
 
 S e l e c t   t h e   r a n g e   o f   t e x t   y o u   w a n t   t o   e d i t   o r   p l a y .   ( 5 ) 
 
 
 
 
 
 4 . 
 
 U s e   t h e   C u t ,   P a s t e ,   a n d   I n s e r t   k e y s   o r   c o r r e s p o n d i n g   c o m m a n d s   f r o m   t h e   E d i t   m e n u   t o   m a n i p u l a t e   t h e   s e l e c t e d   t e x t .   F o r   e x a m p l e ,   c u t   a n d   p a s t e   a   s i n g l e   s e n t e n c e   f o r   D E C t a l k   S o f t w a r e   t o   s p e a k . 
 
 
 
 
 
 5 . 
 
 C l i c k   t h e   f a c e   o f   t h e   v o i c e   y o u   w a n t   t o   s p e a k .   ( 6 ) 
 
 
 
 E d i t   m e n u   
 
 6 . 
 
 U s e   t h e   ( M B 2   o r   3 )   r i g h t   m o u s e   b u t t o n   t o   s p e a k   a   s e l e c t e d   r e g i o n   o r   p r e s s   t h e   P l a y ,   P a u s e ,   a n d   S t o p   b u t t o n s   ( 7 )   t o   p l a y   t h e   w h o l e   f i l e .   
 
 T h e   e d i t e d   f i l e   i s   s p o k e n . 
 
 C h a n g i n g   t h e   s p e a k i n g   r a t e 
 
 S p e a k   a p p l e t   d i a l o g   w h i l e   D E C t a l k   S o f t w a r e   i s   s p e a k i n g   a   f i l e 
 
 1 . 
 
 U s e   t h e   m o u s e   t o   p o s i t i o n   t h e   p o i n t e r   o n   t h e   r a t e   s l i d e r   b u t t o n .   ( 8 )     P r e s s   M B 1   a n d   d r a g   t h e   s l i d e r   t o   t h e   l e f t   a n d   w a i t   f o r   t h e   s p e a k i n g   r a t e   t o   s l o w .   T h e n   m o v e   t h e   s l i d e r   t o   t h e   r i g h t   t o   i n c r e a s e   t h e   r a t e . 
 
 T h e   r a t e   i n   w o r d s   p e r   m i n u t e   d i s p l a y s   t o   t h e   r i g h t   o f   t h e   s l i d e r   b a r .   R a t e   c h a n g e s   o c c u r   o n l y   a t   a   c l a u s e   b o u n d a r y   a n d   o n l y   a f t e r   a l l   p r e v i o u s l y   q u e u e d   a u d i o   h a s   p l a y e d . 
 
 L o a d i n g   a   U s e r   D i c t i o n a r y 
 
 F i l e   p u l l - d o w n   m e n u   ( 3 ) 
 
 1 . 
 
 S e l e c t   L o a d   U s e r   D i c t i o n a r y .   ( 9 )     N o t e   t h a t   t h e   c u r r e n t   U s e r   D i c t i o n a r y   i s   d e f i n e d   i n   t h e   d e c t a l k . i n i   f i l e   a n d   i s   l o a d e d   i f   a v a i l a b l e . 
 
 T h e   L o a d   D i c t i o n a r y   d i a l o g   b o x   ( n o t   s h o w n   h e r e )     i s   d i s p l a y e d . 
 
 
 
 2 . 
 
 S e l e c t   t h e   U s e r   D i c t i o n a r y   y o u   w a n t   t o   l o a d ,   a n d   p r e s s   E n t e r   o r   c l i c k   o n   O K . 
 
 T h a t   d i c t i o n a r y   i s   l o a d e d   a n d   r e m a i n s   i n   e f f e c t   u n t i l   y o u   c h a n g e   t h e   d i c t i o n a r y   o r   e n d   t h e   s e s s i o n . 
 
 S a v i n g   a s   a   . W A V   f i l e 
 
 F i l e   p u l l - d o w n   m e n u   ( 3 ) 
 
 1 . 
 
 P u l l   d o w n   t h e   F i l e   m e n u ,   s e l e c t   C o n v e r t   t o   W a v e   F i l e .   ( 1 0 )       S e l e c t   t h e   d e s i r e d   f o r m a t .   ( 1 1 )       S e l e c t   a   f i l e   n a m e   f o r   t h e   a u d i o   f i l e .   
 
 T h e   C o n v e r t   t o   W a v e   F i l e   d i a l o g   b o x   i s   d i s p l a y e d   ( n o t   s h o w n   h e r e ) .     T h e   t e x t   f i l e   i s   s a v e d   t o   t h e   s e l e c t e d   f i l e   a s   a   s t a n d a r d   w i n d o w   . w a v   f i l e . 
 
 F i g u r e   2 - 9   H i g h l i g h t i n g   S p o k e n   T e x t 
 
 
 
 T a s k / L o c a t i o n 
 
 
 
 A c t i o n 
 
 R e s u l t 
 
 H i g h l i g h t i n g   S p o k e n   T e x t 
 
 S p e a k   a p p l e t   d i a l o g   ,   E d i t   p u l l - d o w n   m e n u     ( 1 )   
 
 1 . 
 
 C l i c k   H i g h l i g h t i n g .   (   2   ) 
 
 T h e   H i g h l i g h t i n g   o p t i o n   i s   c h e c k e d . 
 
 S p e a k   a p p l e t   c o n t r o l s . 
 
 2 . 
 
 C l i c k   t h e   S t a r t   b u t t o n .     ( 3   ) 
 
 A s   D E C t a l k   s p e a k s   t h e   t e x t ,   e a c h   w o r d   i s   h i g h l i g h t e d .     ( 4   ) 
 
 
 
 R u n n i n g   D E C t a l k   S o f t w a r e   f r o m   O t h e r   A p p l i c a t i o n s 
 
 Y o u   c a n   r u n   D E C t a l k   S o f t w a r e   b y   w a y   o f   t h e   T e x t - T o - S p e e c h   D D E   s e r v e r   f r o m   a n y   a p p l i c a t i o n   t h a t   s u p p o r t s   D y n a m i c   D a t a   E x c h a n g e   ( D D E ) .     W h e n   r u n   f r o m   s u c h   a p p l i c a t i o n s ,   y o u   c a n   h a v e   D E C t a l k   s p e a k   a n y   s e l e c t e d   t e x t   a s s o c i a t e d   w i t h   t h e   a p p l i c a t i o n .     F o r   e x a m p l e ,   D E C t a l k   c a n   b e   " p l u g g e d   i n t o "   M i c r o s o f t   W o r d   a n d   t h e n   u s e d   a s   a   p r o o f i n g   t o o l   t o   r e a d   e n t i r e   f i l e s   o r   s e l e c t e d   s e c t i o n s   f r o m   t h o s e   f i l e s . 
 
 T h e   f o l l o w i n g   s e c t i o n   i s   a n   e x a m p l e   o f   h o w   t o   s e t   u p   a n d   t h e n   r u n   D E C t a l k   S o f t w a r e   f r o m   w i t h i n   a   M i c r o s o f t   W o r d   d o c u m e n t .   T h e   s t e p s   i n c l u d e : 
 
 1 ) C r e a t i n g   a   W o r d   m a c r o   a n d   a s s o c i a t i n g   i t   w i t h   a   f i l e   o r   d o c u m e n t   t e m p l a t e   ( f o r   W o r d   6 . 0 ) 
 
 2 ) A s s o c i a t i n g   t h e   m a c r o   w i t h   a   b u t t o n ,   m e n u   s e l e c t i o n ,   o r   h o t   k e y 
 
 3 ) L a u n c h i n g   t h e   D E C t a l k   T T S   S e r v e r   a n d   s p e a k i n g   t h e   t e x t 
 
 4 ) S p e a k i n g   t h e   t e x t   f r o m   w i t h i n   t h e   d o c u m e n t 
 
 
 
 S t e p   1   -   C r e a t i n g   a   W o r d   M a c r o   a n d   A s s o c i a t i n g   i t   w i t h   a   F i l e   o r   D o c u m e n t   T e m p l a t e   ( f o r   W o r d   7 . 0 ) 
 
 T h e   f i r s t   s t e p   i n   r u n n i n g   D E C t a l k   S o f t w a r e   f r o m   a   M i c r o s o f t   W o r d   d o c u m e n t   i s   c r e a t i n g   t h e   W o r d   m a c r o   t h a t   l i n k s   W o r d   a n d   D E C t a l k   t h r o u g h   D D E .   Y o u   o n l y   h a v e   t o   c r e a t e   t h i s   m a c r o   o n c e   a n d   a s s o c i a t e   i t   w i t h   a   b u t t o n ,   h o t   k e y ,   o r   m e n u   c o m m a n d .   I f   y o u   m a k e   t h e   m a c r o   p a r t   o f   a   p e r m a n e n t   . d o t   ( t e m p l a t e )   f i l e ,   D E C t a l k   S o f t w a r e   a l w a y s   i s   a v a i l a b l e   w h e n   y o u   e d i t   a   d o c u m e n t   a s s o c i a t e d   w i t h   t h a t   t e m p l a t e . 
 
 F i g u r e   2 - 1 0   C r e a t i n g   a   W o r d   M a c r o 
 
 
 
 T a b l e   2 - 8   C r e a t i n g   a   W o r d   M a c r o 
 
 T a s k / L o c a t i o n 
 
 
 
 A c t i o n 
 
 R e s u l t 
 
 W o r d   d i a l o g 
 
 1 . 
 
 S e l e c t   M a c r o   f r o m   t h e   T o o l s   M e n u .     ( 1 ) 
 
 T h e   M a c r o   d i a l o g   b o x   i s   d i s p l a y e d .   ( 2 ) 
 
  
 
 M a c r o   d i a l o g   b o x   ( 2 ) 
 
 2 . 
 
 E n t e r   t h e   n a m e   o f   t h e   m a c r o   y o u   a r e   g o i n g   t o   c r e a t e .   ( 3 ) 
 
 
 
 M a c r o   d i a l o g   b o x   ( 2 ) 
 
 3 . 
 
 C l i c k   t h e   C r e a t e   b u t t o n .   ( 4 ) 
 
 T h e   M a c r o   c r e a t i o n   w i n d o w   i s   d i s p l a y e d . ( 5 ) 
 
 M a c r o   c r e a t i o n   w i n d o w   ( 5 ) 
 
 4 . 
 
 I n s e r t   t h e   f o l l o w i n g   m a c r o :   ( N o t e :   y o u   c a n   o p e n   t h e   w o r d . t x t     f i l e   l o c a t e d   i n   t h e   \ D E C T A L K \   d i r e c t o r y ,   c o p y   i t ,   a n d   p a s t e   i t   i n t o   t h e   W o r d   m a c r o . ) 
 
 S u b   M A I N 
 
 I f   A p p I s R u n n i n g ( " T T S s r v " )   =   0   T h e n 
 
                 S h e l l   " T T S S R V . E X E " ,   0 
 
                 r i g h t N o w   =   N o w ( ) 
 
                 d i f f T i m e   =   0 
 
                 P r i n t   " S t a r t i n g   D E C t a l k   S e r v e r " 
 
                 W a i t C u r s o r   1 
 
                 W h i l e   d i f f T i m e   <   0 . 0 0 0 0 3 
 
                         d i f f T i m e   =   N o w ( )   -   r i g h t N o w 
 
                 W e n d 
 
                 W a i t C u r s o r   0 
 
                 P r i n t   "   " 
 
             I f   A p p I s R u n n i n g ( " T T S s r v " )   =   0   T h e n 
 
             M s g B o x ( " C a n n o t   f i n d   T T S S R V . E X E   i n   t h e   p a t h " ,   " S p e a k " ,   0 ) 
 
             G o t o   F I N I S 
 
             E n d   I f 
 
 E n d   I f 
 
             c h a n n e l   =   D D E I n i t i a t e ( " T T S s e r v e r " ,   " S p e a k " ) 
 
             I f   c h a n n e l   =   0   T h e n 
 
             M s g B o x ( " U n a b l e   t o   c o n n e c t   t o   T T S S R V . E X E " ,   " S p e a k " ,   0 ) 
 
             G o t o   F I N I S 
 
     E l s e 
 
         D D E P o k e   c h a n n e l ,   " S p e a k " ,   S e l e c t i o n $ ( ) 
 
         D D E T e r m i n a t e   c h a n n e l 
 
 F I N I S : 
 
 E n d   S u b 
 
 F i l e   p u l l - d o w n   m e n u .   
 
 5 . 
 
 O n   t h e   F i l e   m e n u ,   c l i c k   C l o s e     ( 6 ) .   C l i c k   Y e s     ( 7 )   w h e n   y o u   a r e   a s k e d   i f   y o u   w a n t   t o   k e e p   c h a n g e s   t o   t h e   m a c r o . 
 
 T h e   m a c r o   i s   c r e a t e d . 
 
 S t e p   2   -   A s s o c i a t i n g   t h e   M a c r o   w i t h   a   T o o l b a r   B u t t o n 
 
 A f t e r   y o u   c r e a t e   a   m a c r o   t o   r u n   D E C t a l k   f r o m   w i t h i n   a   M i c r o s o f t   W o r d   d o c u m e n t   ( s t e p   1 ) ,   y o u   c a n   a s s o c i a t e   t h e   m a c r o   w i t h   a   b u t t o n   o n   a   t o o l b a r .     Y o u   c a n   a l s o   a s s o c i a t e   t h e   m a c r o   w i t h   a   m e n u   s e l e c t i o n   f r o m   o n e   o f   t h e   p u l l - d o w n   m e n u s   o r   w i t h   a   p o w e r - k e y   c o m b i n a t i o n   f r o m   t h e   k e y b o a r d .   T h i s   s e c t i o n   i l l u s t r a t e s   h o w   t o   l i n k   t h e   m a c r o   w i t h   a   b u t t o n   o n   a   t o o l b a r .   
 
 F i g u r e   2 - 1 1   A s s o c i a t i n g   t h e   M a c r o   w i t h   a   T o o l b a r   B u t t o n 
 
 
 
 T a b l e   2 - 9   A s s o c i a t i n g   t h e   M a c r o   w i t h   a   T o o l b a r   B u t t o n 
 
 T a s k / L o c a t i o n 
 
 
 
 A c t i o n 
 
 R e s u l t 
 
 W o r d   d i a l o g   
 
 T o o l s   m e n u   
 
 1 . 
 
 S e l e c t   C u s t o m i z e .   
 
 T h e   C u s t o m i z e   d i a l o g   b o x   i s   d i s p l a y e d .     ( 1 ) 
 
 C u s t o m i z e   d i a l o g   b o x . 
 
 2 . 
 
 S e l e c t   t h e   T o o l b a r s   t a b   a n d   c l i c k   o n   M a c r o s     ( 2 ) . 
 
 
 
 
 
 3 . 
 
 L o c a t e   t h e   m a c r o   y o u   c r e a t e d   a n d   c l i c k   t h e   n a m e .     ( 3 ) 
 
 
 
 
 
 4 . 
 
 P l a c e   t h e   c u r s o r   ( a r r o w )   o n   t h e   m a c r o   n a m e ,   p r e s s   a n d   h o l d   M B 1   a n d   d r a g   t h e   c u r s o r   t o   t h e   t o o l b a r   i n   w h i c h   y o u   w a n t   t h e   D E C t a l k   m a c r o   p l a c e d . ( 4 ) 
 
 
 
 W o r d   t o o l b a r   y o u   s e l e c t . 
 
 5 . 
 
 A n   o u t l i n e d   b o x   a p p e a r s   w h e r e   W o r d   w i l l   p l a c e   t h e   n e w   b u t t o n .   ( 4 ) 
 
 T h e   C u s t o m   B u t t o n   b o x   i s   d i s p l a y e d .   ( 5 ) 
 
 C u s t o m   b u t t o n   d i a l o g   b o x   ( 5 ) 
 
 6 . 
 
 C l i c k   t h e   b u t t o n   y o u   w a n t   t o   a s s o c i a t e   w i t h   t h e   D E C t a l k   m a c r o .     ( 6 ) 
 
 T h e   b u t t o n   i s   o u t l i n e d . 
 
 
 
 7 . 
 
 C l i c k   A s s i g n .     ( 7 ) 
 
 T h e   n e w   b u t t o n   n o w   a p p e a r s   i n   t h e   g r a y   o u t l i n e d   b o x   i n   t h e   t o o l b a r . 
 
 S t e p   3   -   L a u n c h i n g   a n d   C o n f i g u r i n g   t h e   D E C t a l k   S o f t w a r e   T e x t - t o - S p e e c h   S e r v e r   
 
 A f t e r   y o u   a s s o c i a t e   t h e   D E C t a l k   m a c r o   w i t h   a   b u t t o n   ( s t e p   2 ) ,   y o u   m u s t   h a v e   t h e   T T S   ( t e x t - t o - s p e e c h )   s e r v e r   r u n n i n g   b e f o r e   D E C t a l k   c a n   s p e a k   s e l e c t e d   s e c t i o n s   o f   t e x t   f r o m   a n   a p p l i c a t i o n .   T h i s   s e c t i o n   o u t l i n e s   h o w   t o   s t a r t   t h e   T T S   s e r v e r   a n d   c o n f i g u r e   t h e   T T S   s e r v e r   f o r   s p e a k e r   s e l e c t i o n ,   U s e r   D i c t i o n a r y   s e l e c t i o n ,   a n d   s p e a k i n g   r a t e .   
 
 T h e   T T S   s e r v e r   i s   l a u n c h e d   b y   t h e   W o r d   m a c r o   a n d   i s   d i s p l a y e d   a s   a   s m a l l   w i n d o w .   Y o u   c a n   c o n t r o l   t h e   s p e a k i n g   v o i c e   a n d   s p e a k i n g   r a t e   f r o m   t h e   w i n d o w   p u l l - d o w n   m e n u . 
 
 A p p l i c a t i o n s   c a n   a c c e s s   t h e   T e x t - T o - S p e e c h   D D E   s e r v e r   u s i n g   t h e   s e r v i c e   n a m e   " T T S s e r v e r " .   T h e   s e r v i c e   t o p i c   n a m e s   a r e   " S p e a k " ,   " L o a d D i c t i o n a r y " ,   a n d   " U n l o a d D i c t i o n a r y " .   E a c h   o f   t h e s e   t o p i c s   r e q u i r e s   a   s t r i n g   t h a t   i s   e i t h e r   t e x t   t o   b e   s p o k e n   ( f o r   t o p i c   " S p e a k " )   o r   a   d i c t i o n a r y   f i l e   s t r i n g . 
 
 F i g u r e   2 - 1 2   L a u n c h i n g   a n d   C o n f i g u r i n g   t h e   D E C t a l k   S e r v e r 
 
 
 
 T a b l e   2 - 1 0   L a u n c h i n g   a n d   C o n f i g u r i n g   t h e   D E C t a l k   T T S   S e r v e r 
 
 T a s k / L o c a t i o n 
 
 
 
 A c t i o n 
 
 R e s u l t 
 
 M i c r o s o f t   W o r d   e d i t i n g   s e s s i o n 
 
 1 . 
 
 C l i c k   t h e   T T S   S e r v e r   i c o n   y o u   c r e a t e d   w h e n   y o u   a s s o c i a t e d   y o u r   W o r d   m a c r o   w i t h   a   t o o l b a r   b u t t o n .     ( S e e   T a b l e   2 - 9   A s s o c i a t i n g   t h e   M a c r o   w i t h   a   T o o l b a r   B u t t o n 
 
 
 
 T h e   T T S   S e r v e r   d i a l o g   i s   d i s p l a y e d .   ( 2 ) 
 
 T T S   S e r v e r   d i a l o g     ( 2 ) 
 
 2 . 
 
 P u l l   d o w n   t h e   W i n d o w   m e n u   ( 3 ) 
 
   a n d   s e l e c t   C o n f i g u r e . . .   ( 4 ) 
 
 T h e   C h a n g e   S e t t i n g s   d i a l o g   b o x   i s   d i s p l a y e d .   ( 5 ) 
 
 C h a n g e   S e t t i n g s   d i a l o g   b o x   ( 5 ) 
 
 3 . 
 
 C l i c k   t h e   d e s i r e d   s p e a k i n g   v o i c e   a n d   s p e a k i n g   r a t e .     ( 6 ) 
 
 
 
 
 
 4 . 
 
 C l i c k   o n   t h e   T e s t   b u t t o n   ( 7 )   t o   p r e v i e w   y o u r   s e l e c t i o n s . 
 
 
 
 
 
 5 . 
 
 A d j u s t   t h e   s e t t i n g s   u n t i l   y o u   p r o d u c e   t h e   d e s i r e d   r e s u l t . 
 
 
 
 
 
 6 . 
 
 C l i c k   o n   O K .     ( 8 ) 
 
 T h e   s e l e c t e d   s e t t i n g s   r e m a i n   i n   e f f e c t   a s   t h e   d e f a u l t   s e t t i n g s   u n t i l   t h e y   a r e   c h a n g e d .     
 
 N o t e :   i n - l i n e   c o m m a n d s   i n   s e l e c t e d   t e x t   p l a y e d   t h r o u g h   t h e   T T S   s e r v e r   w i l l   o v e r r i d e   t h e   d e f a u l t s . 
 
 S t e p   4   -   S p e a k i n g   T e x t   i n   a   M i c r o s o f t   W o r d   . d o c   F i l e   w i t h   t h e   D E C t a l k   T T S   S e r v e r 
 
 A f t e r   W o r d   l a u n c h e s   t h e   T T S   s e r v e r   m a c r o   a n d   y o u   c o n f i g u r e   i t   f o r   t h e   d e s i r e d   s p e a k i n g   v o i c e ,   s p e a k i n g   r a t e ,   a n d   w i t h   a   u s e r   d i c t i o n a r y   f i l e   ( s t e p   3 ) ,   y o u   c a n   h a v e   D E C t a l k   s p e a k   s e l e c t e d   s e c t i o n s   o f   t e x t   f r o m   a n   o p e n e d   f i l e .   
 
 F i g u r e   2 - 1 3   S p e a k i n g   T e x t   i n   a   M i c r o s o f t   W o r d   . d o c   F i l e   w i t h   t h e   D E C t a l k   S o f t w a r e   T T S   S e r v e r 
 
 
 
 T a b l e   2 - 1 1   S p e a k i n g   T e x t   i n   a   M i c r o s o f t   W o r d   . d o c   f i l e   w i t h   t h e   D E C t a l k   T T S   S e r v e r 
 
 T a s k / L o c a t i o n 
 
 
 
 A c t i o n 
 
 R e s u l t 
 
 M i c r o s o f t   W o r d   d i a l o g     w i t h   f i l e   o p e n e d     ( 1 )     a n d   t h e   T T S   S e r v e r   m a c r o   b u t t o n   v i s i b l e   ( 2 ) 
 
 1 . 
 
 S e l e c t   a   r a n g e   o f   t e x t   f o r   D E C t a l k   t o   s p e a k .   ( 3 ) 
 
 
 
 
 
 2 . 
 
 C l i c k   t h e   T T S   S e r v e r   b u t t o n   ( 2 ) 
 
 D E C t a l k   s p e a k s   t h e   s e l e c t e d   t e x t   a n d   d i s p l a y s   t h e   T T S   S e r v e r   d i a l o g .     ( 4 ) 
 
 T T S   S e r v e r   d i a l o g   ( 4 ) 
 
 3 . 
 
 C l i c k   t h e   P a u s e   o r   S t o p   b u t t o n   i f   y o u   w a n t   t o   p a u s e   o r   s t o p   D E C t a l k   a s   i t   i s   s p e a k i n g   t h e   t e x t .   
 
 N o t e :   W h e n   y o u   p a u s e   t h e   s e r v e r ,   a l l   q u e u e d   t e x t   r e m a i n s   q u e u e d   u p   e v e n   t h o u g h   y o u   d e s e l e c t   i t   i n   t h e   W o r d   d o c u m e n t .   W h e n   y o u   s t o p   t h e   s e r v e r ,   a l l   q u e u e d   t e x t   i s   f l u s h e d   f r o m   t h e   D E C t a l k   s y s t e m . 
 
 
 
 
 
 I f   t h e   s e r v e r   i s   n o t   a c c e s s i b l e ,   a n   e r r o r   i s   r e t u r n e d .  ( 5 ) 
 
 U s i n g   t h e   S a y   C o m m a n d - L i n e   A p p l e t   
 
 T h e   D E C t a l k   S a y   c o m m a n d - l i n e   a p p l e t   l e t s   y o u   r u n   D E C t a l k   f r o m   t h e   W i n d o w s   c o m m a n d   l i n e .   S a y   p r o v i d e s   m a n y   o f   t h e   s t a n d a r d   D E C t a l k   i n p u t   a n d   o u t p u t   o p t i o n s   a v a i l a b l e   i n   t h e   S p e a k   a n d   S a m p l e   a p p l e t s   a n d   t h e   D E C t a l k   A P I .   
 
 C o m m a n d   s y n t a x : 	 S A Y   [ o p t i o n s ]   [ t e x t ] 
 
 
 
 H e l p   O p t i o n s 
 
 - h   o r   - ? 
 
 O u t p u t   t h i s   f i l e   t o   t h e   c o n s o l e .   T h i s   o p t i o n   c a n c e l s   a n y   o t h e r s   o n   t h e   c o m m a n d   l i n e . 
 
 O u t p u t   O p t i o n s 
 
 - w   o u t F i l e 
 
 C o n v e r t   t e x t   t o   s p e c i f i e d   . W A V   f i l e   i n s t e a d   o f   s p e a k i n g   t o   t h e   s o u n d   d e v i c e . 
 
 - l [ t ]   o u t F i l e 
 
 T u r n   o n   t e x t   l o g g i n g ,   w h i c h   l o g s   a l l   i n p u t   t e x t   t o   a   f i l e .   T h i s   t e x t   i n c l u d e s   a n y   p r e -   a n d   p o s t -   c o m m a n d s   a s   w e l l   a s   c o m m a n d s   s e n t   t o   D E C t a l k   b y   t h e   S a y   p r o g r a m   i t s e l f .   
 
 B e c a u s e   t h i s   i s   t h e   d e f a u l t   l o g g i n g   m o d e ,   t h e   ' t '   i m m e d i a t e l y   f o l l o w i n g   t h e   ' - l '   i s   o p t i o n a l . 
 
 - l s   o u t F i l e 
 
 T u r n   o n   s y l l a b l e   l o g g i n g ,   w h i c h   l o g s   e a c h   s y l l a b l e   t o   a   f i l e . 
 
 - l p   o u t F i l e 
 
 T u r n   o n   p h o n e m e   l o g g i n g ,   w h i c h   c o n v e r t s   t h e   i n p u t   t e x t   t o   p h o n e m e s .   T h i s   i s   u s e f u l   i f   y o u   w a n t   t o   g e t   D E C t a l k   t o   s i n g .   Y o u   c o n v e r t   t h e   t e x t   t o   p h o n e m e s   a n d   t h e n   i n s e r t   t h e   t o n e   c o m m a n d s   i n t o   t h e   p h o n e m e   f i l e . 
 
 I f   n o   o u t p u t   o p t i o n s   a r e   s p e c i f i e d ,   S a y   s e n d s   i t s   o u t p u t   t o   t h e   i n s t a l l e d   s o u n d   d e v i c e ,   u s u a l l y   a   s o u n d   c a r d .   O n l y   o n e   o u t p u t   o p t i o n   c a n   b e   s p e c i f i e d ;   i f   y o u   s p e c i f y   m o r e   t h a n   o n e ,   t h e   l a s t   o n e   o n   t h e   c o m m a n d   l i n e   i s   u s e d 
 
 I n p u t   O p t i o n s 
 
 - p r e   p r e T e x t 
 
 T e x t   t o   b e   p a s s e d   t o   D E C t a l k   b e f o r e   t h e   n o r m a l   i n p u t .   T h e   p r e f i x   t e x t   i s   " f o r c e d "   o u t   b e f o r e   t h e   i n p u t   t e x t   i s   r e a d . 
 
 - p o s t   p o s t T e x t 
 
 T e x t   t o   b e   p a s s e d   t o   D E C t a l k   a f t e r   t h e   n o r m a l   i n p u t .   
 
 T h i s   i s   u s e f u l   f o r   p a s s i n g   t e r m i n a t i n g   c o m m a n d s   t o   D E C t a l k   t h a t   n o r m a l l y   a r e   n o t   p a r t   o f   t h e   i n p u t .   I f   t h e   p o s t f i x   t e x t   h a s   s p a c e s ,   i t   m u s t   b e   e n c l o s e d   i n   q u o t e s .   A n   e x a m p l e   i s   " [ : p h o n e m e   o f f ] "   o r   " T h e   E n d " . 
 
 T h e   " n o r m a l "   i n p u t   i s   " f o r c e d "   o u t   b e f o r e   t h e   p o s t f i x   t e x t   i s   r e a d . 
 
 t e x t 
 
 T e x t   a p p e a r i n g   o n   t h e   c o m m a n d   l i n e   i s   s p o k e n .   T h e   t e x t   t o   b e   s p o k e n   c a n   c o m e   e i t h e r   f r o m   t h e   s t a n d a r d   i n p u t   o r   f r o m   t h e   c o m m a n d   l i n e . 
 
 A n y t h i n g   o n   t h e   c o m m a n d   l i n e   t h a t   i s   n o t   a n   o p t i o n   i s   i n t e r p r e t e d   a s   t e x t ,   a s   w i l l   a n y t h i n g   f o l l o w i n g   i t   o n   t h e   c o m m a n d   l i n e .   I n   o t h e r   w o r d s ,   t e x t   t o   b e   s p o k e n   m u s t   a p p e a r   o n   t h e   c o m m a n d   l i n e   a f t e r   a l l   o p t i o n s . 
 
 I f   t h e   * f i r s t *   w o r d   i n   t h e   t e x t   h a s   a   d a s h   ( - )   o r   s l a s h   ( / )   a s   i t s   f i r s t   c h a r a c t e r ,   y o u   m u s t   p r e c e d e   i t   w i t h   a n o t h e r   d a s h   o r   s l a s h .   F o r   e x a m p l e ,   t o   t e l l   D E C t a l k   t o   s a y   t h e   n u m b e r   - 1 2 3 ,   y o u   w o u l d   t y p e   t h e   c o m m a n d 
 
 S A Y   - - 1 2 3 
 
 T h i s   i s   n e c e s s a r y   t o   a v o i d   h a v i n g   S A Y   i n t e r p r e t   t h e   n u m b e r   a s   a   c o m m a n d   l i n e   o p t i o n .   I f   y o u   e m b e d   D E C t a l k   c o m m a n d s   i n t o   y o u r   t e x t ,   y o u   m u s t   e n c l o s e   t h e m   i n   q u o t e s   i f   t h e y   c o n t a i n   s p a c e s . 
 
 T h i s   i s   b e c a u s e   S A Y   t r e a t s   e a c h   s p a c e - d e l i m i t e d   c o m m a n d - l i n e   a r g u m e n t   a s   a   s e p a r a t e   " w o r d " ,   w h i l e   D E C t a l k   c o m m a n d s   m u s t   b e   p r o c e s s e d   a s   s i n g l e   " w o r d s "   b y   t h e   S A Y   p r o g r a m . 
 
 I f   n o   t e x t   i s   s p e c i f i e d ,   S A Y   t a k e s   i t s   i n p u t   f r o m   t h e   s t a n d a r d   i n p u t .   F o r   e x a m p l e ,   y o u   c o u l d   h a v e   S A Y   s p e a k   a   d i r e c t o r y   l i s t i n g   i n   B e t t y ' s   v o i c e   b y   t y p i n g 
 
 D I R   |   S A Y   - p r e   " [ : n b ] " 
 
 o r   y o u   c o u l d   j u s t   t y p e   t h e   c o m m a n d   
 
 S A Y 
 
 a n d   t h e n   e n t e r   t e x t   a t   t h e   c o n s o l e .   I n   t h i s   c a s e ,   S A Y   s p e a k s   e a c h   l i n e   a f t e r   y o u   p r e s s   E n t e r ,   a n d   e x i t s   a f t e r   y o u   p r e s s   C t r l / x .   I f   y o u   w a n t   S A Y   t o   t a k e   i t s   i n p u t   f r o m   a   f i l e ,   u s e   f i l e   r e d i r e c t i o n   a s   i n   t h e   f o l l o w i n g   e x a m p l e ,   w h i c h   r e a d s   t h e   f i l e   f o o . t x t     i n   H a r r y ' s   v o i c e : 
 
 S A Y   - p r e   " [ : n h ] "   <   F O O . T X T 
 
 D i c t i o n a r y   O p t i o n s 
 
 - d   u s e r D i c t 
 
 L o a d s   t h e   s p e c i f i e d   U s e r   D i c t i o n a r y   b e f o r e   s p e a k i n g .   T h i s   d i c t i o n a r y   i s   l o a d e d   i n   p l a c e   o f   a n y   d e f a u l t   U s e r   D i c t i o n a r y   d e t e r m i n e d   b y   D E C t a l k . 
 
 
 
 
 
 
 
 C h a p t e r   3   - 
 
 I n t r o d u c t i o n   t o   t h e   D E C t a l k   S o f t w a r e   A P I 
 
 
 
 T h i s   c h a p t e r   i n t r o d u c e s   t h e   D E C t a l k   S o f t w a r e   D I G I T A L   S p e e c h   A P I   ( D A P I ) ,   a l s o   k n o w n   a s   t h e   D E C t a l k   S o f t w a r e   A P I   a n d   d e s c r i b e s   h o w   t o   w r i t e   a p p l i c a t i o n   p r o g r a m s   u s i n g   t h e   D E C t a l k   S o f t w a r e   A P I .   T h i s   A P I   i s   d e s i g n e d   t o   b e   e x t e n s i b l e   f o r   f u t u r e   t e x t - t o - s p e e c h   g r o w t h   w h i l e   s t i l l   b e i n g   e a s y   t o   u s e .   T h e   c u r r e n t   D E C t a l k   S o f t w a r e   i m p l e m e n t a t i o n   s u p p o r t s   m u l t i p l e   i n s t a n c e s   o f   D E C t a l k   S o f t w a r e   p e r   p r o c e s s o r . 
 
 T h e   A P I   c a l l s   g i v e   y o u   a   f l e x i b l e   m e t h o d   f o r   m a n i p u l a t i n g   t h e   v a r i o u s   p a r a m e t e r s   o f   D E C t a l k   S o f t w a r e   f u n c t i o n a l i t y   f r o m   w i t h i n   y o u r   a p p l i c a t i o n .   T h e s e   c a l l s   p e r f o r m   a   w i d e   r a n g e   o f   t a s k s   a s s o c i a t e d   w i t h   t h e   t e x t - t o - s p e e c h   s y s t e m   a n d   a r e   l i s t e d   b y   f u n c t i o n a l i t y   i n   T a b l e   3 - 1 . 
 
 N o t e 
 
 I n   a d d i t i o n   t o   t h e   D A P I ,   D E C t a l k   S o f t w a r e   s u p p o r t s   t h e   M i c r o s o f t   S p e e c h   A P I   ( S A P I ) .   D E C t a l k   S o f t w a r e   f o r   W i n d o w s   n o w   s u p p o r t s   m o s t   o f   S A P I .   T h i s   a l l o w s   D E C t a l k   S o f t w a r e   t o   w o r k   a s   a n   O L E   s e r v e r   i n   a n y   O L E   a p p l i c a t i o n   e n v i r o n m e n t .   T h e   i n f o r m a t i o n   a b o u t   S A P I   i s   a v a i l a b l e   i n   t h e   M i c r o s o f t   D e v e l o p e r   N e t w o r k   ( M S D N )   C D - R O M   L e v e l   I I ,   J a n u a r y   1 9 9 6   e d i t i o n   u n d e r   t h e   M i c r o s o f t   S o f t w a r e   D e v e l o p m e n t   K i t   ( S D K ) .   F o r   m o r e   i n f o r m a t i o n   o r   d o c u m e n t a t i o n   o n   S A P I ,   c o n t a c t   M i c r o s o f t . 
 
 
 
 T a b l e   3 - 1   T e x t - T o - S p e e c h   C a l l s   b y   C a t e g o r y 
 
 C a l l s 
 
 P u r p o s e 
 
 C o r e   A P I   
 
 
 
 T e x t T o S p e e c h S t a r t u p ( ) I D H _ T e x t T o S p e e c h S t a r t u p     
 
 I n i t i a l i z e s   a n d   s t a r t s   u p   t e x t - t o - s p e e c h   s y s t e m . 
 
 I n   W i n d o w s ,   t h e   u s e r   d e f i n e s   t h e   w i n d o w   h a n d l e   t o   w h i c h   p o s t   m e s s a g e s   c a n   b e   s e n t . 
 
 I n   D I G I T A L   U N I X ,   t h e   u s e r   d e f i n e s   t h e   c a l l b a c k   r o u t i n e . 
 
 T h e   c a l l i n g   a p p l i c a t i o n   c a n   t h e n   r e c e i v e   i n d e x   m a r k s ,   m e m o r y   b u f f e r s ,   o r   s t a t u s   i n f o r m a t i o n   t h r o u g h   t h e   a b o v e   o p e r a t i n g   s y s t e m   d e p e n d e n t   m e c h a n i s m . 
 
 T e x t T o S p e e c h S t a r t u p E x ( ) I D H _ T e x t T o S p e e c h S t a r t u p     
 
 I n i t i a l i z e s   a n d   s t a r t s   u p   t e x t - t o - s p e e c h   s y s t e m .   T h e   u s e r   d e f i n e s   t h e   c a l l b a c k   r o u t i n e   t h a t   c a n   b e   c a l l e d   w h e n   i n d e x   m a r k s ,   m e m o r y   b u f f e r s ,   o r   s t a t u s   i n f o r m a t i o n   n e e d s   t o   b e   s e n t   t o   t h e   c a l l i n g   a p p l i c a t i o n . 
 
 T e x t T o S p e e c h S p e a k ( ) I D H _ T e x t T o S p e e c h S p e a k     
 
 S p e a k s   t e x t   f r o m   a   b u f f e r . 
 
 T e x t T o S p e e c h S h u t d o w n ( ) I D H _ T e x t T o S p e e c h S h u t d o w n     
 
 S h u t s   d o w n   t e x t - t o - s p e e c h   s y s t e m . 
 
 A u d i o   O u t p u t   C o n t r o l   
 
 
 
 T e x t T o S p e e c h P a u s e ( ) 
 
 P a u s e s   o u t p u t . 
 
 T e x t T o S p e e c h R e s u m e ( ) 
 
 R e s u m e s   o u t p u t . 
 
 T e x t T o S p e e c h R e s e t ( ) 
 
 T e x t - t o - s p e e c h   s y s t e m   i s   p u r g e d   a n d   o u t p u t   s t o p p e d . 
 
 B l o c k i n g   S y n c h r o n i z a t i o n   
 
 
 
 T e x t T o S p e e c h S y n c ( ) I D H _ T e x t T o S p e e c h S y n c     
 
 S y n c h r o n i z e s   t o   t h e   t e x t   s t r e a m . 
 
 C o n t r o l   a n d   S t a t u s   
 
 
 
 T e x t T o S p e e c h S e t S p e a k e r ( ) I D H _ T e x t T o S p e e c h S e t S p e a k e r   
 
 S e l e c t s   o n e   o f   n i n e   s p e a k i n g   v o i c e s . 
 
 T e x t T o S p e e c h G e t S p e a k e r ( ) I D H _ T e x t T o S p e e c h G e t S p e a k e r     
 
 R e t u r n s   t h e   l a s t   s p e a k i n g   v o i c e   t o   h a v e   s p o k e n . 
 
 T e x t T o S p e e c h S e t R a t e ( ) I D H _ T e x t T o S p e e c h S e t R a t e     
 
 S e t s   t h e   s p e a k i n g   r a t e   o f   t h e   t e x t - t o - s p e e c h   s y s t e m .   
 
 T e x t T o S p e e c h G e t R a t e ( ) I D H _ T e x t T o S p e e c h G e t R a t e     
 
 R e t u r n s   t h e   s p e a k i n g   r a t e   o f   t h e   t e x t - t o - s p e e c h   s y s t e m . 
 
 T e x t T o S p e e c h S e t L a n g u a g e ( ) I D H _ T e x t T o S p e e c h S e t L a n g u a g e     
 
 S e t s   t h e   l a n g u a g e   t o   b e   u s e d .   
 
 T e x t T o S p e e c h G e t L a n g u a g e ( ) I D H _ T e x t T o S p e e c h G e t L a n g u a g e     
 
 R e t u r n s   t h e   l a n g u a g e   i n   u s e . 
 
 T e x t T o S p e e c h G e t S t a t u s ( ) I D H _ T e x t T o S p e e c h G e t S t a t u s     
 
 G e t s   s t a t u s   o f   t e x t - t o - s p e e c h   s y s t e m . 
 
 T e x t T o S p e e c h G e t C a p s ( ) I D H _ T e x t T o S p e e c h G e t C a p s     
 
 R e t r i e v e s   t h e   c a p a b i l i t i e s   o f   t h e   t e x t - t o - s p e e c h   s y s t e m . 
 
 S p e c i a l   T e x t - T o - S p e e c h   M o d e   
 
 
 
 T e x t T o S p e e c h O p e n W a v e O u t F i l e ( ) I D H _ T e x t T o S p e e c h O p e n W a v e O u t F i l e     
 
 O p e n s   a   f i l e   f o r   o u t p u t .   T e x t T o S p e e c h S p e a k ( )   w r i t e s   a u d i o   d a t a   i n   w a v e   f o r m a t   t o   t h i s   f i l e . 
 
 T e x t T o S p e e c h C l o s e W a v e O u t F i l e ( ) I D H _ T e x t T o S p e e c h C l o s e W a v e O u t F i l     
 
 C l o s e s   t h e   s p e c i f i e d   w a v e   f i l e   a n d   r e t u r n s   t h e   t e x t - t o - s p e e c h   s y s t e m   t o   i t s   s t a r t u p   s t a t e . 
 
 T e x t T o S p e e c h O p e n L o g F i l e ( ) I D H _ T e x t T o S p e e c h O p e n L o g   
 
 O p e n s   a   l o g   f i l e .   T e x t T o S p e e c h S p e a k ( )   w r i t e s   t e x t ,   p h o n e m e s ,   o r   s y l l a b l e s   t o   t h i s   f i l e . 
 
 T e x t T o S p e e c h C l o s e L o g F i l e ( ) I D H _ T e x t T o S p e e c h C l o s e L o g     
 
 C l o s e s   t h e   s p e c i f i e d   l o g   f i l e   a n d   r e t u r n s   t h e   t e x t - t o - s p e e c h   s y s t e m   t o   i t s   s t a r t u p   s t a t e . 
 
 T e x t T o S p e e c h O p e n I n M e m o r y ( ) I D H _ T e x t T o S p e e c h O p e n I n M e m o r y     
 
 P r o d u c e s   b u f f e r e d   s p e e c h   s a m p l e s   i n   w a v e   f o r m a t   w h e n e v e r   T e x t T o S p e e c h S p e a k ( )   f u n c t i o n   i s   c a l l e d .   C a l l i n g   a p p l i c a t i o n   i s   n o t i f i e d   w h e n   m e m o r y   b u f f e r   i s   f i l l e d . 
 
 T e x t T o S p e e c h C l o s e I n M e m o r y ( ) I D H _ T e x t T o S p e e c h C l o s e I n M e m o r y     
 
 R e t u r n s   t h e   t e x t - t o - s p e e c h   s y s t e m   t o   i t s   s t a r t u p   s t a t e . 
 
 T e x t T o S p e e c h A d d B u f f e r ( ) I D H _ T e x t T o S p e e c h A d d B u f f e r   
 
 A d d s   a   s h a r e d - m e m o r y   b u f f e r   a l l o c a t e d   b y   t h e   c a l l i n g   a p p l i c a t i o n   t o   t h e   m e m o r y   b u f f e r   l i s t . 
 
 T e x t T o S p e e c h R e t u r n B u f f e r ( ) I D H _ T e x t T o S p e e c h R e t u r n B u f f e r     
 
 R e t u r n s   t h e   c u r r e n t   s h a r e d - m e m o r y   b u f f e r . 
 
 L o a d i n g   a n d   U n l o a d i n g   a   U s e r   D i c t i o n a r y   
 
 
 
 T e x t T o S p e e c h L o a d U s e r D i c t i o n a r y ( ) I D H _ T e x t T o S p e e c h L o a d U s e r D i c t i o n     
 
 L o a d s   U s e r   D i c t i o n a r y . 
 
 T e x t T o S p e e c h U n l o a d U s e r D i c t i o n a r y ( ) I D H _ T e x t T o S p e e c h U n l o a d U s e r D i c t i   
 
 U n l o a d s   U s e r   D i c t i o n a r y . 
 
 
 
 T h e   C o r e   A P I   C a l l s 
 
 T h e   c o r e   D E C t a l k   S o f t w a r e   A P I   c a l l s   a r e :   
 
 T e x t T o S p e e c h S t a r t u p   a n d   T e x t T o S p e e c h S t a r t u p E x ,   k n o w n   a s   t h e   s t a r t u p   f u n c t i o n s ,   a l l o c a t e   s y s t e m   r e s o u r c e s . 
 
 T e x t T o S p e e c h S t a r t u p ,   w h i c h   i s   o p e r a t i n g   s y s t e m   d e p e n d e n t ,   h a s   d i f f e r e n t   c a l l i n g   p a r a m e t e r s .   O n   U N I X ,   a   c a l l b a c k   r o u t i n e   m a y   b e   d e f i n e d ;   o n   W i n d o w s ,   a   w i n d o w   h a n d l e   c a n   b e   p a s s e d   t o   t h e   T e x t T o S p e e c h S t a r t u p   c a l l . 
 
 T e x t T o S p e e c h S t a r t u p E x   w o r k s   t h e   s a m e   o n   b o t h   t h e   U N I X   a n d   W i n d o w s   p l a t f o r m s   a n d   a l l o w s   a   c a l l b a c k   r o u t i n e   t o   b e   p a s s e d . 
 
 T e x t T o S p e e c h S p e a k   q u e u e s   t e x t   t o   t h e   s y s t e m . 
 
 T e x t T o S p e e c h S h u t d o w n   r e t u r n s   a l l   s y s t e m   r e s o u r c e s   a l l o c a t e d   b y   t h e   s t a r t u p   f u n c t i o n s . 
 
 T h e   s i m p l e s t   a p p l i c a t i o n   m i g h t   o n l y   u s e   t h e s e   f u n c t i o n s . 
 
 T e x t T o S p e e c h S p e a k   
 
 T h e   T e x t T o S p e e c h S p e a k   c a l l   i s   u s e d   t o   p a s s   a   n u l l   t e r m i n a t e d   s t r i n g   o f   c h a r a c t e r s   t o   t h e   t e x t - t o - s p e e c h   s y s t e m .   T h e   s y s t e m   q u e u e s   a l l   c h a r a c t e r s   u p   t o   t h e   n u l l   c h a r a c t e r .   I f   t h e   T T S _ F O R C E   f l a g   i s   n o t   u s e d   i n   t h e   c a l l   t o   t h i s   f u n c t i o n ,   t h e n   t h e   q u e u e d   c h a r a c t e r s   a r e   s e a m l e s s l y   c o n c a t e n a t e d   w i t h   p r e v i o u s l y   q u e u e d   c h a r a c t e r s .   T h e   T T S _ F O R C E   f l a g   i s   u s e d   t o   f o r c e   a   s t r i n g   o f   c h a r a c t e r s   t o   b e   s p o k e n   e v e n   t h o u g h   t h e   s t r i n g   m i g h t   n o t   c o m p l e t e   a   c l a u s e .   F o r   e x a m p l e :   
 
 T e x t T o S p e e c h S p e a k (   p h T T S ,   " T h i s   w i l l   b e   s p o k e n .   " ,   T T S _ N O R M A L ) ;   
 
 T h i s   t e x t   i s   s p o k e n   i m m e d i a t e l y   b y   t h e   s y s t e m   b e c a u s e   i t   i s   t e r m i n a t e d   b y   a   p e r i o d   a n d   a   s p a c e .   T h e s e   l a s t   t w o   c h a r a c t e r s   a r e   o n e   w a y   t o   c r e a t e   a   c l a u s e   b o u n d a r y .   
 
 T e x t T o S p e e c h S p e a k (   p h T T S ,   " T h i s   w i l l   b e   s p o k " ,   T T S _ N O R M A L   ) ; 
 
 T h i s   p r o d u c e s   o u t p u t   o n l y   a f t e r   t h e   f o l l o w i n g   l i n e   o f   c o d e   e x e c u t e s   t o   c o m p l e t e   t h e   p h r a s e .   
 
 T e x t T o S p e e c h S p e a k (   p h T T S ,   " e n .   " ,   T T S _ N O R M A L   ) ; 
 
 F i n a l l y ,   a   n o n p h r a s e   s t r i n g   c a n   b e   f o r c e d   t o   b e   s p o k e n   b y   u s i n g   t h e   T T S _ F O R C E   f l a g .   
 
 T e x t T o S p e e c h S p e a k (   p h T T S ,   " T h i s   w i l l   b e   s p o k " ,   T T S _ F O R C E   ) ; 
 
 N o t e   t h a t   t h e   w o r d   s p o k e n   i s   n o t   p r o n o u n c e d   c o r r e c t l y   i n   t h i s   c a s e   e v e n   i f   t h e   f i n a l   c h a r a c t e r s ,   e n   a r e   q u e u e d   i m m e d i a t e l y   a f t e r w a r d .   
 
 T h e   T T S _ F O R C E   f l a g   c a u s e s   t h e   p r e v i o u s   l i n e   t o   b e   s p o k e n   b e f o r e   t a k i n g   a n y   s u b s e q u e n t l y   q u e u e d   c h a r a c t e r s   i n t o   a c c o u n t .   
 
 I m p o r t a n t   T e x t - Q u e u i n g   I n f o r m a t i o n 
 
 I t   i s   i m p o r t a n t   t h a t   a l l   s e n t e n c e s   a r e   s e p a r a t e d   w i t h   a   s p a c e ,   n e w   l i n e ,   o r   l i n e   f e e d   c h a r a c t e r .   T o   m a k e   s u r e   o f   t h i s ,   i t   i s   r e c o m m e n d e d   t h a t   a   s p a c e   c h a r a c t e r   i s   r o u t i n e l y   i n c l u d e d   a f t e r   t h e   f i n a l   p u n c t u a t i o n   i n   a   s e n t e n c e .   A n   e x a m p l e   o f   w h a t   h a p p e n s   w i t h o u t   t h i s   i s   s h o w n   b e l o w : 
 
 T e x t T o S p e e c h S p e a k (   p h T T S ,   " T h e y   a r e   t i r e d . " ,   T T S _ N O R M A L   ) ; 
 
 T e x t T o S p e e c h S p e a k (   p h T T S ,   " I   a m   C o l d . " ,   T T S _ N O R M A L   ) ; 
 
 B e c a u s e   t h e r e   i s   n o   s p a c e ,   t h e   t e x t - t o - s p e e c h   s y s t e m   p r o c e s s e s   t h e   f o l l o w i n g   s t r i n g : 
 
 " T h e y   a r e   t i r e d . I   a m   C o l d . " 
 
   T h e   s t r i n g ,   t i r e d . I ,   w i l l   b e   p r o n o u n c e d   i n c o r r e c t l y   b e c a u s e   t h e   s y s t e m   t r e a t s   i t   a s   o n e   i t e m   i n s t e a d   o f   t w o   w o r d s . 
 
 C l a u s e - B a s e d   S y n t h e s i s 
 
 D E C t a l k   S o f t w a r e   p r o c e s s e s   a l l   t e x t   o n   a   c l a u s e   b a s i s .   A   c l a u s e   i s   d e f i n e d   a s   a   g r o u p   o f   w o r d s   t e r m i n a t e d   b y   a   p e r i o d ,   q u e s t i o n   m a r k ,   e x c l a m a t i o n   p o i n t ,   q u e s t i o n   m a r k ,   s e m i c o l o n ,   o r   a   c o l o n   a n d   f o l l o w e d   b y   w h i t e   s p a c e .   I f   y o u   s e n d   D E C t a l k   S o f t w a r e   a   s t r i n g   o f   t e x t   w i t h   N O   t e r m i n a t o r ,   i t   g o e s   i n t o   a n   i n f i n i t e   l o o p   w a i t i n g   f o r   a   c l a u s e   t e r m i n a t o r .   T h e   S y n c   i n - l i n e   c o m m a n d   c a n   b e   u s e d   t o   c o m p l e t e   a   c l a u s e   w i t h o u t   u s i n g   a   t e r m i n a t o r . 
 
 C a l l b a c k   R o u t i n e s   a n d   W i n d o w   P r o c e d u r e s 
 
 A f t e r   T e x t T o S p e e c h S p e a k     i s   c a l l e d ,   t h e   t e x t - t o - s p e e c h   s y s t e m   c a n   n o t i f y   t h e   c a l l i n g   a p p l i c a t i o n   i n   o n e   o f   t w o   w a y s .   O n   D I G I T A L   U N I X ,   t h e   i n f o r m a t i o n   c a n   b e   s e n t   b a c k   t h r o u g h   t h e   c a l l b a c k   r o u t i n e   d e f i n e d   i n   t h e   s t a r t u p   f u n c t i o n .   O n   W i n d o w s ,   t h e   i n f o r m a t i o n   i s   p a s s e d   b a c k   t h r o u g h   w i n d o w   m e s s a g e s   o r   c a l l b a c k   r o u t i n e s ,   d e p e n d i n g   o n   w h i c h   s t a r t u p   f u n c t i o n   w a s   c a l l e d .   S e e   t h e   D E C t a l k   S o f t w a r e   R e f e r e n c e   G u i d e   f o r   m o r e   i n f o r m a t i o n   o n   s t a r t u p   f u n c t i o n s .   
 
 C a l l b a c k   r o u t i n e s   s h o u l d   n o t   c a l l   T e x t T o S p e e c h & ( )   c a l l s .     I f   c a l l b a c k   r o u t i n e s   c a l l   T e x t T o S p e e c h & ( )   c a l l s ,   a n   a p p l i c a t i o n   c r a s h   m a y   o c c u r   i n   t h e   a p p l i c a t i o n   c a l l i n g   D E C t a l k   S o f t w a r e . 
 
 B o t h   t h e   w i n d o w   p r o c e d u r e s   a n d   t h e   c a l l b a c k   r o u t i n e s   h a v e   a   m e s s a g e   t y p e   a n d   t h e   W P A R A M   a n d   t h e   L P A R M   p a r a m e t e r s .   T h e r e   a r e   t h r e e   m e s s a g e   t y p e s   d e f i n e d :   o n e   f o r   e r r o r   a n d   s t a t u s   m e s s a g e s ,   o n e   f o r   i n d e x   m a r k s ,   a n d   o n e   t o   r e t u r n   m e m o r y   b u f f e r s   w h e n   u s i n g   t h e   T e x t T o S p e e c h O p e n I n M e m o r y   c a l l .   B a s e d   o n   t h e   m e s s a g e   t y p e ,   t h e   W P A R A M   a n d   t h e   L P A R A M   p a r a m e t e r s   c o n t a i n   s p e c i f i c   i n f o r m a t i o n . 
 
 E r r o r   M e s s a g e s 
 
 T h e   m e s s a g e   t y p e   f o r   e r r o r   a n d   s t a t u s   m e s s a g e s   i s   d e f i n e d   a s 
 
 F o r   C a l l b a c k   R o u t i n e : 
 
       u i I D _ E r r o r _ M e s s a g e     =   T T S _ M S G _ S T A T U S ; 
 
 
 
 F o r   W i n d o w   M e s s a g e s : 
 
       u i I D _ E r r o r _ M e s s a g e   =   
 
 	 R e g i s t e r W i n d o w M e s s a g e ( " D E C t a l k E r r o r M e s s a g e " ) ;   
 
 
 
 O n e   o f   t h e   e r r o r   c o d e s   l i s t e d   b e l o w ,   d e f i n e d   i n   t t s a p i . h ,   i s   c o n t a i n e d   i n   t h e   W P A R A M   p a r a m e t e r .   T h e   L P A R A M   p a r a m e t e r   c o n t a i n s   a   v a l u e   o f   t y p e   M M R E S U L T .   T h e   v a l u e s   c a n   b e   f o u n d   i n   t h e   t t s a p i . h   f i l e . 
 
 P a r a m e t e r 
 
 # d e f i n e   E R R O R _ I N _ A U D I O _ W R I T E 
 
 # d e f i n e   E R R O R _ O P E N I N G _ W A V E _ O U T P U T _ F I L E 
 
 # d e f i n e   E R R O R _ G E T T I N G _ D E V I C E _ C A P A B I L I T I E S 
 
 # d e f i n e   E R R O R _ R E A D I N G _ D I C T I O N A R Y 
 
 # d e f i n e   E R R O R _ W R I T I N G _ F I L E 
 
 # d e f i n e   E R R O R _ A L L O C A T I N G _ I N D E X _ M A R K _ M E M O R Y 
 
 # d e f i n e   E R R O R _ O P E N I N G _ W A V E _ F I L E 
 
 # d e f i n e   E R R O R _ B A D _ W A V E _ F I L E _ F O R M A T 
 
 # d e f i n e   E R R O R _ U N S U P P O R T E D _ W A V E _ F I L E _ F O R M A T 
 
 # d e f i n e   E R R O R _ U N S U P P O R T E D _ W A V E _ A U D I O _ F O R M A T 
 
 # d e f i n e   E R R O R _ R E A D I N G _ W A V E _ F I L E 
 
 # d e f i n e   T T S _ A U D I O _ S T A R T 
 
 # d e f i n e   T T S _ A U D I O _ S T O P 
 
 
 
 I n d e x   M a r k   M e s s a g e s 
 
 T h e   m e s s a g e   t y p e   f o r   i n d e x   m a r k s   i s   d e f i n e d   a s 
 
 F o r   C a l l b a c k   R o u t i n e : 
 
       u i I D _ I n d e x _ M e s s a g e     =   T T S _ M S G _ I N D E X _ M A R K ; 
 
 
 
 F o r   W i n d o w   M e s s a g e s : 
 
       u i I D _ I n d e x _ M e s s a g e   =   
 
 	 R e g i s t e r W i n d o w M e s s a g e ( " D E C t a l k I n d e x M e s s a g e " ) ;   
 
 
 
 T h e   L P A R A M   p a r a m e t e r   c o n t a i n s   t h e   i n d e x   m a r k   v a l u e .   N o t e   t h a t   t h e   i n d e x   m a r k   i n f o r m a t i o n   c a n   a l s o   b e   r e t u r n e d   i n   t h e   B u f f e r   M e s s a g e .   T h i s   h a p p e n s   w h e n   t h e   t e x t - t o - s p e e c h   s y s t e m   i s   i n   t h e   s p e e c h - t o - m e m o r y   m o d e ,   d u e   t o   t h e   T e x t T o S p e e c h O p e n I n M e m o r y   c a l l .   S e e   t h e   S p e c i a l   T e x t - T o - S p e e c h   M o d e s   s e c t i o n   f o r   m o r e   i n f o r m a t i o n . 
 
 B u f f e r   M e s s a g e s 
 
 T h e   m e s s a g e   t y p e   f o r   b u f f e r e d   s p e e c h   s a m p l e s   i s   d e f i n e d   a s : 
 
 F o r   C a l l b a c k   R o u t i n e s : 
 
       u i I D _ B u f f e r _ M e s s a g e     =   T T S _ M S G _ B U F F E R ; 
 
 F o r   W i n d o w   M e s s a g e s : 
 
       u i I D _ B u f f e r _ M e s s a g e   =   
 
 	 R e g i s t e r W i n d o w M e s s a g e ( " D E C t a l k B u f f e r M e s s a g e " ) ; 
 
 A   p o i n t e r   t o   t h e   r e t u r n e d   m e m o r y   b u f f e r   i s   c o n t a i n e d   i n   t h e   L P A R A M   p a r a m e t e r .   A d d i t i o n a l   i n f o r m a t i o n   a b o u t   i n d e x   m a r k s   a n d   p h o n e m e s   m a y   a l s o   b e   r e t u r n e d   h e r e .   S e e   t h e   R e t u r n   o f   M e m o r y   B u f f e r   s e c t i o n   f o r   a d d i t i o n a l   d e t a i l s   o n   w h a t   i n f o r m a t i o n   g e t s   r e t u r n e d .   
 
 C a l l b a c k   R o u t i n e   E x a m p l e 
 
 V O I D   m a i n ( ) 
 
 { 
 
 	 L P T T S _ H A N D L E _ T A G     p h T T S ; 
 
 	 T e x t T o S p e e c h S t a r t u p E x ( & p h T T S ,   W A V E _ M A P P E R , R E P O R T _ O P E N _ E R R O R ,   C a l l b a c k ,   0 ) ; 
 
 } 
 
 V O I D   C a l l b a c k ( L O N G   l P a r a m 1 ,   L O N G   l P a r a m 2 ,   D W O R D   d w C a l l b a c k P a r a m e t e r ,   U I N T   u i M s g ) 
 
 { 
 
 	 i f   ( u i M s g   = =   T T S _ M S G _ S T A T U S ) 
 
 	 { 
 
 	 	 / /   l P a r a m 1   c o n t a i n s   e r r o r   c o d e 
 
 	 	 / /   l P a r a m 2   c o n t a i n s   v a l u e   o f   M M R E S U L T 
 
 	 } 
 
 	 e l s e   i f   ( u i M s g   = =   T T S _ M S G _ I N D E X _ M A R K ) 
 
 	 { 
 
 	 	 / /   l P a r a m 2   c o n t a i n s   i n d e x   m a r k 
 
 	 } 
 
 	 e l s e   i f   ( u i M s g   = =   T T S _ M S G _ B U F F E R ) 
 
 	 { 
 
 	 	 / /   l P a r a m 2   c o n t a i n s   P o i n t e r   t o   b u f f e r 
 
 	 } 
 
 }   
 
 
 
 W i n d o w   P r o c e d u r e   E x a m p l e   
 
 s t a t i c   U I N T   u i I D _ E r r o r _ M e s s a g e   =   0 ; 
 
 s t a t i c   U N I T   u i I D _ B u f f e r _ M e s s a g e   =   0 ; 
 
 s t a t i c   U N I T   u i I D _ I n d e x _ M e s s a g e   =   0 ; 
 
 
 
 / /   W i n d o w   P r o c e d u r e 
 
 V O I D   M y W n d P r o c ( L O N G   l P a r a m 1 ,   L O N G   l P a r a m 2 ,   D W O R D   d w C a l l b a c k P a r a m e t e r ,   U I N T   u i M s g ) 
 
 { 
 
 	 i f   ( u i M s g   = =   u i I D _ E r r o r _ M e s s a g e ) 
 
 	 { 
 
 	 	 / /   l P a r a m 1   c o n t a i n s   e r r o r   c o d e 
 
 	 	 / /   l P a r a m 2   c o n t a i n s   v a l u e   o f   M M R E S U L T 
 
 	 } 
 
 	 e l s e   i f   ( u i M s g   = =   u i I D _ I n d e x _ M e s s a g e ) 
 
 	 { 
 
 	 	 / /   l P a r a m 2   c o n t a i n s   i n d e x   m a r k 
 
 	 } 
 
 	 e l s e   i f   ( u i M s g   = =   u i I D _ B u f f e r _ M e s s a g e ) 
 
 	 { 
 
 	 	 / /   l P a r a m 2   c o n t a i n s   P o i n t e r   t o   b u f f e r 
 
 	 } 
 
 }   
 
 
 
 V O I D   m a i n ( ) 
 
 { 
 
 	 L P T T S _ H A N D L E _ T A G     p h T T S ; 
 
 	 T e x t T o S p e e c h S t a r t u p E x ( & p h T T S ,   W A V E _ M A P P E R ,   R E P O R T _ O P E N _ E R R O R ,   M y W n d P r o c ,   0 ) ; 
 
 
 
 	 / /   R e g i s t e r i n g   m e s s a g e s   t o   r e p o r t   D E C t a l k   a s y n c h r o n o u s   e v e n t s 
 
 	 u i I D _ E r r o r _ M e s s a g e   =   R e g i s t e r W i n d o w M e s s a g e ( " D E C t a l k E r r o r M e s s a g e " ) ; 
 
 	 
 
 	 / /   C a l l b a c k   m e s s a g e   i s   r e g i s t e r e d   i n d i c a t i n g   i n d e x   m a r k s 
 
 	 u i I D _ I n d e x _ M e s s a g e   =   R e g i s t e r W i n d o w M e s s a g e ( " D E C t a l k I n d e x M e s s a g e " ) ; 
 
 	 
 
 	 / /   C a l l b a c k   m e s s a g e   i s   r e g i s t e r e d   i n d i c a t i n g   D E C t a l k   h a s   f i l l e d   u p   a n   a u d i o   b u f f e r 
 
 	 u i I D _ B u f f e r _ M e s s a g e   =   R e g i s t e r W i n d o w M e s s a g e ( " D E C t a l k B u f f e r M e s s a g e " ) ; 
 
 } 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 A u d i o   O u t p u t   C o n t r o l   C a l l s 
 
 T h e   a u d i o   o u t p u t   c o n t r o l   c a l l s   p a u s e   t h e   a u d i o   o u t p u t ,   r e s u m e   o u t p u t   a f t e r   p a u s i n g ,   a n d   r e s e t   t h e   t e x t - t o - s p e e c h   s y s t e m .   A n   a p p l i c a t i o n   c a n   c o n t r o l   s p e e c h   o u t p u t   u s i n g   T e x t T o S p e e c h P a u s e ,   T e x t T o S p e e c h R e s u m e ,   a n d   t h e   T e x t T o S p e e c h R e s e t .   A   r e s e t   d i s c a r d s   a l l   q u e u e d   t e x t   a n d   s t o p s   a n d   d i s c a r d s   a l l   q u e u e d   a u d i o .   I f   t h e   a p p l i c a t i o n   h a s   c a l l e d   t h e   T e x t T o S p e e c h O p e n I n M e m o r y   c a l l   t o   s t o r e   s p e e c h   s a m p l e s   i n   m e m o r y ,   a   r e s e t   c a u s e s   a l l   b u f f e r s   t o   b e   r e t u r n e d   t o   t h e   a p p l i c a t i o n . 
 
 B l o c k i n g   S y n c h r o n i z a t i o n   C a l l 
 
 T h e   T e x t T o S p e e c h S y n c   c a l l   i s   p r o v i d e d   t o   b l o c k   u n t i l   a l l   t e x t   p r e v i o u s l y   q u e u e d   b y   t h e   T e x t T o S p e e c h S p e a k   c a l l   i s   s p o k e n .   A f t e r   t h e   b l o c k i n g   s y n c h r o n i z a t i o n   f u n c t i o n   i s   c a l l e d ,   t h e r e   i s   n o   w a y   t o   a b o r t   u n t i l   a l l   t e x t   i s   p r o c e s s e d .   T h i s   c o u l d   t a k e   h o u r s   i f   t h e r e   i s   a   g r e a t   d e a l   o f   t e x t   q u e u e d .   N o n - b l o c k i n g   s y n c h r o n i z a t i o n   c a n   b e   p r o v i d e d   u s i n g   t h e   I n d e x   M a r k   i n - l i n e   c o m m a n d . 
 
 C o n t r o l   a n d   S t a t u s   C a l l s 
 
 T h e   c o n t r o l   a n d   s t a t u s   c a l l s   d e s c r i b e d   i n   T a b l e   3 - 2   p r o v i d e   a d d i t i o n a l   i n f o r m a t i o n   f o r   t h e   t e x t - t o - s p e e c h   s y s t e m . 
 
 T a b l e   3 - 2   A P I   C o n t r o l   a n d   S t a t u s   C a l l s 
 
 C a l l 
 
 D e s c r i p t i o n 
 
 T e x t T o S p e e c h S e t S p e a k e r ( )   
 
 S e t s   t h e   s p e a k e r ' s   v o i c e   w h i c h   b e c o m e s   a c t i v e   a t   t h e   n e x t   c l a u s e   b o u n d a r y .   
 
 T e x t T o S p e e c h G e t S p e a k e r ( )   
 
 R e t u r n s   t h e   v a l u e   o f   t h e   l a s t   s p e a k e r   t o   h a v e   s p o k e n . 
 
 T e x t T o S p e e c h S e t R a t e ( )   
 
 S e t s   t h e   s p e a k i n g   r a t e ,   w h i c h   b e c o m e s   a c t i v e   a t   t h e   n e x t   c l a u s e   b o u n d a r y .   
 
 T e x t T o S p e e c h G e t R a t e ( )   
 
 G e t s   t h e   s p e a k i n g   r a t e . 
 
 T e x t T o S p e e c h S e t L a n g u a g e ( )   
 
 S e t s   t h e   t e x t - t o - s p e e c h   s y s t e m   l a n g u a g e .   R e f e r   t o   t h e   t t s a p i . h   f i l e   f o r   a   l i s t   o f   v a l i d   l a n g u a g e s ,   e . g .   T T S _ A M E R I C A N _ E N G L I S H . 
 
 T e x t T o S p e e c h G e t L a n g u a g e ( )   
 
 R e t u r n s   t h e   c u r r e n t   t e x t - t o - s p e e c h   s y s t e m   l a n g u a g e . 
 
 T e x t T o S p e e c h G e t S t a t u s ( )   
 
 R e t u r n s   v a r i o u s   t e x t - t o - s p e e c h   s y s t e m   p a r a m e t e r s ,   s u c h   a s   t h e   n u m b e r   o f   c h a r a c t e r s   i n   t h e   t e x t   p i p e ,   t h e   I D   o f   t h e   w a v e   o u t p u t   d e v i c e ,   a n d   a   B o o l e a n   v a l u e   t h a t   i n d i c a t e s   w h e t h e r   t h e   t e x t - t o - s p e e c h   s y s t e m   i s   c u r r e n t l y   s p e a k i n g   o r   s i l e n t . 
 
 T e x t T o S p e e c h G e t C a p s ( )   
 
 R e t u r n s   t h e   c a p a b i l i t i e s   o f   t h e   t e x t - t o - s p e e c h   s y s t e m ,   w h i c h   i n c l u d e s   t h e   v e r s i o n   n u m b e r   o f   t h e   s y s t e m ,   t h e   n u m b e r   o f   s p e a k e r s ,   t h e   m a x i m u m   a n d   m i n i m u m   s p e a k i n g   r a t e ,   a n d   t h e   s u p p o r t e d   l a n g u a g e s .   
 
 S p e c i a l   T e x t - T o - S p e e c h   M o d e s 
 
 A f t e r   t h e   s t a r t u p   f u n c t i o n   i s   c a l l e d   b y   a n   a p p l i c a t i o n ,   i t   t h e n   c a n   c a l l   T e x t T o S p e e c h S p e a k   t o   s p e a k   t e x t .   T h i s   c o n v e r t s   t e x t   t o   s p e e c h   a n d   s e n d s   t h e   s p e e c h   s a m p l e   t o   a n   a u d i o   d e v i c e   d e p e n d i n g   o n   t h e   s e t t i n g   o f   t h e   d w F l a g s   f i e l d   i n   t h e   s t a r t u p   r o u t i n e .   
 
 T h e   D E C t a l k   S o f t w a r e   A P I   a l s o   p r o v i d e s   a l t e r n a t i v e s   f o r   t h e   s p e e c h   s a m p l e s   b y   a l l o w i n g   t h e   u s e r   t o   s e l e c t   o n e   o f   t h e   s p e c i a l   t e x t - t o - s p e e c h   m o d e s .   T h e   s p e c i a l   t e x t - t o - s p e e c h   m o d e   c a l l s   a l l o w   t h e   s p e e c h   s a m p l e s   t o   b e   w r i t t e n   t o   a   W a v e   f i l e ;   c o n v e r t e d   t o   t e x t ,   p h o n e m e s ,   o r   s y l l a b l e s   a n d   s t o r e d   i n   a   l o g   f i l e ;   o r   s a v e d   i n   m e m o r y   b u f f e r s   t o   b e   p a s s e d   b a c k   t o   t h e   c a l l i n g   a p p l i c a t i o n .   E a c h   m o d e - s w i t c h   c a l l   h a s   a   c o r r e s p o n d i n g   c a l l   t o   r e t u r n   t h e   t e x t - t o - s p e e c h   s y s t e m   t o   t h e   s t a r t u p   s t a t e .   T h e s e   c a l l s   a r e   l i s t e d   b e l o w . 
 
 T a b l e   3 - 3   S p e c i a l   T e x t - T o - S p e e c h   M o d e s 
 
 O p e n   F u n c t i o n 
 
   M o d e 
 
   C l o s e   F u n c t i o n 
 
 T e x t T o S p e e c h O p e n W a v e O u t F i l e ( ) 
 
 w a v e - f i l e 
 
 T e x t T o S p e e c h C l o s e W a v e O u t F i l e ( ) 
 
 T e x t T o S p e e c h O p e n L o g F i l e ( ) 
 
 l o g - f i l e 
 
 T e x t T o S p e e c h C l o s e L o g F i l e ( ) 
 
 T e x t T o S p e e c h O p e n I n M e m o r y ( ) 
 
 s p e e c h - t o - m e m o r y 
 
 T e x t T o S p e e c h C l o s e I n M e m o r y ( ) 
 
 T h e   t e x t - t o - s p e e c h   s y s t e m   m u s t   b e   i n   t h e   s t a r t u p   s t a t e   b e f o r e   c a l l i n g   a n y   o f   t h e   O p e n   f u n c t i o n s   l i s t e d   i n   T a b l e   3 - 3 .   T h e   c o r r e s p o n d i n g   C l o s e   c a l l s   r e t u r n   t h e   s y s t e m   t o   t h e   s t a r t u p   s t a t e . 
 
 W a v e - F i l e   M o d e 
 
 A f t e r   c a l l i n g   t h e   s t a r t u p   f u n c t i o n ,   a n   a p p l i c a t i o n   c a n   c a l l   T e x t T o S p e e c h O p e n W a v e O u t F i l e .   T h i s   c a l l   b l o c k s   u n t i l   a l l   p r e v i o u s l y   q u e u e d   t e x t   i s   p r o c e s s e d .   A f t e r   t h e   c a l l   r e t u r n s ,   a l l   t e x t   s u b s e q u e n t l y   q u e u e d   b y   t h e   T e x t T o S p e e c h S p e a k   c a l l   i s   c o n v e r t e d   t o   s p e e c h   s a m p l e s   a n d   w r i t t e n   i n t o   a   w a v e   f i l e .   T h e   T e x t T o S p e e c h C l o s e W a v e O u t F i l e   c a l l   b l o c k s   u n t i l   t h e   s p e e c h   f r o m   a l l   p r e v i o u s l y   q u e u e d   t e x t   i s   w r i t t e n   t o   t h e   f i l e . 
 
 L o g - F i l e   M o d e 
 
 A f t e r   c a l l i n g   t h e   s t a r t u p   f u n c t i o n ,   a n   a p p l i c a t i o n   c a n   c a l l   t h e   T e x t T o S p e e c h O p e n L o g F i l e .   T h i s   c a l l   b l o c k s   u n t i l   a l l   p r e v i o u s l y   q u e u e d   t e x t   i s   p r o c e s s e d .   A f t e r   t h e   c a l l   r e t u r n s ,   a l l   t e x t   s u b s e q u e n t l y   q u e u e d   b y   t h e   s t a r t u p   f u n c t i o n   i s   w r i t t e n   t o   a   l o g   f i l e   a s   t e x t ,   p h o n e m e s ,   o r   s y l l a b l e s .   T h e   p h o n e m e s   a n d   s y l l a b l e s   a r e   w r i t t e n   u s i n g   t h e   a r p a b e t   p h o n e m e   a l p h a b e t .   T h e   T e x t T o S p e e c h C l o s e L o g F i l e   c a l l   t e r m i n a t e s   p h o n e m e   l o g g i n g   a n d   b l o c k s   u n t i l   t h e   s p e e c h   f r o m   a l l   p r e v i o u s l y   q u e u e d   t e x t   i s   p r o c e s s e d . 
 
 S p e e c h - T o - M e m o r y   M o d e 
 
 A f t e r   c a l l i n g   t h e   s t a r t u p   f u n c t i o n ,   a n   a p p l i c a t i o n   c a n   c a l l   T e x t T o S p e e c h O p e n I n M e m o r y .   T h i s   c a l l   b l o c k s   u n t i l   a l l   p r e v i o u s l y   q u e u e d   t e x t   i s   p r o c e s s e d .   A f t e r   t h e   c a l l   r e t u r n s ,   a l l   t e x t   s u b s e q u e n t l y   q u e u e d   b y   t h e   T e x t T o S p e e c h S p e a k   c a l l   i s   c o n v e r t e d   t o   s p e e c h   a n d   s t o r e d   i n   t h e   m e m o r y   b u f f e r s   s u p p l i e d   b y   t h e   T e x t T o S p e e c h A d d B u f f e r   c a l l .   T h e   T e x t T o S p e e c h C l o s e I n M e m o r y   c a l l   b l o c k s   u n t i l   t h e   s p e e c h   f r o m   a l l   p r e v i o u s l y   q u e u e d   t e x t   i s   p r o c e s s e d . 
 
 W h e n   a   m e m o r y   b u f f e r   i s   c o m p l e t e d ,   t h e   b u f f e r   i s   r e t u r n e d   t o   t h e   c a l l i n g   a p p l i c a t i o n .   S e e   t h e   C a l l b a c k   R o u t i n e s   a n d   W i n d o w   P r o c e d u r e s   s e c t i o n   f o r   m o r e   i n f o r m a t i o n   a b o u t   p a s s i n g   d a t a   b a c k   t o   t h e   c a l l i n g   a p p l i c a t i o n . 
 
 I n i t i a l i z a t i o n   o f   M e m o r y   B u f f e r s 
 
 A   m e m o r y   b u f f e r   i s   a   T T S _ B U F F E R _ T   s t r u c t u r e .   T h i s   s t r u c t u r e   a n d   t h e   e l e m e n t s   o f   i t s   l p D a t a ,   l p P h o n e m e A r r a y ,   a n d   l p I n d e x A r r a y   m e m b e r s   m u s t   b e   a l l o c a t e d .   ( N o t e   t h a t   t h e s e   l a s t   t w o   p o i n t e r s   c a n   b e   o p t i o n a l l y   s e t   t o   N U L L   i f   t h e y   a r e   n o t   u s e d   b y   t h e   a p p l i c a t i o n . )   
 
 T h e   l p D a t a   e l e m e n t   p o i n t s   t o   a   b y t e   a r r a y .   T h e   d w M a x i m u m B u f f e r L e n g t h   m u s t   b e   s e t   t o   t h e   l e n g t h   o f   t h i s   a r r a y .   
 
 I f   t h e   l p P h o n e m e A r r a y   e l e m e n t   i s   s e t   t o   N U L L ,   t h e n   n o   p h o n e m e s   a r e   r e t u r n e d .   O t h e r w i s e ,   t h e   l p P h o n e m e A r r a y   e l e m e n t   m u s t   p o i n t   t o   a n   a p p l i c a t i o n - a l l o c a t e d   a r r a y   o f   s t r u c t u r e s   o f   t y p e   T T S _ P H O N E M E _ T .   T h e   l e n g t h   o f   t h i s   a r r a y   m u s t   b e   c o p i e d   i n t o   t h e   d w M a x i m u m N u m b e r O f P h o n e m e C h a n g e s   e l e m e n t .   
 
 I f   t h e   l p I n d e x A r r a y   e l e m e n t   i s   s e t   t o   N U L L ,   t h e n   n o   i n d e x   m a r k s   a r e   r e t u r n e d .   O t h e r w i s e ,   t h e   l p I n d e x A r r a y   e l e m e n t   m u s t   p o i n t   t o   a n   a p p l i c a t i o n - a l l o c a t e d   a r r a y   o f   s t r u c t u r e s   o f   t y p e   T T S _ I N D E X _ T .   T h e   l e n g t h   o f   t h i s   a r r a y   m u s t   b e   c o p i e d   i n t o   t h e   d w M a x i m u m N u m b e r O f I n d e x C h a n g e s   e l e m e n t . 
 
 T T S _ B U F F E R _ T   S t r u c t u r e   ( t t s a p i . h ) 
 
 T h i s   s t r u c t u r e   i s   a l l o c a t e d   b y   t h e   c a l l i n g   a p p l i c a t i o n   a n d   p a s s e d   t o   t h e   t e x t - t o - s p e e c h   s y s t e m   t h r o u g h   t h e   T e x t T o S p e e c h A d d B u f f e r   c a l l . 
 
 t y p e d e f   s t r u c t   T T S _ B U F F E R _ T A G   
 
 {   
 
       L P S T R   l p D a t a ; 
 
       L P T T S _ P H O N E M E _ T     l p P h o n e m e A r r a y ; 
 
       L P T T S _ I N D E X _ T     l p I n d e x A r r a y ; 
 
       D W O R D   d w M a x i m u m B u f f e r L e n g t h ; 
 
       D W O R D   d w M a x i m u m N u m b e r O f P h o n e m e C h a n g e s ; 
 
       D W O R D   d w M a x i m u m N u m b e r O f I n d e x M a r k s ; 
 
       D W O R D   d w B u f f e r L e n g t h ; 
 
       D W O R D   d w N u m b e r O f P h o n e m e C h a n g e s ; 
 
       D W O R D   d w N u m b e r O f I n d e x M a r k s ; 
 
       D W O R D   d w R e s e r v e d ;   
 
 }   T T S _ B U F F E R _ T ; 
 
 
 
 t y p e d e f   T T S _ B U F F E R _ T   *   L P T T S _ B U F F E R _ T ; 
 
 T T S _ P H O N E M E _ T   S t r u c t u r e   ( t t s a p i . h ) 
 
 T h i s   s t r u c t u r e   i s   u s e d   t o   s t o r e   p h o n e m e ,   s t r e s s ,   a n d   s y n t a c t i c   c o d e s   o f   t h e   s p e e c h   s a m p l e .   R e f e r   t o   t h e   P h o n e m i c   S y m b o l s   a n d   t h e   S t r e s s   a n d   S y n t a c t i c   S y m b o l s   s e c t i o n s   i n   t h e   D E C t a l k   S o f t w a r e   R e f e r e n c e   G u i d e   f o r   a   d e t a i l e d   l i s t   o f   t h e s e   s y m b o l s . 
 
 t y p e d e f   s t r u c t   T T S _ P H O N E M E _ T A G   
 
 {   
 
       / /   P h o n e m e ,   S t r e s s   o r   S y n t a c t i c   s y m b o l s 
 
       D W O R D   d w P h o n e m e ;   
 
 
 
       / /   I n d i c a t e s   w h i c h   s a m p l e   i n   t h e   m e m o r y   b u f f e r 
 
       / /   c o r r e s p o n d s   t o   t h e   p h o n e m e   s y m b o l 
 
       D W O R D   d w P h o n e m e S a m p l e N u m b e r ;   
 
 
 
       / /   D u r a t i o n   o f   p h o n e m e   s y m b o l   i n   m i l l i s e c o n d s 
 
       D W O R D   d w P h o n e m e D u r a t i o n 
 
 
 
       D W O R D   d w R e s e r v e d ; 
 
 }   T T S _ P H O N E M E _ T ; 
 
 t y p e d e f   T T S _ P H O N E M E _ T   *   L P T T S _ P H O N E M E _ T ; 
 
 T T S _ I N D E X _ T   S t r u c t u r e   ( t t s a p i . h ) 
 
 T h i s   s t r u c t u r e   i s   u s e d   t o   s t o r e   i n d e x   m a r k s   d e f i n e d   b y   t h e   I n d e x   M a r k   i n - l i n e   c o m m a n d .   R e f e r   t o   t h e   I n d e x   M a r k   i n - l i n e   c o m m a n d   i n   t h e   D E C t a l k   S o f t w a r e   R e f e r e n c e   G u i d e   f o r   i n f o r m a t i o n   o n   t h e   s y n t a x   a n d   u s e s   o f   I n d e x   M a r k s . 
 
 t y p e d e f   s t r u c t   T T S _ I N D E X _ T A G   
 
 {   
 
       / /   I n d e x   M a r k   v a l u e 
 
       D W O R D   d w I n d e x V a l u e ; 
 
 
 
       / /   I n d i c a t e s   w h i c h   s a m p l e   i n   t h e   m e m o r y   b u f f e r 
 
       / /   c o r r e s p o n d s   t o   t h e   i n d e x   m a r k   v a l u e 
 
       D W O R D   d w I n d e x S a m p l e N u m b e r ; 
 
 
 
       D W O R D   d w R e s e r v e d ; 
 
 }   T T S _ I N D E X _ T ;   
 
 t y p e d e f   T T S _ I N D E X _ T   *   L P T T S _ I N D E X _ T ; 
 
 T T S _ C A P S _ T   S t r u c t u r e   ( t t s a p i . h ) 
 
 T h i s   s t r u c t u r e   i s   u s e d   b y   t h e   T e x t T o S p e e c h G e t C a p s   c a l l   t o   s t o r e   l a n g u a g e   a n d   p r o p e r   n a m e   s u p p o r t ,   s a m p l e   r a t e ,   m i n i m u m   a n d   m a x i m u m   s p e a k i n g   r a t e ,   n u m b e r   o f   p r e d e f i n e d   s p e a k i n g   v o i c e s ,   c h a r a c t e r - s e t   s u p p o r t e d ,   a n d   v e r s i o n   n u m b e r . 
 
 t y p e d e f   s t r u c t   T T S _ C A P S _ T A G 
 
     {     
 
           D W O R D   d w N u m b e r O f L a n g u a g e s ; 
 
           L P L A N G U A G E _ P A R A M S _ T     l p L a n g u a g e P a r a m s A r r a y ; 
 
           D W O R D   d w S a m p l e R a t e ; 
 
           D W O R D   d w M i n i m u m S p e a k i n g R a t e ; 
 
           D W O R D   d w M a x i m u m S p e a k i n g R a t e ; 
 
           D W O R D   d w N u m b e r O f P r e d e f i n e d S p e a k e r s ; 
 
           D W O R D   d w C h a r a c t e r S e t ; 
 
           D W O R D   V e r s i o n ; 
 
     }   T T S _ C A P S _ T ; 
 
     t y p e d e f   T T S _ C A P S _ T   *   L P T T S _ C A P S _ T ; 
 
 T h e   * l p L a n g u a g e P a r a m s A r r a y   e l e m e n t   i s   a   p o i n t e r   t o   a n   a r r a y   o f   s t r u c t u r e s   o f   t y p e   L A N G U A G E _ P A R A M S _ T .   T h e   " d w N u m b e r O f L a n g u a g e s "   e l e m e n t   c o n t a i n s   t h e   n u m b e r   o f   e l e m e n t s   i n   t h i s   a r r a y .   T h e   d w L a n g u a g e   e l e m e n t   o f   e a c h   s t r u c t u r e   i n   t h i s   a r r a y   e q u a l s   o n e   o f   t h e   s u p p o r t e d   l a n g u a g e s .   C u r r e n t l y   o n l y   t h e   f o l l o w i n g   v a l u e   w i l l   b e   r e t u r n e d   i n   t h e   d w L a n g u a g e   e l e m e n t . 
 
 T T S _ A M E R I C A N _ E N G L I S H   
 
 T h e   d w L a n g u a g e A t t r i b u t e s   e l e m e n t   o f   e a c h   s t r u c t u r e   c a n   c o n t a i n   t h e   f o l l o w i n g   c o n s t a n t s   d e f i n e d   i n   i n c l u d e   f i l e   t t s a p i . h : 
 
 P R O P E R _ N A M E _ P R O N U N C I A T I O N   
 
 R e t u r n   o f   M e m o r y   B u f f e r s 
 
 W h e n   t h e   m e m o r y   b u f f e r   i s   c o m p l e t e d ,   t h e   m e m o r y   b u f f e r   i s   r e t u r n e d   t o   t h e   c a l l i n g   a p p l i c a t i o n .   A   m e m o r y   b u f f e r   i s   c o n s i d e r e d   c o m p l e t e d   w h e n   a n y   o n e   o f   t h e   f o l l o w i n g   o c c u r : 
 
 T h e   m e m o r y   b u f f e r ,   w h i c h   i s   p o i n t e d   t o   b y   t h e   l p D a t a   f i e l d ,   i s   f i l l e d . 
 
 T h e   p h o n e m e   a r r a y   i s   f i l l e d .   R e f e r   t o   t h e   A m e r i c a n   E n g l i s h   P h o n e m e   C o d e s   i n   t h e   D E C t a l k   S o f t w a r e   R e f e r e n c e   G u i d e   f o r   m o r e   i n f o r m a t i o n   o n   t h e   p h o n e m e   c o d e s . 
 
 T h e   i n d e x   m a r k   a r r a y   i s   f i l l e d .   R e f e r   t o   t h e   I n d e x   M a r k   f o r   S p e e c h   S t a t u s   s e c t i o n   i n   t h e   D E C t a l k   S o f t w a r e   R e f e r e n c e   G u i d e   f o r   m o r e   i n f o r m a t i o n   o n   t h e   i n d e x   m a r k s . 
 
 A   T T S _ F O R C E   i s   u s e d   i n   t h e   c a l l   t o   T e x t T o S p e e c h S p e a k . 
 
 T h e   a p p l i c a t i o n   m u s t   n o t   m o d i f y   a n y   b u f f e r   p a s s e d   t o   t h e   t e x t - t o - s p e e c h   s y s t e m   b y   t h e   T e x t T o S p e e c h A d d B u f f e r   c a l l   u n t i l   t h e   b u f f e r   i s   r e t u r n e d   f r o m   t h e   t e x t - t o - s p e e c h   s y s t e m   t o   t h e   c a l l i n g   a p p l i c a t i o n .   T h e   a p p l i c a t i o n   t h e n   o w n s   t h e   b u f f e r .   I f   n o   b u f f e r s   a r e   a v a i l a b l e ,   t h e   s y s t e m   b l o c k s .   I f   t h e   a p p l i c a t i o n   i s   p r o c e s s i n g   r e l a t i v e l y   l o n g   p a s s a g e s   o f   t e x t ,   i t   i s   r e c o m m e n d e d   t h a t   t h e   a p p l i c a t i o n   q u e u e s   s e v e r a l   b u f f e r s   a n d   t h e n   r e q u e u e s   e a c h   b u f f e r   a f t e r   f i n i s h i n g   w i t h   i t   s o   t h a t   t h e   s y s t e m   i s   n o t   i d l e . 
 
 A   c a l l   t o   T e x t T o S p e e c h R e s e t   r e t u r n s   a l l   b u f f e r s   t o   t h e   a p p l i c a t i o n .   T h e   T e x t T o S p e e c h R e t u r n B u f f e r   c a l l   f o r c e s   t h e   r e t u r n   o f   t h e   c u r r e n t   m e m o r y   b u f f e r ,   w h e t h e r   i t   i s   f i l l e d   o r   n o t .   T h i s   c a l l   m i g h t   n o t   b e   r e q u i r e d   b y   m o s t   a p p l i c a t i o n s .   I t   i s   i n c l u d e d   s o   a n   a p p l i c a t i o n   c a n   o b t a i n   t h e   l a s t   b u f f e r   w i t h o u t   f o r c i n g   t h a t   b u f f e r   t o   b e   s e n t   w i t h   t h e   T T S _ F O R C E   c o m m a n d   i n   t h e   T e x t T o S p e e c h S p e a k   c a l l . 
 
 W h e n   t h e   m e m o r y   b u f f e r ,   a   T T S _ B U F F E R _ T   s t r u c t u r e ,   i s   r e t u r n e d   t o   t h e   c a l l i n g   a p p l i c a t i o n ,   i t   c o n t a i n s   t h e   f o l l o w i n g   r e t u r n   v a l u e s : 
 
 P a r a m e t e r 
 
 V a l u e 
 
 d w B u f f e r L e n g t h 
 
 N u m b e r   o f   b y t e s   o f   a u d i o   s a m p l e s . 
 
 l p D a t a 
 
 P o i n t e r   t o   t h e   a u d i o   s a m p l e   d a t a . 
 
 d w N u m b e r O f P h o n e m e C h a n g e s 
 
 N u m b e r   o f   p h o n e m e   c h a n g e s . 
 
 l p P h o n e m e A r r a y 
 
 P o i n t e r   t o   t h e   p h o n e m e   i n f o r m a t i o n . 
 
 d w N u m b e r O f I n d e x M a r k s 
 
 N u m b e r   o f   i n d e x   m a r k s .   
 
 l p I n d e x A r r a y 
 
 P o i n t e r   t o   t h e   i n d e x   m a r k   i n f o r m a t i o n . 
 
 
 
 T h e   i n d e x   a n d   p h o n e m e   a r r a y s   e a c h   c o n t a i n   a   t i m e   s t a m p   i n   t h e   f o r m   o f   a   s a m p l e   n u m b e r .   T h i s   s a m p l e   n u m b e r   i s   i n i t i a l i z e d   a t   z e r o   a t   s t a r t u p   a n d   a f t e r   e a c h   c a l l   t o   T e x t T o S p e e c h R e s e t .   T h e   p h o n e m e   a r r a y   a l s o   c o n t a i n s   t h e   c u r r e n t   p h o n e m e   d u r a t i o n   i n   f r a m e s .   E a c h   f r a m e   i s   a p p r o x i m a t e l y   6 . 4   m i l l i s e c o n d s . 
 
 
 
 D i c t i o n a r y   C a l l s   ( U N I X   o n l y ) 
 
 T h e   D E C t a l k   S o f t w a r e   c o m e s   w i t h   a   m a i n   d i c t i o n a r y ,   w h i c h   i s   a   c o m p i l e d   l i s t   o f   w o r d s   a n d   t h e i r   a s s o c i a t e d   p h o n e m i c   i n t e r p r e t a t i o n .   T h i s   m a i n   d i c t i o n a r y   i s   l o a d e d   d u r i n g   t h e   s t a r t u p   f u n c t i o n .   I n   a d d i t i o n   t o   a   m a i n   d i c t i o n a r y ,   u s e r s   c a n   c r e a t e   t h e i r   o w n   u s e r   d i c t i o n a r i e s   a n d   a c c e s s   t h e m   u s i n g   t h e   T e x t T o S p e e c h L o a d U s e r D i c t i o n a r y   a n d   T e x t T o S p e e c h U n l o a d U s e r D i c t i o n a r y   c a l l s . 
 
 C r e a t i n g   a   U s e r   D i c t i o n a r y 
 
 D E C t a l k   S o f t w a r e   c o m e s   w i t h   t w o   d i c t i o n a r y   a p p l e t s .   B o t h   h e l p   t h e   u s e r   t o   c r e a t e   t h e i r   o w n   u s e r   d i c t i o n a r y ,   w h i c h   c a n   b e   l o a d e d   a t   s t a r t u p   t i m e   o r   w h i l e   t h e   t e x t - t o - s p e e c h   s y s t e m   i s   a c t i v e . 
 
 A p p l i c a t i o n 
 
 L o c a t i o n 
 
 C o m m e n t s 
 
 u s e r d i c t 
 
 / u s r / u c b / u s e r d i c t 
 
 C o m p i l e s   a   u s e r   d i c t i o n a r y   f r o m   a   f i l e   c o n t a i n i n g   b o t h   t h e   w o r d   a n d   i t s   p h o n e m i c   p r o n u n c i a t i o n . 
 
 w i n d i c t 
 
 / u s r / u c b / w i n d i c t 
 
 A p p l i c a t i o n   t h a t   h a s   a   g r a p h i c a l   u s e r   i n t e r f a c e   a n d   c a n :   
 
 P r o n o u n c e   w o r d s 
 
 T r a n s l a t e   w o r d s   i n t o   t h e i r   p h o n e m i c   s y m b o l s 
 
 C o m p i l e   a   u s e r   d i c t i o n a r y   f r o m   a   l i s t   o f   w o r d s   a n d   t h e i r   p h o n e m i c   s y m b o l s 
 
 
 
 L o a d i n g   t h e   M a i n   D i c t i o n a r y   
 
 T h e   s t a r t u p   f u n c t i o n   l o a d s   t h e   D E C t a l k   S o f t w a r e   m a i n   p r o n u n c i a t i o n   d i c t i o n a r y .   
 
   / u s r / l i b / d t k / d e c t a l k . d i c 
 
 I f   t h e   d i c t i o n a r y   f i l e   c a n n o t   b e   f o u n d   o r   i s   l o a d e d   i m p r o p e r l y ,   t h e n   t h e   s t a r t u p   f u n c t i o n   r e t u r n s   a n   e r r o r . 
 
 L o a d i n g   t h e   U s e r   D i c t i o n a r y   
 
 T h e   s t a r t u p   f u n c t i o n   a t t e m p t s   t o   l o a d   t h e   D E C t a l k   S o f t w a r e   u s e r   p r o n u n c i a t i o n   d i c t i o n a r y   f r o m   t h e   u s e r ' s   h o m e   d i r e c t o r y .   
 
 $ H O M E / u s e r . d i c 
 
 I f   t h e   d i c t i o n a r y   f i l e   i s   f o u n d   b u t   c a n   n o t   b e   l o a d e d ,   t h e n   t h e   s t a r t u p   f u n c t i o n   r e t u r n s   a n   e r r o r . 
 
 A f t e r   t h e   s t a r t u p   f u n c t i o n   h a s   c o m p l e t e d   s u c c e s s f u l l y ,   t h e   u s e r   c a n   l o a d   a n d   u n l o a d   u s e r   d i c t i o n a r i e s   u s i n g   t h e   T e x t T o S p e e c h L o a d U s e r D i c t i o n a r y   a n d   T e x t T o S p e e c h U n l o a d U s e r D i c t i o n a r y   c a l l s . 
 
 D i c t i o n a r y   C a l l s   ( W i n d o w s   o n l y ) 
 
 T h e   D E C t a l k   S o f t w a r e   c o m e s   w i t h   a   m a i n   d i c t i o n a r y ,   w h i c h   i s   a   c o m p i l e d   l i s t   o f   w o r d s   a n d   t h e i r   a s s o c i a t e d   p h o n e m i c   i n t e r p r e t a t i o n .   T h i s   m a i n   d i c t i o n a r y   i s   l o a d e d   d u r i n g   t h e   s t a r t u p   f u n c t i o n   c a l l .   I n   a d d i t i o n   t o   a   m a i n   d i c t i o n a r y ,   u s e r s   c a n   c r e a t e   t h e i r   o w n   u s e r   d i c t i o n a r i e s   a n d   a c c e s s   t h e m   u s i n g   t h e   T e x t T o S p e e c h L o a d U s e r D i c t i o n a r y   a n d   T e x t T o S p e e c h U n l o a d U s e r D i c t i o n a r y   c a l l s . 
 
 C r e a t i n g   a   U s e r   D i c t i o n a r y 
 
 D E C t a l k   S o f t w a r e   c o m e s   w i t h   t h e   f o l l o w i n g   f i l e s ,   w h i c h   h e l p   t h e   u s e r   t o   c r e a t e   t h e i r   o w n   u s e r   d i c t i o n a r y ,   w h i c h   c a n   b e   l o a d e d   a t   s t a r t u p   t i m e   o r   w h i l e   t h e   t e x t - t o - s p e e c h   s y s t e m   i s   a c t i v e . 
 
 F i l e   N a m e 
 
 L o c a t i o n 
 
 C o m m e n t s 
 
 w i n d i c . e x e 
 
 \ P r o g r a m   F i l e s \ D E C t a l k 
 
 A p p l i c a t i o n   t h a t   h a s   a   g r a p h i c a l   u s e r   i n t e r f a c e   a n d   c a n :   
 
 P r o n o u n c e   w o r d s 
 
 T r a n s l a t e   w o r d s   i n t o   t h e i r   p h o n e m i c   s y m b o l s 
 
 C o m p i l e   a   u s e r   d i c t i o n a r y   f r o m   a   l i s t   o f   w o r d s   a n d   t h e i r   p h o n e m i c   s y m b o l s 
 
 u s e r . t a b 
 
 \ P r o g r a m   F i l e s \ D E C t a l k 
 
 S o u r c e   f i l e   u s e d   b y   w i n d i c . e x e   t o   c r e a t e   t h e   u s e r   d i c t i o n a r y . 
 
 
 
 L o a d i n g   t h e   M a i n   D i c t i o n a r y 
 
 T h e   T e x t T o S p e e c h S t a r t u p   c a l l   a t t e m p t s   t o   f i n d   t h e   e n t r y   f o r   t h e   D E C t a l k   S o f t w a r e   m a i n   p r o n u n c i a t i o n   d i c t i o n a r y   i n   t h e   r e g i s t r y   a t : 
 
 	 R E G I S T R Y   K E Y :     
 
 	 H K E Y _ L O C A L _ M A C H I N E   	 \ S O F T W A R E \ D i g i t a l E q u i p m e n t C o r p o r a t i o n \ D E C t a l k \ v e r s \ l a n g u a g e _ c o d e 
 
 	 V a l u e :   M a i n D i c t 
 
 a n d   i s   s e t   t o   v a l u e :   
 
 	 [ u s e r   s e l e c t e d   d i r ] \ s y s t e m \ d e c t a l k . d i c 
 
 R e p l a c e   v e r s   u s i n g   t h e   f o r m a t   x . x x  i n   t h e   p a t h   d e s i g n a t i o n   w i t h   t h e   c u r r e n t   v e r s i o n   n u m b e r   f o r   t h e   D E C t a l k   S o f t w a r e ,   s u c h   a s   4 . 5 0 . 
 
 R e p l a c e   l a n g u a g e _ c o d e  w i t h   t h e   d e s i g n a t i o n   f o r   t h e   a p p r o p r i a t e   l a n g u a g e ,   s u c h   a s   U S   f o r   U n i t e d   S t a t e s   E n g l i s h ,   G R   f o r   G e r m a n ,   L A   f o r   L a t i n   A m e r i c a n   S p a n i s h ,   o r   U K   f o r   U n i t e d   K i n g d o m   E n g l i s h .   
 
 I f   t h e   M a i n D i c t   e n t r y   c a n n o t   b e   f o u n d ,   t h e n   t h e   T e x t T o S p e e c h S t a r t u p   c a l l   d e f a u l t s   t o   l o o k i n g   i n   t h e   a p p l i c a t i o n ' s   d e f a u l t   d i r e c t o r y   f o r   D E C T A L K . D I C   t o   b e   l o a d e d   a s   t h e   m a i n   p r o n u n c i a t i o n   d i c t i o n a r y .   
 
 I f   t h e   m a i n   p r o n u n c i a t i o n   d i c t i o n a r y   f a i l s   t o   b e   l o a d e d ,   t h e n   t h e   T e x t T o S p e e c h S t a r t u p   c a l l   r e t u r n s   a   v a l u e   o f   M M S Y S E R R _ E R R O R . 
 
 L o a d i n g   t h e   U s e r   D i c t i o n a r y 
 
 T h e   T e x t T o S p e e c h S t a r t u p   c a l l   a t t e m p t s   t o   f i n d   t h e   e n t r y   f o r   t h e   D E C t a l k   S o f t w a r e   u s e r   p r o n u n c i a t i o n   d i c t i o n a r y   i n   t h e   r e g i s t r y   a t : 
 
 R E G I S T R Y   K E Y :     
 
 H K E Y _ C U R R E N T _ U S E R   \ S o f t w a r e \ D i g i t a l E q u i p m e n t C o r p o r a t i o n \ D E C t a l k \ v e r s \ l a n g u a g e _ c o d e 
 
 V a l u e :   U s e r D i c t 
 
 a n d   i s   s e t   t o   v a l u e :   
 
 [ u s e r   s e l e c t e d   d i r ] \ u s e r . d i c 
 
 R e p l a c e   v e r s   u s i n g   t h e   f o r m a t   x . x x  i n   t h e   p a t h   d e s i g n a t i o n   w i t h   t h e   c u r r e n t   v e r s i o n   n u m b e r   f o r   t h e   D E C t a l k   S o f t w a r e ,   s u c h   a s   4 . 5 0 . 
 
 R e p l a c e   l a n g u a g e _ c o d e  w i t h   t h e   d e s i g n a t i o n   f o r   t h e   a p p r o p r i a t e   l a n g u a g e ,   s u c h   a s   U S   f o r   U n i t e d   S t a t e s   E n g l i s h ,   G R   f o r   G e r m a n ,   L A   f o r   L a t i n   A m e r i c a n   S p a n i s h ,   o r   U K   f o r   U n i t e d   K i n g d o m   E n g l i s h .   
 
 I f   t h e   U s e r D i c t   e n t r y   c a n n o t   b e   f o u n d ,   t h e n   t h e   T e x t T o S p e e c h S t a r t u p   c a l l   d e f a u l t s   t o   l o o k i n g   i n   t h e   a p p l i c a t i o n   d e f a u l t   d i r e c t o r y   f o r   u s e r . d i c   t o   b e   l o a d e d   a s   t h e   u s e r   p r o n u n c i a t i o n   d i c t i o n a r y .   
 
 I f   t h e   u s e r   p r o n u n c i a t i o n   d i c t i o n a r y   f a i l s   t o   b e   l o a d e d ,   t h e n   t h e   T e x t T o S p e e c h S t a r t u p   c a l l   r e t u r n s   a   v a l u e   o f   M M S Y S E R R _ E R R O R . 
 
 S a m p l e   P r o g r a m s   ( U N I X   o n l y ) 
 
 S o m e   a p p l e t s   a r e   i n c l u d e d   w i t h   D E C t a l k   S o f t w a r e .   T h e s e   s a m p l e   a p p l i c a t i o n s   a r e   i n c l u d e d   t o   d e m o n s t r a t e   t h e   u s e   o f   D E C t a l k   S o f t w a r e   A P I s .   T h e s e   s o u r c e s   c a n   b e   u s e d   a s   t e m p l a t e s   f o r   o t h e r   a p p l i c a t i o n s   t h a t   y o u   m i g h t   w a n t   t o   d e v e l o p .   
 
 S o m e   o f   t h e   a p p l e t s   d e m o n s t r a t e   t h e   D E C t a l k   S o f t w a r e   A P I   e x t e n s i o n   t o   t h e   m u l t i m e d i a   A P I   s p e c i f i e d   i n   t h e   M u l t i m e d i a   S e r v i c e s   f o r   D I G I T A L   U N I X   p r o d u c t .   T h e s e   a p p l e t s   a r e   t h e   o n e s   t h a t   p l a y   b a c k   s p e e c h   s a m p l e s   t o   a n   a u d i o   d e v i c e .   T h e s e   a p p l e t s   a r e   b u i l t   u s i n g   t h e   l i b t t s m m e . s o   s h a r e d   l i b r a r y . 
 
 O t h e r   a p p l e t s   d e m o n s t r a t e   t h e   D E C t a l k   S o f t w a r e   A P I   t h a t   d o e s   n o t   i n c l u d e   t h e   m u l t i m e d i a   e x t e n s i o n s .   T h e s e   a p p l e t s   a r e   t h o s e   t h a t   d o   n o t   r e q u i r e   a n y   a u d i o   d e v i c e s .   T h e s e   a p p l e t s   c a n   b e   b u i l t   u s i n g   t h e   l i b t t s . s o   s h a r e d   l i b r a r y . 
 
 S o u r c e s   t o   t h e s e   p r o g r a m s   c a n   b e   f o u n d   i n :   
 
 / u s r / e x a m p l e s / d t k / d t s a m p l e s   
 
 T h e   s a m p l e s   a n d   a   b r i e f   d e s c r i p t i o n   a r e   l i s t e d   b e l o w .   
 
 A p p l e t 
 
 D e s c r i p t i o n 
 
 x m s a y 
 
 D e m o n s t r a t e s   t h e   u s e   o f   D E C t a l k   S o f t w a r e   A P I s   i n   t h e   M o t i f   w i n d o w s   e n v i r o n m e n t .   
 
 s a y 
 
 T h i s   i s   a n   e x a m p l e   o f   c o n v e r t i n g   t e x t   i n t o   s p e e c h   s a m p l e s   t h a t   a r e   s e n t   t o   a n   a u d i o   d e v i c e . 
 
 d t m e m o r y 
 
 T h i s   i s   a n   e x a m p l e   o f   c o n v e r t i n g   t e x t   i n t o   s p e e c h   s a m p l e s   s t o r e d   i n   m e m o r y   b u f f e r s . 
 
 a c l o c k 
 
 A n n o u n c e s   t h e   t i m e   a t   s p e c i f i e d   i n t e r v a l s . 
 
 
 
 B u i l d i n g   S a m p l e   P r o g r a m s 
 
 S a m p l e   p r o g r a m s   c a n   b e   c r e a t e d   f r o m   t h e   s o u r c e s   p r o v i d e d   i n   / u s r / e x a m p l e s / d t k / d t s a m p l e s .   T h i s   s e c t i o n   d e s c r i b e s   t h e   p r o c e d u r e   f o r   b u i l d i n g   t h e   s a m p l e   p r o g r a m s .   B e f o r e   p r o c e e d i n g   m a k e   s u r e   t h a t   t h e   D E C t a l k   S o f t w a r e   d e v e l o p m e n t   k i t   h a s   b e e n   i n s t a l l e d .   S e e   t h e   D E C t a l k "!  S o f t w a r e   I n s t a l l a t i o n   G u i d e   f o r   m o r e   i n f o r m a t i o n   o n   d i f f e r e n t   c o m p o n e n t s   o f   D E C t a l k   S o f t w a r e .   
 
 1 . C r e a t e   a   l o c a l   d i r e c t o r y   t h a t   y o u   w a n t   t o   b u i l d   t h e   s a m p l e   p r o g r a m s   i n .   
 
 2 . C o p y   a l l   t h e   f i l e s   i n   / u s r / e x a m p l e s / d t k / d t s a m p l e s   i n t o   t h e   d i r e c t o r y   t h a t   y o u   j u s t   c r e a t e d .   
 
 3 . G e n e r a t e   a   M a k e f i l e   f r o m   t h e   I m a k e f i l e   b y   t y p i n g : 
 
 u s r / b i n / X 1 1 / x m k m f 
 
 4 . C o m p i l e   a n d   l i n k   t h e   s a m p l e   a p p l i c a t i o n   p r o g r a m s   b y   t y p i n g   t h e   f o l l o w i n g   w h i l e   s t i l l   i n   t h e   d i r e c t o r y   t h a t   y o u   j u s t   c r e a t e d :   
 
 m a k e   a l l   
 
 5 . A f t e r   t h e   m a k e   p r o g r a m   c o m p l e t e s   s u c c e s s f u l l y ,   t h e   s a m p l e   p r o g r a m s   a r e   r e a d y   t o   r u n . 
 
 I n   a d d i t i o n   t o   t h e   s a m p l e   p r o g r a m s   y o u   w i l l   a l s o   f i n d   s o m e   d e m o   t e x t   f i l e s   i n   y o u r   d i r e c t o r y .   T h e s e   f i l e s   d e m o n s t r a t e   s o m e   o f   t h e   D E C t a l k   S o f t w a r e   c a p a b i l i t i e s .   
 
 H e a d e r   F i l e s   
 
 D E C t a l k   S o f t w a r e   p r o v i d e s   h e a d e r   f i l e s   t h a t   c o n t a i n   a l l   t h e   p u b l i c   d a t a - s t r u c t u r e   d e f i n i t i o n s   t h a t   t h e   D E C t a l k   S o f t w a r e   A P I   r e f e r e n c e s .   T h e y   a r e   t t s a p i . h ,   d t m m e d e f s . h ,   a n d   L L _ x x _ P H . H ,   w h e r e   x x   i s   t h e   l a n g u a g e   a b b r e v i a t i o n   f o r   e a c h   o f   t h e   s u p p o r t e d   l a n g u a g e s .   W h e n   D E C t a l k   S o f t w a r e   i s   i n s t a l l e d ,   t h e s e   f i l e s   a r e   i n   / u s r / i n c l u d e / d t k .   
 
 t t s a p i . h   c o n t a i n s   d e f i n i t i o n s   o f   c o n s t a n t s   u s e d   i n   t h e   D E C t a l k   S o f t w a r e   A P I   c a l l s ,   d a t a   s t r u c t u r e s   t h a t   d e f i n e   t h e   b u f f e r s   t h a t   D E C t a l k   S o f t w a r e   r e t u r n s ,   a n d   t h e   A P I   f u n c t i o n   p r o t o t y p e   d e f i n i t i o n s .   
 
 d t m m e d e f s . h   c o n t a i n s   t h e   b a s i c   d a t a   s t r u c t u r e   d e f i n i t i o n s   u s e d   b y   D E C t a l k   S o f t w a r e .   I t   a l s o   c o n t a i n s   d e f i n i t i o n s   o f   e r r o r   c o d e s   a n d   a u d i o   f o r m a t s .   T h i s   f i l e   e n a b l e s   y o u   t o   c o m p i l e ,   l i n k ,   a n d   r u n   c e r t a i n   D E C t a l k   S o f t w a r e   p r o g r a m s   e v e n   i f   M u l t i m e d i a   S e r v i c e s   f o r   D I G I T A L   U N I X   i s   n o t   i n s t a l l e d .   S p e c i f i c a l l y ,   i f   y o u   a r e   w r i t i n g   a n   a p p l i c a t i o n   p r o g r a m   t h a t   d o e s   n o t   u s e   t h e   a u d i o   d r i v e r s   b u t   w a n t   t o   u s e   D E C t a l k   S o f t w a r e   t o   p r o d u c e   s y n t h e s i z e d   s p e e c h   b u f f e r s   u s i n g   t h e   T e x t T o S p e e c h O p e n I n M e m o r y   c a l l ,   t h e n   u s i n g   d t m m e d e f s . h   c i r c u m v e n t s   t h e   r e q u i r e m e n t   f o r   M u l t i m e d i a   S e r v i c e s   f o r   D I G I T A L   U N I X .   
 
 H e a d e r   f i l e s   f o r   t h e   p h o n e m e   c o d e s   a r e ,   a s   f o l l o w s : 
 
 L _ U S _ P H . H 
 
 E n g l i s h   ( U n i t e d   S t a t e s ) 
 
 L _ G R _ P H . H 
 
 G e r m a n 
 
 L _ L A _ P H . H 
 
 L a t i n   A m e r i c a n   S p a n i s h 
 
 L _ U K _ P H . H 
 
 E n g l i s h   ( U n i t e d   K i n g d o m ) 
 
 
 
 
 
 S h a r e a b l e   L i b r a r i e s   
 
 D E C t a l k   S o f t w a r e   A P I s   a r e   a v a i l a b l e   t o   p r o g r a m m e r s   i n   t w o   s h a r e a b l e   l i b r a r i e s . 
 
 l i b t t s . s o   c o n t a i n s   d e v i c e   i n d e p e n d e n t   D E C t a l k   S o f t w a r e   r o u t i n e s .   
 
 l i b t t s m m e . s o   c o n t a i n s   t h e   D E C t a l k   S o f t w a r e   l i b r a r y   t h a t   r e q u i r e s   M u l t i m e d i a   S e r v i c e s   f o r   D I G I T A L   U N I X .   
 
 A s   i n   t h e   c a s e   o f   t h e   h e a d e r   f i l e s ,   i f   y o u   w a n t   t o   u s e   D E C t a l k   S o f t w a r e   t o   w r i t e   a n   a p p l i c a t i o n   t h a t   p r o d u c e s   b u f f e r s   o f   s y n t h e s i z e d   s p e e c h ,   t h e n   t h e   p r o g r a m   i s   l i n k e d   w i t h   t h e   l i b t t s   s h a r e d   l i b r a r y .   I f ,   o n   t h e   o t h e r   h a n d ,   y o u   w a n t   t o   u s e   t h e   M u l t i m e d i a   S e r v i c e s   f o r   D I G I T A l   U N I X   t o   c o m m u n i c a t e   w i t h   t h e   a u d i o   s u b s y s t e m   t h e n   t h e   a p p l i c a t i o n   h a s   t o   b e   l i n k e d   w i t h   t h e   l i b t t s m m e   s h a r e d   l i b r a r y .   
 
 S a m p l e   P r o g r a m s   ( W i n d o w s   o n l y ) 
 
 S a m p l e   p r o g r a m s   i n c l u d e : 
 
 d t s a m p l e 
 
 T h i s   i s   a n   e x a m p l e   o f   a   b a s i c   W i n d o w e d   e d i t o r   w i t h   i n t e g r a t e d   t e x t   t o   s p e e c h . 
 
 s a y 
 
 T h i s   i s   a n   e x a m p l e   o f   a   c o m m a n d - l i n e   p r o g r a m   u s i n g   D E C t a l k   S o f t w a r e . 
 
 d t m e m o r y 
 
 T h i s   i s   a n   e x a m p l e   o f   s y n t h e s i s   i n t o   m e m o r y   b u f f e r s . 
 
 t t s t s t 
 
 T h i s   i s   a   s a m p l e   p r o g r a m   t o   d e m o n s t r a t e   t h e   M i c r o s o f t   s p e e c h   A P I   i n t e r f a c e s   s u p p o r t e d   b y   t h e   D E C t a l k   S o f t w a r e   s p e e c h   e n g i n e . 
 
 
 
 
 
 T h e   s a m p l e   p r o g r a m s   a r e   f u r n i s h e d   a s   e x a m p l e s   o f   s i m p l e   W i n d o w s   a p p l i c a t i o n s   t h a t   c a n   b e   b u i l t   u s i n g   t h e   D E C t a l k   S o f t w a r e   A P I .   T h e   s o u r c e   c o d e   f o r   t h e   s a m p l e   p r o g r a m s   a r e   p l a c e d   i n   t h e   r o o t   d i r e c t o r y ,   \ D E C T A L K \ S A M P L E \ ,   d u r i n g   t h e   i n s t a l l a t i o n .   T h e s e   p r o g r a m s   i n c l u d e   t h e   A P I   d e f i n i t i o n   f i l e   t t s a p i . h   a n d   a r e   l i n k e d   w i t h   d e c t a l k . l i b .   
 
 U s i n g   t h e   S o f t w a r e   D e v e l o p m e n t   K i t   ( t h e   W i n 3 2   S D K   m u s t   b e   i n s t a l l e d ) ,   b r i n g   u p   a   W i n d o w s   c o n s o l e   w i n d o w . 
 
 S e t   y o u r   d e f a u l t   d i r e c t o r y   t o   t h e   \ D E C T A L K \ S A M P L E \ D T S A M P L E   d i r e c t o r y . 
 
 E n t e r   n m a k e 
 
 T h i s   p r o c e d u r e   p r o d u c e s   t h e   d t s a m p l e . e x e   e x e c u t a b l e   f i l e .   T h i s   f i l e   c a n   b e   e x e c u t e d   a t   t h e   W i n d o w s   c o n s o l e   w i n d o w   o r   t h e   F i l e   M a n a g e r .   
 
 T h e   d t s a m p l e   p r o g r a m   d e m o n s t r a t e s   m o s t   o f   t h e   D E C t a l k   S o f t w a r e   A P I   c a l l s .   A n y   a p p l i c a t i o n   c a n   c a l l   a n y   o f   t h e   A P I   c a l l s   b y   i n c l u d i n g   t h e   t t s a p i   h e a d e r   f i l e   ( t t s a p i . h )   a n d   l i n k i n g   w i t h   t h e   D E C t a l k   S o f t w a r e   l i b r a r y   ( d e c t a l k . l i b )   a s   l o n g   a s   t h e   a s s o c i a t e d   d l l   ( d e c t a l k . d l l )   i s   p r e s e n t .   T h e   d e c t a l k . d l l   m u s t   b e   i n s t a l l e d   a n d   t h e   d i c t i o n a r y   d e c t a l k . d i c   m u s t   b e   i n   t h e   d i c t i o n a r y   p a t h   i n   t h e   r e g i s t r y   o r   i n   t h e   l o c a l   d i r e c t o r y . 
 
 
 
 
 
 C h a p t e r   4   - 
 
 H o w   t o   d o   M u l t i - L a n g u a g e   P r o g r a m m i n g 
 
 M u l t i - l a n g u a g e   p r o g r a m m i n g   u s i n g   D E C t a l k   S o f t w a r e   r e q u i r e s   l o a d i n g   a   D E C t a l k   l a n g u a g e ,   s e l e c t i n g   a   l o a d e d   l a n g u a g e   f o r   a   p r o g r a m   t h r e a d ,   s t a r t i n g   a   T T S   i n s t a n c e ,   c l o s i n g   t h e   p r o g r a m   t h r e a d ,   a n d   c l o s i n g   t h a t   l a n g u a g e .   S w a p p i n g   a   l a n g u a g e   r e q u i r e s   s h u t t i n g   d o w n   a n d   c l o s i n g   t h e   t h r e a d   a n d   t h e   l a n g u a g e   s e l e c t o r .   Y o u   c a n   l o a d   a s   m a n y   l a n g u a g e s   a s   y o u   w a n t   d u r i n g   t h e   e x e c u t i o n   o f   y o u r   p r o g r a m   a s   w e l l   a s   s e l e c t   t w o   o r   m o r e   l a n g u a g e s   c o n c u r r e n t l y .   T h e   f o l l o w i n g   s t e p s   s u m m a r i z e   t h e   m e t h o d o l o g y   t o   s t a r t ,   s e l e c t ,   a n d   c l o s e   a   s i n g l e   l a n g u a g e .   
 
 N o t e 
 
 Y o u   m u s t   s t a r t   a n d   s e l e c t   a   l a n g u a g e   b e f o r e   u s i n g   D E C t a l k   S o f t w a r e   t o   s p e a k . 
 
 T h e   b a s i c   e l e m e n t s   o f   m u l t i - l a n g u a g e   p r o g r a m m i n g   a r e   p r e s e n t e d   i n   t h e   s e c t i o n s   a s   f o l l o w s : 
 
 S t a r t i n g   a   L a n g u a g e 
 
 S e l e c t i n g   a   L a n g u a g e 
 
 C l o s i n g   a   L a n g u a g e 
 
 M u l t i - L a n g u a g e   P r o g r a m m i n g   E x a m p l e 
 
 S t a r t i n g   a   L a n g u a g e 
 
 T o   s t a r t   a   D E C t a l k   l a n g u a g e E r r o r !   R e f e r e n c e   s o u r c e   n o t   f o u n d . ,   u s e   t h e   T e x t T o S p e e c h S t a r t L a n g   c a l l   t o   p a s s   t h e   c a l l   t h e   t w o - l e t t e r   n a m e   o f   t h e   l a n g u a g e   y o u   w a n t   t o   l o a d .     A f t e r   t h e   l a n g u a g e   i s   l o a d e d ,   y o u   r e c e i v e   a   h a n d l e   t o   t h a t   l a n g u a g e .     I f   t h e   l a n g u a g e   i s   a l r e a d y   l o a d e d ,   y o u   g e t   t h e   p r e v i o u s l y   l o a d e d   h a n d l e   t o   t h a t   l a n g u a g e   a s   t h e   r e t u r n   v a l u e .     T h e   s a m e   h a n d l e   i s   u s e d   f o r   a l l   i n s t a n c e s   o f   a   l a n g u a g e   p e r   r u n .     O n   f a i l u r e ,   y o u   r e c e i v e   a   h a n d l e   w i t h   t h e   T T S _ L A N G _ E R R O R   b i t   s e t   a s   d e f i n e d   i n   T T S F E A T . H . 
 
 E x a m p l e : 
 
 T e x t T o S p e e c h S t a r t L a n g   ( " u k " ) 
 
   S e l e c t i n g   a   L a n g u a g e 
 
 B e f o r e   a   c a l l   c a n   b e   m a d e   t o   a n y   o f   t h e   s t a n d a r d   D A P I   f u n c t i o n s ,   a n d   a f t e r   y o u   h a v e   t h e   h a n d l e   t o   a   l a n g u a g e ,   y o u   m u s t   s e l e c t   t h e   l a n g u a g e .     T h i s   i s   a c c o m p l i s h e d   t h r o u g h   t h e   T e x t T o S p e e c h S e l e c t L a n g   c a l l .     Y o u   m u s t   s e l e c t   t h e   l a n g u a g e   b e f o r e   e a c h   c a l l   t o   a n y   D A P I   f u n c t i o n   t h a t   d o e s   n o t   t a k e   i n   a   v a l i d   L P T T S _ H A N D L E _ T   h a n d l e .   T h e   f i r s t   p a r a m e t e r   t o   T e x t T o S p e e c h S e l e c t L a n g   m u s t   b e   N U L L .   T h e   f o l l o w i n g   p a r a m e t e r   i s   t h e   h a n d l e   r e t r i e v e d   f r o m   T e x t T o S p e e c h S t a r t L a n g .     T h e   r e t u r n   v a l u e   f r o m   T e x t T o S p e e c h S e l e c t L a n g   i s   a   B o o l e a n   w i t h   T R U E   t o   s i g n i f y   s u c c e s s   a n d   F A L S E   t o   s i g n i f y   f a i l u r e . 
 
 E x a m p l e : 
 
 T e x t T o S p e e c h S e l e c t L a n g   ( N U L L , U K h a n d l e ) 
 
 C l o s i n g   a   L a n g u a g e 
 
 A f t e r   y o u   c l o s e   y o u r   p r o g r a m   t h r e a d s ,   u s e   t h e   T e x t T o S p e e c h C l o s e L a n g   c a l l   t o   c l o s e   t h e   l a n g u a g e .     T h i s   c a l l   t a k e s   i n   t h e   t w o - c h a r a c t e r   l a n g u a g e   n a m e   o f   t h e   l a n g u a g e   t o   r e l e a s e   a n d   a t t e m p t s   t o   r e l e a s e   t h e   l a n g u a g e   a n d   i t s   a s s o c i a t e d   f i l e s .   I f   o t h e r   t h r e a d s   a r e   s t i l l   u s i n g   t h e   l a n g u a g e ,   t h e   T e x t T o S p e e c h C l o s e L a n g   c a l l   r e d u c e s   t h e   i n s t a n c e   c o u n t e r   b y   o n e   f o r   t h a t   l a n g u a g e .     T h e   f i l e   i s   f r e e   w h e n   a l l   l a n g u a g e   h o o k s   a r e   f r e e d . 
 
 E x a m p l e : 
 
 T e x t T o S p e e c h C l o s e L a n g   ( " u k " ) 
 
 E x a m p l e 
 
 T h i s   e x a m p l e   s h o w s   D E C t a l k   M L   a l l o c a t i n g   E n g l i s h   ( u s ) ,   c r e a t i n g   a   t h r e a d ,   d e s t r o y i n g   t h e   t h r e a d ,   a n d   f i n a l l y   c l o s i n g   t h e   l a n g u a g e . 
 
 v o i d   s a m p l e ( v o i d )   { 
 
 	 u n s i g n e d   l o n g   i n t   U S h a n d l e ; 
 
 	 M M R E S U L T   r e s u l t ; 
 
 	 L P T T S _ H A N D L E _ T   p h T T S ; 
 
 
 
 	 U S h a n d l e   =   T e x t T o S p e e c h S t a r t L a n g ( " u s " ) ; 
 
 	 i f   ( U S h a n d l e   &   T T S _ L A N G _ E R R O R )   { 
 
 	 	 p r i n t f ( " E r r o r   l o a d i n g   U S   E n g l i s h \ n " ) ; 
 
 	 	 e x i t ( 1 ) ; 
 
 	 } 
 
 	 i f   ( T e x t T o S p e e c h S e l e c t L a n g ( N U L L ,   U S h a n d l e )   = =   F A L S E )   { 
 
 	 	 p r i n t f ( " E r r o r   s e l e c t i n g   l a n g u a g e \ n " ) ; 
 
 	 	 T e x t T o S p e e c h C l o s e L a n g ( " u s " ) ; 
 
 	 	 e x i t ( 1 ) ; 
 
 	 } 
 
 	 r e s u l t   =   T e x t T o S p e e c h S t a r t u p ( h W n d ,   & p h T T S ,   W A V E _ M A P P E R , 
 
 R E P O R T _ O P E N _ E R R O R ) ; 
 
 	 i f   ( r e s u l t   ! =   M M S Y S E R R _ N O E R R O R )   { 
 
 	 	 p r i n t f ( " U n a b l e   t o   s t a r t   D E C t a l k   S p e e c h   E n g i n e \ n " ) ; 
 
 	 	 T e x t T o S p e e c h C l o s e L a n g ( " u s " ) ; 
 
 	 	 e x i t ( 1 ) ; 
 
 	 } 
 
 	 T e x t T o S p e e c h S h u t d o w n ( p h T T S ) ; 
 
 	 T e x t T o S p e e c h C l o s e L a n g ( " u s " ) ; 
 
 	 p r i n t f ( " E x a m p l e   c o m p l e t e d   s u c c e s s f u l l y ! \ n " ) ; 
 
 	 r e t u r n ; 
 
 } 
 
 
 
 
 
 G l o s s a r y 
 
 a l l o p h o n e 
 
 A   p o s i t i o n a l   o r   f r e e   v a r i a n t   o f   a   p h o n e m e . 
 
 a p p l e t 
 
 A   s m a l l   a p p l i c a t i o n   t h a t   n o r m a l l y   p e r f o r m s   a   v e r y   s p e c i f i c   f u n c t i o n   a n d   c a n   b e   u s e d   w i t h   o t h e r   l a r g e r   a p p l i c a t i o n s . 
 
 a r p a b e t 
 
 A   s p e c i a l   p h o n e t i c   a l p h a b e t   u s e d   t o   w r i t e   p h o n e m e s   a n d   s y l l a b l e s .     
 
 c l a u s e   b o u n d a r y 
 
 T h e   n a t u r a l   b o u n d a r y   b e t w e e n   t w o   o r   m o r e   c l a u s e s   i n   a   s e n t e n c e   t h a t   h e l p s   t h e   l i s t e n e r   e a s i l y   s e p a r a t e   t h e   s e n t e n c e   i n t o   i t s   c o m p o n e n t   p a r t s .   C o m m a s ,   p e r i o d s ,   e x c l a m a t i o n   p o i n t s ,   q u e s t i o n   m a r k s ,   s e m i - c o l o n s ,   a n d   c o l o n s   a r e   s y m b o l s   u s e d   t o   i n d i c a t e   c l a u s e   b o u n d a r i e s . 
 
 c l a u s e   m o d e 
 
 T h e   n o r m a l   m o d e   i n   w h i c h   D E C t a l k   S o f t w a r e   s p e a k s   t e x t   a   p h r a s e ,   c l a u s e ,   o r   s e n t e n c e   a t   a   t i m e .   I n   c l a u s e   m o d e ,   s p e a k i n g   s t a r t s   w h e n   D E C t a l k   S o f t w a r e   i s   s e n t   a   c l a u s e   t e r m i n a t o r   ( p e r i o d ,   c o m m a ,   e x c l a m a t i o n   p o i n t ,   q u e s t i o n   m a r k ,   s e m i - c o l o n ,   o r   c o l o n )   f o l l o w e d   b y   a   s p a c e .   
 
 c l a u s e   t e r m i n a t o r 
 
 A   s y m b o l   u s e d   t o   b e g i n   a n d   t e r m i n a t e   a   c l a u s e   b o u n d a r y .   S y m b o l s   c a n   b e   p e r i o d s ,   c o m m a s ,   e x c l a m a t i o n   p o i n t s ,   q u e s t i o n   m a r k s ,   s e m i - c o l o n ,   o r   c o l o n .   E a c h   o f   t h e s e   s y m b o l s   m u s t   b e   f o l l o w e d   b y   a   s p a c e . 
 
 c o m m a   p a u s e 
 
 T h e   p a u s e   D E C t a l k   S o f t w a r e   t a k e s   i n   s p e a k i n g   t h a t   i s   e q u i v a l e n t   t o   i n s e r t i n g   a   c o m m a   i n   a   s e n t e n c e .   C o m m a   p a u s e   c a n   b e   i n c r e a s e d   a n d   d e c r e a s e d   w i t h   t h e   C o m m a   P a u s e   i n - l i n e   c o m m a n d . 
 
 . D I C   f i l e 
 
 T h e   l o a d a b l e   d i c t i o n a r y   f i l e   c r e a t e d   b y   t h e   U s e r   D i c t i o n a r y   B u i l d   T o o l   f r o m   a   . t a b   s o u r c e   f i l e . 
 
 e m p h a t i c   s t r e s s 
 
 T h e   e m p h a s i s   p l a c e d   o n   a   s y l l a b l e   o f   a   w o r d   t o   g i v e   i t   m o r e   m e a n i n g . 
 
 f a l l i n g   i n t o n a t i o n   
 
 A   d e c r e a s e   i n   v o i c e   p i t c h . 
 
 f l u s h 
 
 P r o c e s s   b y   w h i c h   t h e   T e x t - T o - S p e e c h   s y s t e m   d i s c a r d s   d a t a   i n   t h e   s y s t e m . 
 
 h e u r i s t i c 
 
 A   m e t h o d   o r   r u l e   u s e d   t o   d e c i d e   a m o n g   s e v e r a l   c o u r s e s   o f   a c t i o n .   O f t e n   c a l l e d   a   " r u l e   o f   t h u m b . "   I n   t h e   c a s e   o f   D E C t a l k   S o f t w a r e ,   p r o n u n c i a t i o n   h e u r i s t i c s   g o v e r n   t h e   m a n n e r   i n   w h i c h   D E C t a l k   S o f t w a r e   p r o n o u n c e s   w o r d s . 
 
 h o m o g r a p h 
 
 P a i r s   o f   w o r d s   t h a t   h a v e   t h e   s a m e   s p e l l i n g   b u t   w h i c h   a r e   p r o n o u n c e d   d i f f e r e n t l y ,   d e p e n d i n g   o n   w h i c h   s y l l a b l e   i s   a c c e n t e d .     F o r   e x a m p l e ,   t h e   p r o n u n c i a t i o n   o f   p e r m i t   a s   a   n o u n   a n d   t h e   p r o n u n c i a t i o n   o f   p e r m i t   a s   a   v e r b . 
 
 i n d e x   m a r k e r   ( f l a g ) 
 
 A   m a r k e r   p l a c e d   i n   t h e   t e x t   s t r e a m   t o   s y n c h r o n i z e   a n   e x t e r n a l   e v e n t .   A n   i n d e x   m a r k e r   i s   i n s e r t e d   w i t h   t h e   I n d e x   M a r k   c o m m a n d . 
 
 i n t o n a t i o n 
 
 T h e   m a n n e r   i n   w h i c h   a   v o i c e   i m p a r t s   e x t r a   m e a n i n g   t o   s p e e c h   b y   a d j u s t i n g   s o u n d s '   d u r a t i o n s   a n d   v o i c e   p i t c h .   F o r   e x a m p l e ,   t h e   e m p h a s i s   a n d   m e a n i n g   o f   t h e   s e n t e n c e ,   B i l l ,   p u t   i n   t h e   e d i t s .   c a n   b e   c h a n g e d   b y   p u t t i n g   s t r o n g e r   e m p h a s i s   o n   t h e   n a m e ,   B i l l .     B i l l !   P u t   i n   t h e   e d i t s ! 
 
 l e t t e r   m o d e 
 
 T h e   s t a t e   i n   w h i c h   D E C t a l k   S o f t w a r e   s p e a k s   e a c h   l e t t e r   a s   i t   i s   q u e u e d .   I n   w o r d   a n d   l e t t e r   m o d e ,   D E C t a l k   S o f t w a r e   d o e s   n o t   n e e d   t o   w a i t   f o r   a   c l a u s e   t e r m i n a t o r   t o   b e g i n   s p e a k i n g .   T h i s   c o m m a n d   i n t e r a c t s   w i t h   t h e   r a t e   s e l e c t i o n   c o m m a n d   s o   t h a t   y o u   c a n   s e t   b o t h   r a t e   s e l e c t i o n   a n d   l e t t e r   m o d e   f o r   o p t i m a l   o u t p u t . 
 
 l o g   f i l e 
 
 A   f i l e   t h a t   c a n   c o n t a i n   t e x t ,   p h o n e m e s ,   o r   s y l l a b l e s .   T h e   p h o n e m e s   a n d   s y l l a b l e s   a r e   w r i t t e n   u s i n g   t h e   a r p a b e t   p h o n e m e   a l p h a b e t . 
 
 l o g - f i l e   m o d e 
 
 L o g - f i l e   m o d e   i n d i c a t e s   t h a t   t h e   s p e e c h   s a m p l e s   a r e   t o   b e   w r i t t e n   a s   t e x t ,   p h o n e m e s ,   o r   s y l l a b l e s   i n t o   a   l o g   f i l e   r a t h e r   t h a n   s e n t   t o   a n   a u d i o   d e v i c e .   T h e   T e x t T o S p e e c h O p e n L o g F i l e ( )   c a l l   e n t e r s   t h e   t e x t - t o - s p e e c h   s y s t e m   i n t o   a   l o g - f i l e   m o d e .   T h e   T e x t T o S p e e c h C l o s e L o g F i l e ( )   c a l l   r e t u r n s   t h e   t e x t - t o - s p e e c h   s y s t e m   t o   t h e   s t a r t u p   s t a t e . 
 
 m o r p h e m e 
 
 T h e   m i n i m u m   s y n t a c t i c   u n i t   o f   a   l a n g u a g e   t h a t   h a s   a n   i m p o r t a n t   r o l e   i n   d e t e r m i n i n g   p r o n u n c i a t i o n s .   F o r   e x a m p l e ,   s p e l l   h a s   o n l y   o n e   m o r p h e m e ,   w h i l e   m i s s p e l l i n g   i s   m a d e   u p   o f   t h r e e :   m i s ,   s p e l l ,   a n d   i n g .   
 
 p e r i o d   p a u s e 
 
 T h e   p a u s e   D E C t a l k   S o f t w a r e   i n s e r t s   w h e n   i t   f i n d s   a   p e r i o d   t h a t   m a r k s   t h e   e n d   o f   t h e   s e n t e n c e .   T h i s   p a u s e   i m i t a t e s   h u m a n s   t a k i n g   a   b r e a t h .     T h i s   p a u s e   i s   a p p r o x i m a t e l y   h a l f   a   s e c o n d . 
 
 p h o n e m e 
 
 S m a l l e s t   u n i t   o f   s p e e c h   t h a t   d i s t i n g u i s h e s   o n e   w o r d   f r o m   a n o t h e r .   P h o n e m e s   a r e   d i v i d e d   i n t o   v o w e l   a n d   c o n s o n a n t   p h o n e m e s .   D E C t a l k   S o f t w a r e   i n t e r p r e t s   t e x t   b r a c k e t s   a s   p h o n e m e s   o n l y   a f t e r   t h e   p h o n e m e   a r p a b e t   c o m m a n d   i s   u s e d . 
 
 p h o n e m e   a r p a b e t   c o m m a n d 
 
 A   c o m m a n d   t h a t   c a u s e s   a l l   t e x t   w i t h i n   b r a c k e t s   t o   b e   t r e a t e d   a s   p h o n e m i c   t e x t . 
 
 p h o n e m e   s t r i n g 
 
 T w o   o r   m o r e   p h o n e m e s   t o g e t h e r   u s e d   t o   p r o n o u n c e   a   s p e c i a l   w o r d   o r   g r o u p   o f   w o r d s . 
 
 p h o n e m i c i z e 
 
 T o   e n c o d e   w o r d s   a s   s t r i n g s   o f   p h o n e m e s . 
 
 p h o n e m i c   m o d e 
 
 A   m o d e   D E C t a l k   S o f t w a r e   u s e s   f o r   s p e a k i n g   p h o n e m e   s t r i n g s . 
 
 p h o n e m i c   t r a n s c r i p t i o n 
 
 A   w o r d   w r i t t e n   t h e   w a y   i t   i s   p r o n o u n c e d   i s   s a i d   t o   b e   i n   p h o n e m i c   t r a n s c r i p t i o n   o r   s i m p l y   i n   p h o n e m i c s .   W h e n   D E C t a l k   S o f t w a r e   s a y s   a   w o r d   o r   p h r a s e   n o t   a s   y o u   i n t e n d e d ,   y o u   m i g h t   n e e d   t o   u s e   p h o n e m i c   t r a n s c r i p t i o n   t o   g e t   t h e   d e s i r e d   p r o n u n c i a t i o n .     F o r   e x a m p l e ,     [ r ' e h d ]   i s   t h e   p h o n e m i c   t r a n s c r i p t i o n   o f   t h e   w o r d   r e a d . 
 
 p h r a s e   b o u n d a r y   
 
 A   c l a u s e   b o u n d a r y   f o r m e d   b y   t e r m i n a t i n g   p u n c t u a t i o n   ( c o m m a ,   p e r i o d ,   e x c l a m a t i o n   p o i n t ,   q u e s t i o n   m a r k ,   s e m i - c o l o n ,   c o l o n )   f o l l o w e d   b y   a   s p a c e . 
 
 p i t c h   c o n t r o l   s y m b o l s 	 
 
 S y m b o l s   u s e d   t o   o v e r r i d e   b u i l t - i n   D E C t a l k   S o f t w a r e   p i t c h   c o n t r o l .   S y m b o l s   i n c l u d e   p i t c h   r i s e   [ / ] ,   p i t c h   f a l l   [ \ ] ,   a n d   p i t c h   r i s e   a n d   f a l l   [ / \ ] . 
 
 p r i m a r y   s t r e s s 
 
 M o s t   c o n t e n t   w o r d s   o f   E n g l i s h   ( n o u n s ,   v e r b s ,   a d j e c t i v e s ,   a n d   a d v e r b s )   c o n t a i n   o n e   p r i m a r y   s t r e s s e d   s y l l a b l e .   T h e   p r i m a r y   s t r e s s   s y m b o l   i n   D E C t a l k   S o f t w a r e   i s   t h e   a p o s t r o p h e   [   '   ] . 
 
 p r o p e r   n a m e 
 
 F i r s t   n a m e s ,   l a s t   n a m e s ,   s t r e e t   n a m e s ,   c o m p a n y   n a m e s ,   a n d   p l a c e   n a m e s   a r e   a l l   e x a m p l e s   o f   p r o p e r   n a m e s . 
 
 s e c o n d a r y   s t r e s s 
 
 A   s y m b o l   u s e d   t o   i n d i c a t e   a   d e g r e e   o f   s t r e s s   t h a t   i s   b e t w e e n   p r i m a r y   a n d   u n s t r e s s e d   ( n o   s t r e s s ) .   T h e   s e c o n d a r y   s t r e s s   s y m b o l   i s   t h e   g r a v e   a c c e n t   [ ` ] .   
 
 s i l e n c e   p h o n e m e s 
 
 S i l e n c e s   o f   s p e c i f i e d   d u r a t i o n s   i n s e r t e d   i n t o   t e x t   f i l e s   i n   t h e   s a m e   m a n n e r   a s   y o u   w o u l d   i n s e r t   a   p h o n e m e . 
 
 s p e e c h - t o - m e m o r y   m o d e 
 
 S p e e c h - t o - m e m o r y   m o d e   i n d i c a t e s   t h a t   t h e   s p e e c h   s a m p l e s   a r e   t o   b e   w r i t t e n   i n t o   m e m o r y   b u f f e r s   r a t h e r   t h a n   s e n t   t o   a n   a u d i o   d e v i c e .   T h e   T e x t T o S p e e c h A d d B u f f e r   c a l l   s u p p l i e s   t h e   t e x t - t o - s p e e c h   s y s t e m   w i t h   t h e   m e m o r y   b u f f e r s   t h a t   i t   n e e d s .   T h e   T e x t T o S p e e c h O p e n I n M e m o r y   c a l l   e n t e r s   t h e   t e x t - t o - s p e e c h   s y s t e m   i n t o   a   s p e e c h - t o - m e m o r y   m o d e .   T h e   T e x t T o S p e e c h C l o s e I n M e m o r y   c a l l   r e t u r n s   t h e   t e x t - t o - s p e e c h   s y s t e m   t o   t h e   s t a r t u p   s t a t e . 
 
 s t a r t u p   f u n c t i o n 
 
 S t a r t u p   f u n c t i o n   r e f e r s   t o   e i t h e r   t h e   T e x t T o S p e e c h S t a r t u p   c a l l   o r   t h e   T e x t T o S p e e c h S t a r t u p E x   c a l l . 
 
 s t a r t u p   s t a t e 
 
 S t a r t u p   s t a t e   i n d i c a t e s   t h a t   T e x t T o S p e e c h S t a r t u p   o r   T e x t T o S p e e c h S t a r t u p E x   h a s   b e e n   s u c c e s s f u l l y   c a l l e d   a n d   t h e   t e x t - t o - s p e e c h   s y s t e m   i s   n o t   i n   o n e   o f   t h e   t h r e e   s p e c i a l   m o d e s ;   w a v e - f i l e ,   l o g - f i l e ,   o r   s p e e c h - t o - m e m o r y   m o d e .   W h i l e   i n   s t a r t u p   s t a t e ,   s p e e c h   s a m p l e s   a r e   s e n t   t o   a n   a u d i o   d e v i c e   o r   i g n o r e d ,   d e p e n d i n g   o n   w h e t h e r   t h e   D O _ N O T _ U S E _ A U D I O _ D E V I C E   f l a g   i s   s e t   i n   t h e   d w D e v i c e O p t i o n s   p a r a m e t e r   o f   t h e   s t a r t u p   f u n c t i o n .   I f   t h e   t e x t - t o - s p e e c h   s y s t e m   i s   i n   o n e   o f   i t s   s p e c i a l   m o d e s ,   t h e   s p e e c h   s a m p l e s   a r e   h a n d l e d   a c c o r d i n g l y . 
 
 s y n t a c t i c   f u n c t i o n   w o r d s 
 
 A   s e t   o f   w o r d s   t h a t   a r e   e i t h e r   u n s t r e s s e d   o r   h a v e   s e c o n d a r y   s t r e s s .   T h e y   i n c l u d e   p r e p o s i t i o n s ,   c o n j u n c t i o n s ,   d e t e r m i n e r s ,   a u x i l i a r y   v e r b s ,   p r o n o u n s ,   q u e s t i o n   m a r k ,   a n d   c l a u s e   i n t r o d u c e r s .   D E C t a l k   S o f t w a r e   u s e s   s t r e s s   a n d   s y n t a c t i c   s y m b o l s   t o   c o n t r o l   a s p e c t s   o f   r h y t h m ,   s t r e s s ,   a n d   i n t o n a t i o n   p a t t e r n s .   T h e s e   s y m b o l s   i n c l u d e   p u n c t u a t i o n   m a r k s   s u c h   a s   c o m m a s ,   p e r i o d s ,   q u e s t i o n   m a r k s ,   a n d   e x c l a m a t i o n   p o i n t s . 
 
 . T A B   f i l e 
 
 T h e   s o u r c e   f i l e   u s e d   t o   b u i l d   a   u s e r   d i c t i o n a r y . 	 
 
 u s e r   d i c t i o n a r y 	 
 
 T h e   d i c t i o n a r y   t h a t   y o u   d e f i n e   s o   D E C t a l k   S o f t w a r e   c a n   l o a d   a n d   u s e   w i t h   a n   a p p l i c a t i o n   t o   c o n t r o l   t h e   p r o n u n c i a t i o n   o f   s p e c i f i c   w o r d s   p r o c e s s e d   b y   t h e   a p p l i c a t i o n . 
 
 u s e r   d i c t i o n a r y   b u i l d e r 	 
 
 A   p r o g r a m   a p p l e t   i n c l u d e d   w i t h   D E C t a l k   S o f t w a r e   t o   b u i l d   a n d   c o m p i l e   u s e r   d i c t i o n a r i e s . 
 
 v o i c e - c o n t r o l   c o m m a n d 
 
 A   D E C t a l k   S o f t w a r e   c o m m a n d   i n s e r t e d   i n t o   t e x t   s t r i n g s   a n d   u s e d   t o   c o n t r o l   b a s i c   a n d   s p e c i a l   T e x t - T o - S p e e c h   c a l l s ,   s u c h   a s   s p e a k i n g   v o i c e   a n d   s p e a k i n g   r a t e . 
 
 W a v e   f i l e 
 
 A   M i c r o s o f t   s t a n d a r d   f i l e   f o r m a t   f o r   s t o r i n g   w a v e f o r m   a u d i o   d a t a .   W a v e   f i l e s   h a v e   a   . W A V   f i l e   e x t e n s i o n . 
 
 w a v e   f o r m   o u t p u t 
 
 T h e   d i g i t i z e d   r e p r o d u c t i o n   o f   a   s o u n d   w a v e   f o r m .   D E C t a l k   S o f t w a r e   p r o d u c e s   w a v e f o r m   o u t p u t   f r o m   t h e   S p e a k   p r o g r a m   a p p l e t   a n d   t h e   A P I ,   b o t h   o f   w h i c h   a l l o w   y o u   t o   s a v e   a n   A S C I I   t e x t   f i l e   t o   . W A V   f i l e   f o r m a t .   
 
 w a v e - f i l e   m o d e 
 
 W a v e - f i l e   m o d e   i n d i c a t e s   t h a t   t h e   s p e e c h   s a m p l e s   a r e   t o   b e   w r i t t e n   t o   a   w a v e   f i l e   r a t h e r   t h a n   s e n t   t o   a n   a u d i o   d e v i c e .   T h e   T e x t T o S p e e c h O p e n W a v e O u t F i l e   c a l l   e n t e r s   t h e   t e x t - t o - s p e e c h   s y s t e m   i n t o   a   w a v e - f i l e   m o d e .   T h e   T e x t T o S p e e c h C l o s e W a v e O u t F i l e   c a l l   r e t u r n s   t h e   t e x t - t o - s p e e c h   s y s t e m   t o   t h e   s t a r t u p   s t a t e . 
 
 w o r d   b o u n d a r y   
 
 A   w h i t e   s p a c e   c h a r a c t e r   ( s p a c e   o r   t a b )   i n   t h e   t e x t   t h a t   i n d i c a t e s   a   b o u n d a r y   b e t w e e n   w o r d s .   D E C t a l k   S o f t w a r e   u s e s   w o r d   b o u n d a r y   s y m b o l s   t o   s e l e c t   t h e   w o r d - b e g i n n i n g   o r   w o r d - e n d i n g   a l l o p h o n e   o f   a   p h o n e m e . 
 
 w o r d   m o d e 
 
 A   t e x t - p r o c e s s i n g   m o d e   w h e r e   D E C t a l k   S o f t w a r e   s p e a k s   o n e   w o r d   a t   a   t i m e .   A   b l a n k   s p a c e   o r   e q u i v a l e n t   a f t e r   a   c h a r a c t e r   o r   s t r i n g   o f   c h a r a c t e r s   c a u s e s   t h a t   s t r i n g   t o   b e   s p o k e n   i n   w o r d   m o d e . 
 
 
 
 
 
 I n d e x 
 
 
 
 . 
 
 . d i c   f i l e ,   2 - 1 0 ,   2 - 1 4 
 
 . d o t   ( t e m p l a t e )   f i l e ,   2 - 2 0 
 
 . t a b   s o u r c e   f i l e ,   2 - 1 2 ,   2 - 1 4 
 
 A 
 
 A P I 
 
 f u n c t i o n   s e t ,   1 - 6 
 
 i n t r o d u c t i o n ,   1 - 6 
 
 a p p l i c a t i o n   p r o g r a m ,   2 - 1 
 
 a p p l i c a t i o n   p r o g r a m m e r ' s   i n t e r f a c e ,   1 - 6 
 
 a r p a b e t   p h o n e m e   a l p h a b e t ,   3 - 1 3 
 
 A S C I I   t e x t ,   1 - 2 
 
 a u d i o   o u t p u t   c o n t r o l   f u n c t i o n s ,   3 - 2 
 
 B 
 
 b l o c k i n g   s y n c h r o n i z a t i o n   f u n c t i o n ,   3 - 2 ,   3 - 1 1 
 
 b u f f e r ,   3 - 8 
 
 b u f f e r e d   s p e e c h ,   3 - 8 
 
 b u i l t - i n   v o i c e s ,   2 - 1 6 
 
 b u t t o n   o n   a   t o o l b a r ,   2 - 2 3 
 
 C 
 
 c a l l b a c k   r o u t i n e s ,   3 - 6 
 
 c h a n g e   a   s p e a k i n g   v o i c e ,   2 - 6 
 
 c h a n g e   t h e   o u t p u t   r a t e ,   2 - 9 
 
 c h a n g e   t h e   s p e a k i n g   r a t e ,   2 - 1 7 
 
 c l a u s e ,   3 - 5 
 
 c l a u s e   b u f f e r i n g ,   1 - 2 
 
 c l a u s e   t e r m i n a t o r ,   3 - 5 
 
 c l o s e   a   D E C t a l k   l a n g u a g e ,   4 - 2 
 
 c o m m a n d   s t r i n g s ,   1 - 2 
 
 c o m m a n d - l i n e   a p p l e t ,   2 - 2 9 
 
 c o m p i l i n g   a n   e x i s t i n g   d i c t i o n a r y ,   2 - 1 5 
 
 c o n f i g u r e   t h e   T T S   s e r v e r ,   2 - 2 5 
 
 c o n f i g u r i n g 
 
 T e x t - t o - S p e e c h   ( T T S )   s e r v e r ,   2 - 2 5 
 
 c o n t r o l   a n d   s t a t u s   f u n c t i o n s ,   3 - 2 
 
 c o r e   A P I   f u n c t i o n s ,   3 - 2 
 
 c r e a t e   a   m a c r o ,   2 - 2 3 
 
 c r e a t i n g   D i c t i o n a r y   E n t r i e s ,   2 - 1 3 
 
 D 
 
 D A P I ,   1 - 6 
 
 D A P I   f u n c t i o n ,   4 - 2 
 
 d a t a   b u f f e r s ,   1 - 6 
 
 d a t a - s t r u c t u r e   d e f i n i t i o n s ,   3 - 2 3 
 
 D D E .   S e e   D y n a m i c   D a t a   E x c h a n g e 
 
 D E C t a l k 
 
 f e a t u r e s   a n d   f u n c t i o n s ,   1 - 2 
 
 h o w   a r e   t h e   c o m p o n e n t s   u s e d ? ,   1 - 9 
 
 h o w   i t   w o r k s ,   1 - 1 1 
 
 o v e r v i e w ,   1 - 2 
 
 D E C t a l k   l a n g u a g e .   S e e   l a n g u a g e 
 
 D E C t a l k   S o f t w a r e   A P I   ( D A P I ) ,   1 - 6 ,   3 - 1 
 
 D E C t a l k   S o f t w a r e   c o m p o n e n t s ,   1 - 3 
 
 D E C t a l k   S o f t w a r e   v o i c e   s e t ,   2 - 1 6 
 
 D E C t a l k   T T S   S e r v e r ,   2 - 1 9 
 
 d e f i n i t i o n s ,   d a t a - s t r u c t u r e ,   3 - 2 3 
 
 d i c t i o n a r i e s ,   1 - 7 
 
 d i c t i o n a r y   a p p l e t s ,   3 - 1 8 
 
 d i c t i o n a r y   f i l e   ( . d i c ) ,   2 - 1 0 
 
 d i c t i o n a r y   f i l e   s t r i n g ,   2 - 2 5 
 
 D i c t i o n a r y   o p t i o n s ,   2 - 3 0 
 
 D I G I T A L   S p e e c h   A P I .   S e e   D E C t a l k   S o f t w a r e   A P I   ( D A P I ) 
 
 d r a g   a n d   d r o p ,   2 - 3 
 
 d w F l a g s   f i e l d ,   3 - 1 2 
 
 d w L a n g u a g e A t t r i b u t e s   e l e m e n t ,   3 - 1 5 
 
 D y n a m i c   D a t a   E x c h a n g e 
 
 a n d   D E C t a l k ,   2 - 1 9 
 
 D y n a m i c   D a t a   E x c h a n g e   ( D D E ) ,   2 - 1 9 
 
 E 
 
 e d i t   a   t e x t   f i l e ,   2 - 1 7 
 
 e d i t   t e x t ,   2 - 8 
 
 e d i t   t h e   t e x t ,   2 - 9 
 
 e r r o r   a n d   s t a t u s   m e s s a g e s ,   3 - 7 
 
 e r r o r   c o d e s ,   3 - 7 
 
 F 
 
 f u n c t i o n s 
 
 a u d i o   o u t p u t   c o n t r o l ,   3 - 2 
 
 b l o c k i n g   s y n c h r o n i z a t i o n ,   3 - 2 ,   3 - 1 1 
 
 c o n t r o l   a n d   s t a t u s ,   3 - 2 
 
 c o r e   A P I ,   3 - 2 
 
 l o a d i n g   a n d   u n l o a d i n g   a   U s e r   D i c t i o n a r y ,   3 - 3 
 
 s p e c i a l   T e x t - t o - S p e e c h   m o d e ,   3 - 3 
 
 H 
 
 h e a d e r   f i l e s ,   3 - 2 3 
 
 H e l p   o p t i o n s ,   2 - 2 9 
 
 h i g h l i g h t i n g   s p o k e n   t e x t ,   2 - 1 8 
 
 h o w   t o   l i n k   t h e   m a c r o ,   2 - 2 3 
 
 I 
 
 i n d e x   a n d   p h o n e m e   a r r a y s ,   3 - 1 7 
 
 I n d e x   M a r k   i n - l i n e   c o m m a n d ,   3 - 1 1 
 
 i n d e x   m a r k s ,   3 - 8 
 
 i n - l i n e   c o m m a n d 
 
 e x a m p l e s   o f ,   2 - 4 
 
 I n d e x   M a r k ,   3 - 1 1 
 
 s y n t a x   r u l e s ,   2 - 4 
 
 i n - l i n e   c o m m a n d s ,   1 - 6 
 
 I n p u t   o p t i o n s ,   2 - 2 9 
 
 i n t e r n a l   ( b u i l t - i n )   d i c t i o n a r y ,   1 - 7 
 
 i n t o n a t i o n ,   1 - 7 
 
 L 
 
 l a n g u a g e 
 
 c l o s e ,   4 - 2 
 
 l o a d ,   4 - 2 
 
 n a m e ,   4 - 2 
 
 s e l e c t ,   4 - 2 
 
 s t a r t ,   4 - 2 
 
 l a n g u a g e s ,   3 - 2 3 
 
 l a u n c h i n g 
 
 T e x t - t o - S p e e c h   ( T T S )   s e r v e r ,   2 - 2 5 
 
 l i n k   t h e   m a c r o ,   2 - 2 3 
 
 l o a d   a   u s e r   d i c t i o n a r y ,   2 - 1 7 
 
 l o a d a b l e   d i c t i o n a r y   f i l e   ( . d i c ) ,   2 - 1 0 
 
 l o a d i n g   a   U s e r   D i c t i o n a r y   f u n c t i o n ,   3 - 3 
 
 l o g   f i l e ,   3 - 1 3 
 
 L P A R A M   p a r a m e t e r ,   3 - 7 ,   3 - 8 
 
 l p D a t a   e l e m e n t ,   3 - 1 3 
 
 l p I n d e x A r r a y   e l e m e n t ,   3 - 1 3 
 
 l p L a n g u a g e P a r a m s A r r a y   e l e m e n t ,   3 - 1 5 
 
 l p P h o n e m e A r r a y   e l e m e n t ,   3 - 1 3 
 
 M 
 
 m a c r o ,   2 - 2 7 
 
 m a c r o   t o   r u n   D E C t a l k   w i t h   M S   W o r d 
 
 a s s o c i a t i n g   w i t h   t o o l b a r ,   2 - 2 3 
 
 m a i n   d i c t i o n a r y ,   3 - 1 8 ,   3 - 1 9 
 
 m e m o r y   b u f f e r ,   3 - 8 
 
 m e n u   s e l e c t i o n ,   2 - 2 3 
 
 m e s s a g e s ,   3 - 7 
 
 M i c r o s o f t   S p e e c h   A p p l i c a t i o n   P r o g r a m m e r ' s   I n t e r f a c e   ( S A P I ) ,   1 - 6 
 
 M i c r o s o f t   W o r d   d o c u m e n t ,   2 - 1 9 ,   2 - 2 0 
 
 m o d i f y i n g   D i c t i o n a r y   E n t r i e s ,   2 - 1 3 
 
 m u l t i - l a n g u a g e   p r o g r a m m i n g ,   4 - 1 
 
 N 
 
 n a m e ,   l a n g u a g e ,   4 - 2 
 
 O 
 
 o p t i o n s 
 
 D i c t i o n a r y ,   2 - 3 0 
 
 H e l p ,   2 - 2 9 
 
 I n p u t ,   2 - 2 9 
 
 O u t p u t ,   2 - 2 9 
 
 O u t p u t   o p t i o n s ,   2 - 2 9 
 
 P 
 
 p h o n e m e   a l p h a b e t ,   3 - 1 3 
 
 P h o n e m e   c o m m a n d 
 
 p r o p e r   u s e   o f   b r a c k e t s   w i t h ,   2 - 5 
 
 p h o n e m e   l o g g i n g ,   3 - 1 3 
 
 p h o n e m i c   i n t e r p r e t a t i o n ,   3 - 1 8 
 
 p h o n e m i c   t r a n s l a t i o n s ,   2 - 1 0 
 
 p l a y   s e l e c t e d   s e g m e n t s ,   2 - 1 7 
 
 p l a y   s e l e c t e d   t e x t ,   2 - 9 
 
 p o w e r - k e y   c o m b i n a t i o n ,   2 - 2 3 
 
 p r o g r a m   a p p l e t 
 
 S a m p l e ,   1 - 3 ,   2 - 1 
 
 S p e a k ,   1 - 5 ,   2 - 1 ,   2 - 1 6 
 
 U s e r   D i c t i o n a r y   B u i l d   T o o l ,   2 - 1 
 
 p r o g r a m   c o n t r o l ,   2 - 1 
 
 p r o g r a m m i n g   a i d s ,   1 - 6 
 
 p r o g r a m m i n g ,   m u l t i - l a n g u a g e ,   4 - 1 
 
 p r o n u n c i a t i o n ,   2 - 1 2 
 
 p r o n u n c i a t i o n   d i c t i o n a r i e s ,   1 - 7 
 
 p u l l - d o w n   m e n u ,   2 - 6 
 
 p u n c t u a t i o n ,   3 - 5 
 
 R 
 
 r e t u r n e d   m e m o r y   b u f f e r ,   3 - 8 
 
 r h y t h m i c   n a t u r a l n e s s ,   1 - 2 
 
 S 
 
 S a m p l e   p r o g r a m   a p p l e t ,   1 - 3 ,   2 - 1 
 
 s t a r t i n g   f r o m   p r o g r a m   g r o u p ,   2 - 2 
 
 s a m p l e   u s e r - d i c t i o n a r y   f i l e ,   1 - 8 
 
 S A P I ,   1 - 6 
 
 s a v e   a s   a   W A V E   f i l e ,   2 - 1 7 
 
 s a v i n g   a n   e x i s t i n g   d i c t i o n a r y ,   2 - 1 5 
 
 S a y   c o m m a n d - l i n e   a p p l e t ,   2 - 2 9 
 
 s e l e c t   a   D E C t a l k   l a n g u a g e ,   4 - 2 
 
 s e r v i c e   n a m e ,   T T S s e r v e r ,   2 - 2 5 
 
 s e r v i c e   t o p i c   n a m e s ,   2 - 2 5 
 
 s i n g i n g ,   1 - 7 
 
 s i n g l e   c h a r a c t e r s ,   1 - 2 
 
 S p e a k   p r o g r a m   a p p l e t ,   1 - 5 ,   2 - 1 ,   2 - 1 6 
 
 s p e a k e r   s e l e c t i o n ,   2 - 2 5 
 
 s p e a k i n g   a   f i l e ,   2 - 3 
 
 s p e a k i n g   r a t e ,   1 - 6 ,   2 - 1 7 ,   2 - 2 5 
 
 s p e a k i n g   v o i c e ,   1 - 6 ,   2 - 2 5 
 
 s p e c i a l   e f f e c t s ,   1 - 7 
 
 s p e c i a l   T e x t - t o - S p e e c h   m o d e   f u n c t i o n s ,   3 - 3 
 
 s p e c i a l   w o r d s ,   2 - 1 2 
 
 s p e e c h   s y n t h e s i s ,   1 - 2 
 
 s t a r t   a   D E C t a l k   l a n g u a g e ,   4 - 2 
 
 s t a r t   t h e   p r o g r a m   a p p l e t ,   2 - 2 
 
 s t a r t   t h e   T T S   s e r v e r ,   2 - 2 5 
 
 s t a r t u p   r o u t i n e ,   3 - 1 2 
 
 s t a t u s   f u n c t i o n s ,   3 - 2 
 
 s t a t u s   m e s s a g e s ,   3 - 7 
 
 s t r e s s ,   1 - 7 
 
 s u p p o r t e d   l a n g u a g e s ,   3 - 2 3 
 
 S y n c   i n - l i n e   c o m m a n d ,   3 - 5 
 
 s y n t a x 
 
 f o r   i n - l i n e   c o m m a n d s ,   2 - 4 
 
 s y n t a x   r u l e s ,   1 - 7 
 
 T 
 
 t e m p l a t e ,   2 - 2 0 
 
 t e x t   f i l e ,   2 - 1 7 
 
 i n s e r t i n g   c o m m a n d s   i n t o ,   2 - 4 
 
 T e x t - t o - S p e e c h   s e r v e r 
 
 c o n f i g u r i n g ,   2 - 2 5 
 
 f o r   u s e   w i t h   a p p l i c a t i o n s   s u p p o r t i n g   D D E ,   2 - 1 9 
 
 T e x t T o S p e e c h L o a d U s e r D i c t i o n a r y ( )   f u n c t i o n ,   2 - 1 0 
 
 T e x t T o S p e e c h S p e a k ,   3 - 6 
 
 t o o l b a r ,   2 - 2 3 
 
 a s s o c i a t i n g   W o r d   m a c r o   w i t h ,   2 - 2 3 
 
 T r a n s l a t e   c o m m a n d ,   2 - 1 0 
 
 T T S   s e r v e r ,   2 - 2 5 ,   2 - 2 7 .   S e e   T e x t   t o   S p e e c h   s e r v e r 
 
 h o w   t o   c o n f i g u r e ,   2 - 2 5 
 
 h o w   t o   s t a r t ,   2 - 2 5 
 
 T T S   S e r v e r ,   2 - 1 9 
 
 T T S   s e r v e r   m a c r o ,   2 - 2 7 
 
 T T S   s e r v i c e   n a m e ,   2 - 2 5 
 
 t t s a p i . h   f i l e ,   3 - 7 
 
 U 
 
 u n l o a d i n g   a   U s e r   D i c t i o n a r y   f u n c t i o n ,   3 - 3 
 
 u s e r   d i c t i o n a r y ,   2 - 1 2 ,   2 - 1 7 
 
 u s e r   d i c t i o n a r y   b u i l d   t o o l ,   1 - 6 ,   1 - 8 
 
 U s e r   D i c t i o n a r y   B u i l d   T o o l ,   2 - 1 0 ,   2 - 1 2 
 
 U s e r   D i c t i o n a r y   B u i l d   T o o l   p r o g r a m   a p p l e t ,   2 - 1 
 
 U s e r   d i c t i o n a r y   s e l e c t i o n ,   2 - 2 5 
 
 u s e r - d e f i n e d   d i c t i o n a r y ,   1 - 7 
 
 u s i n g   D E C t a l k   S o f t w a r e   i n - l i n e   c o m m a n d s ,   2 - 7 
 
 u s i n g   t h e   V o i c e   m e n u ,   2 - 7 
 
 V 
 
 v o i c e   c o n t r o l ,   2 - 1 
 
 V o i c e   p u l l - d o w n   m e n u ,   2 - 6 
 
 v o i c e   s e t ,   2 - 1 6 
 
 v o i c e - c o n t r o l   c o m m a n d s ,   1 - 6 ,   1 - 7 
 
 V o i c e - C o n t r o l   c o m m a n d s ,   1 - 6 
 
 v o i c e s ,   1 - 2 ,   2 - 1 6 
 
 W 
 
 W A V E   f i l e ,   2 - 1 7 
 
 w i n d o w   m e s s a g e s ,   3 - 6 
 
 W o r d   d o c u m e n t ,   2 - 1 9 ,   2 - 2 0 
 
 W o r d   m a c r o ,   2 - 2 0 ,   2 - 2 5 
 
 W o r d   m a c r o   t o   r u n   D E C t a l k 
 
 a s s o c i a t i n g   w i t h   t o o l b a r ,   2 - 2 3 
 
 c r e a t i n g ,   2 - 2 0 
 
 W P A R A M   p a r a m e t e r ,   3 - 7 
 
 
 
 
 
 v 
 
 
 
 
 
 v i 
 
 
 
 v 
 
 
 
 
 
 i i i 
 
 
 
 x 
 
 
 
 
 
 x i 
 
 
 
 1 - 1 2 
 
 
 
 
 
 1 - 3 
 
 
 
 2 - 3 0 
 
 
 
 
 
 2 - 2 9 
 
 
 
 
 
 3 - 2 4 
 
 
 
 
 
 3 - 2 5 
 
 
 
 
 
 4 - 2 
 
 
 
 
 
 4 - 3 
 
 
 
 
 
 G l o s s a r y   -   6 
 
 
 
 
 
 G l o s s a r y   -   5 
 
 
 
 
 
 I n d e x   - 4 
 
 
 
 
 
 I n d e x   - 3 
 
 
 
 
 
 