home *** CD-ROM | disk | FTP | other *** search
/ Sound Sensations! / sound_sensations.iso / voice / speechd2 / aidkeys.doc next >
Encoding:
Text File  |  1987-01-02  |  7.3 KB  |  264 lines
  1.  
  2.  
  3.  
  4. ENABLE READER 4.0         OPERATIONS MANUAL         CHAPTER 5-1
  5.  
  6.  
  7.           CHAPTER 5  TALKING TUTORIAL PROGRAMMER'S AID 
  8.  
  9.  
  10. 5.0  INTRODUCTION 
  11.  
  12. The Talking Tutorial Programmer's Aid is designed for the  
  13. experienced assembly level programmer.  Interfacing between  
  14. higher level lanuguages such as PASCAL and C BASIC are possible,  
  15. yet we do not provide these bridges.  There are ten calls that  
  16. can be accessed through the INT 21 MSDOS Supervisor Call  
  17. structure.  Load the correct registers with the values  
  18. necessary, and then do INT 21.  Enable Reader 4.0 will save all  
  19. registers except the FLAGS, where the ZERO Flag will be set if  
  20. the call was not one of the available Enable Reader 4.0  
  21. Functions.  The Enable Reader Programmer's Aid will check to see  
  22. if the instruction was successfully completed.   
  23.  
  24. When writing tutorials with the Enable Reader 4.0 System, the  
  25. information that is printed to the screen will be spoken.  Most  
  26. of the tutorial will just use this feature.  The Programmer's  
  27. Aid is designed to provide byte I/O to the synthesizer without  
  28. printing the information to the video screen, and to use Help  
  29. Functions in the Enable Reader 4.0 program to enhance the way  
  30. data will be spoken.  For example, if you need to speak  
  31. something in a way that would be confusing to the student if it  
  32. were printed to the screen, such as spelling out a word or line,  
  33. it is possible to send the data through the Enable Reader 4.0  
  34. driver to the synthesizer in Spell Mode.  This can be used to  
  35. great advantage with programs that teach spelling and reading  
  36. skills.   
  37.  
  38.  
  39. 5.1  FUNCTION CALLS 
  40.  
  41. The following calls can be made to the INT 21 Call in MSDOS by  
  42. loading the AH Register with FE HEX (254 Decimal), and then  
  43. loading the AL register with the appropriate Ascii Character  
  44. designated to call the function.   
  45.  
  46. The Enable Reader Driver is both Stream Oriented and  
  47. Hierarchical in design.  This means that entry points are  
  48. accumulative, and data passing through the driver's other entry  
  49. points gains the same attributes.  By using byte-stream  
  50. programming, and not using macros and calls to each subroutine,  
  51. the data is processed more rapidly.   
  52.  
  53. The three most used entry points are:  1) DRIVER OUTPUT Call  
  54. that sends a byte through the driver using all the Help  
  55. functions that may be turned on, and the Punctuation routines;  
  56. 2) DIRECT OUTPUT Call that sends a byte directly to the  
  57. synthesizer, bypassing the driver and the punctuation filter;  
  58. and 3) MESSAGE OUTPUT Call that turns off the Help functions in  
  59. the driver, and still allows for punctuation filtering.  The  
  60. DIRECT OUTPUT Call will allow 8 bits to be sent, while the other  
  61. two will only allow 7 bits.   
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ENABLE READER 4.0         OPERATIONS MANUAL         CHAPTER 5-2
  71.  
  72.  
  73. It has taken three years and fourteen versions of the program to  
  74. identify speech primitives, assign hierarchy to Help Functions,  
  75. integrate Punctuation Levels, and provide the four Entry Points;  
  76. so that when you drop a byte in the top, it comes out the bottom  
  77. without using look-up tables or macros.   
  78.  
  79. The Enable Reader Driver has a Character Filter and an Ascii  
  80. Sort Routine.  The Character Filter filters out all bytes over  
  81. 80 HEX (graphics), and sends all bytes under 20 HEX (Control  
  82. characters) to the Punctuation Level Routines.  This allows no  
  83. graphic characters to pass through the driver.  It is possible  
  84. to send 8 bit bytes to the synthesizer through the DIRECT OUTPUT  
  85. call below.   
  86.  
  87.  
  88.                  TALKING TUTORIAL FUNCTION CALLS 
  89.  
  90. DRIVER OUTPUT                   FUNCTION 01 
  91.  
  92. The DRIVER OUTPUT Call will output the character in DL through  
  93. the Enable Reader driver, without turning off the Help  
  94. Functions.  It will be filtered by the Ascii sort routine in the  
  95. Enable Reader Driver, and if it is punctuation it will be sent  
  96. according to the Level of punctuation selected.   
  97.  
  98. See:  DIRECT OUTPUT to send a byte directly to the synthesizer. 
  99. See:  MESSAGE OUTPUT for sending a byte with Help Functions 
  100.       turned off. 
  101.  
  102. ENTRY CONDITIONS: 
  103.  
  104. AL=01H 
  105. AH=FEH 
  106. DL=Character To Output 
  107.  
  108.  
  109.  
  110.  
  111. DIRECT OUTPUT                   FUNCTION  02 
  112.  
  113. The DIRECT OUTPUT Call will send the byte in DL directly to the  
  114. synthesizer, bypassing the Enable Reader driver and Ascii filter  
  115. sort routine.   
  116.  
  117. ENTRY CONDITIONS: 
  118.  
  119. AL=02H 
  120. AH=FEH 
  121. DL=Character To Output 
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ENABLE READER 4.0         OPERATIONS MANUAL         CHAPTER 5-3
  137.  
  138.  
  139. MESSAGE OUTPUT                  FUNCTION  03 
  140.  
  141. The MESSAGE OUTPUT Call allows character filtration and  
  142. punctuation, but turns off the Help Functions in the driver.   
  143.  
  144. ENTRY CONDITIONS: 
  145.  
  146. AL=03H 
  147. AH=FEH 
  148. DL=Character To Output 
  149.  
  150.  
  151.  
  152.  
  153. AUTO                            FUNCTION  A 
  154.  
  155. The AUTO Call turns on or off the Spell Mode.  Read the  
  156. discussion on AUTO in Chapter 4 Section 4.2 Help Keys.   
  157.  
  158. ENTRY CONDITIONS: 
  159.  
  160. AL=41H (ASCII A) 
  161. AH=FEH 
  162.  
  163.  
  164.  
  165.  
  166. PUNCTUATION LEVELS              FUNCTION  N 
  167.  
  168. The PUNCTUATION LEVELS Call selects one of five Punctuation  
  169. Character Sets that can be accessed.  The fifth level is "Output  
  170. Punctuation", which allows all Ascii characters to be sent to  
  171. the synthesizer without being filtered or translated into the  
  172. Enable Reader 4.0 Punctuation Words.  Read the discussion on  
  173. PUNCTUATION LEVELS in Chapter 4 Section 4.2 Help Keys.   
  174.  
  175. ENTRY CONDITIONS: 
  176.  
  177. AL=4EH (ASCII N) 
  178. AH=FEH 
  179.  
  180.  
  181.  
  182.  
  183. HELP WORD LEVELS                FUNCTION  O 
  184.  
  185. The HELP Call selects one of four levels of Help in Enable  
  186. Reader 4.0.  By selecting "No Help" at the start of your  
  187. program, you can use the other Help Functions without having  
  188. them speak their prompts.  Read the discussion on HELP WORDS in  
  189. Chapter 4 Section 4.2 Help Keys.   
  190.  
  191. ENTRY CONDITIONS: 
  192.  
  193. AL=4FH (ASCII O) 
  194. AH=FEH 
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ENABLE READER 4.0         OPERATIONS MANUAL         CHAPTER 5-4
  203.  
  204.  
  205. QUIT                            FUNCTION  Q 
  206.  
  207. The QUIT Call will stop the synthesizer from speaking.  For a  
  208. discussion on the QUIT Function, read Chapter 4 Section 4.5  
  209. Command Keys.   
  210.  
  211. ENTRY CONDITIONS: 
  212.  
  213. AL=51H (ASCII Q) 
  214. AH=FEH 
  215.  
  216.  
  217.  
  218.  
  219. LETTER-TO-WORD TRANSLATOR       FUNCTION  Z 
  220.  
  221. The TRANSLATOR Call turns on or off the Letter-To-Word  
  222. Translator.  For a discussion on the TRANSLATOR Function, read  
  223. Chapter 4 Section 4.2 Help Keys.   
  224.  
  225. ENTRY CONDITIONS: 
  226.  
  227. AL=5AH (ASCII Z) 
  228. AH=FEH 
  229.  
  230.  
  231.  
  232.  
  233. UPPER CASE IDENTIFICATION       FUNCTION  T 
  234.  
  235. The UPPERCASE IDENTIFICATION Function turns on or off the  
  236. identification of capital letters.  For a discussion on the  
  237. UPCASE Function, read Chapter 4 Section 4.2 Help Keys.   
  238.  
  239. ENTRY CONDITIONS: 
  240.  
  241. AL=54H (ASCII T) 
  242. AH=FEH 
  243.  
  244.  
  245.  
  246.  
  247. VIDEO OUTPUT                    FUNCTION  V 
  248.  
  249. The VIDEO OUTPUT Call turns on or off the output to the  
  250. synthesizer from data that is printed on the video screen.  For  
  251. a discussion on the VIDEO Function, read Chapter 4 Section 4.6  
  252. System Keys.   
  253.  
  254. ENTRY CONDITIONS: 
  255.  
  256. AL=56H (ASCII V) 
  257. AH=FEH 
  258.  
  259. END OF   CHAPTER 5  TALKING TUTORIAL PROGRAMMER'S AID 
  260.  
  261.  
  262.  
  263.  
  264.