home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 573b.lha / SayService_v1.2 / SayService.doc.pp / SayService.doc
Text File  |  1991-10-29  |  7KB  |  163 lines
  1. Mar.31, 1991
  2. SayService v1.2
  3. by Wayde Police
  4.  
  5.   SayService, and SAY.EXE, represent my first widespread release of a public
  6. domain utility. They are released 'as-is' but I hope they work for you as well
  7. as they work for myself and my friends. This is the first of many utilities I
  8. plan to create for the bridgecards, but is the first only in the sense that I
  9. have tried to follow all the rules for utilizing the Janus library (version
  10. 2.0, but it should still work with version 1). I have written other - less
  11. than proper - bridgecard utilities (READCLK, !, SETPCTIME, and TRANSFER) in
  12. the past, but hope to finally produce some clean code - now that I am a
  13. registered developer with some proper documentation.
  14.  
  15.   If you feel this utility is useful, and saves you some time, or makes your
  16. computer system a little more operationally unified, then feel free to
  17. register yourself with me. Registration involves contacting myself at the
  18. below listed postal or usenet address. You may redistribute these files as
  19. long as all 7 files are included within the archive in an unaltered state.
  20. You may not charge any money for this redistribution, except minimal handling
  21. charges, and/or to cover the cost of the diskette ($2-$6US).
  22.  
  23.     SayService          20880
  24.     SayService.info       350
  25.     SayService.Doc       7489  (this file)
  26.     SayService.Doc.info  2565 
  27.     SAY.EXE              7840  (the PC program)
  28.     SAY.EXE.info          498
  29.     SAYTEST.TXT           458
  30.  
  31.   If you feel you can use this utility within a marketed application, you must
  32. contact me - in writing - for expressed permission. Who knows, by then I may
  33. have something far superior to this that you would rather use, or I may even
  34. be interested in doing some custom work for you! 
  35.  
  36.  
  37. Overview:
  38.  
  39.   SayService allows the PC BridgeCard to utilize the Amiga's speech synthesis
  40. capabilities. AFTER running SayService on the Amiga side, the PC will be able
  41. to speak using the SAY.EXE command. SayService can be started either by double
  42. clicking on the SayService icon from workbench, or running SayService from a
  43. CLI or SHELL. I have the command "RUN >NIL: SYS:PC/SERVICES/SayService" in my
  44. startup-sequence and never worry about it after that. I also recommend that
  45. you copy SayService and it's icon into the Services directory in your PC
  46. drawer.
  47.  
  48.   Once SayService is running on the Amiga side, any text entered by the SAY
  49. command on the PC side will be sent to the Amiga's SayService, where it will
  50. be spoken using the current speech settings. The file SAY.EXE is a DOS
  51. executable binary file, therefore you must transfer SAY.EXE to the PC side
  52. using the AREAD command on the PC. Be sure to use the /B option for AREAD,
  53. this ensures a BINARY transfer and does no file translations. Unfortunately
  54. this /B toggle is not well documented within the earlier bridgeboard manuals,
  55. but at least you know about it now!
  56.  
  57. for example ...
  58.  
  59.     C:> AREAD RAM:SAY.EXE C:\UTILS\SAY.EXE /B
  60.  
  61. Speech settings may be set 2 different ways...
  62.  
  63. CLI execution:
  64.  
  65.     At the initial CLI command, the following parameters may be entered.
  66.  
  67. RATE=[40-400]  - adjusts the playback speed
  68. VOL=[0-64]     - guess. (hint: 64 is the loudest)
  69. MODE=[0-1]     - Natural inflection (0), or Robotic (1)
  70. SEX=[0-1]      - Male (0), or Female(1)
  71. PITCH=[65-325] - change from low baritone to high soprano 
  72. FREQ=[22000]   - similar to pitch, 22000 is default
  73.  
  74. for example ...
  75.   
  76.     run >nil: SayService VOL=48 RATE=145 PITCH=135 MODE=0 SEX=0
  77.  
  78.     This only affects the STARTUP defaults of SayService.
  79.     (these examples are the program defaults)
  80.  
  81. PC DOS modification:
  82.  
  83.     This is the only way to dynamically change the speech settings after
  84. SayService has been started. Simply use the CLI parameters on the PC side.
  85. This allows you to change the current settings, and will then affect all
  86. subsequent SayService requests. You must identify the command by using the
  87. format   SAY CMD VOL=48 RATE=145 etc.
  88.  
  89.   This ^^^ identifies the reset of the line as parameter commands and the
  90. line will not be spoken. The current settings will be adjusted.
  91.  
  92.   Typing SAY ? will display the various options available to you
  93. on the PC side. You should see something similar to this ...
  94.                                                                               
  95.  SAY v1.2  (c) Wayde Police 1991                                              
  96.   usage  SAY This is the PC Bridgeboard talking!
  97.     or   SAY <textfile.txt   (speaks the file "textfile.txt")
  98.     or   SAY                 (speaks each line typed and ends with CTRL-Z)
  99.     or   SAY !               (terminates the Amiga service program)
  100.     or   SAY CMD [RATE=#] [PITCH=#] [MODE=#] [SEX=#] [VOL=#] [FREQ=#]
  101.  ( Adjusts speech parameters, and also works from within redirected files. )
  102.  ( RATE is 40 to 400, PITCH is 65 to 320, MODE=0 is natural & 1 is robotic,)  
  103.  ( SEX=0 is Male & 1 is Female, VOL is 0 to 64, FREQ default is 22200      ) 
  104.    note: SAY requires SayService to be running on the Amiga side.             
  105.  
  106.   Typing SAY alone will allow you to enter multiple lines of text with each
  107. line being spoken when you hit return. You may also modify the speech
  108. parameters as mentioned above, prefixing the line with CMD.
  109.  
  110.   It is also possible to redirect input to SAY from a text file,resulting in
  111. the file being spoken. This is done by using the standard DOS redirect symbol
  112. and would look like this ...
  113.  
  114.   SAY <C:\DOCS\READ.ME
  115.  
  116.   You can stop SAY from reading the file with CTRL-BREAK. Speech parameter
  117. settings may also be intermixed within the text file,and I have included a
  118. small sample file to demonstrate this capability. You may have more fun with
  119. this feature than any other, but be aware that having the computer read back
  120. documents to you can be a useful tool for proof reading. DOS pipes seem to
  121. work with SAY as well, although I haven't thought of any good reason to do
  122. this yet, therefore this is left as an exercise for the user. :-)
  123.  
  124.   The PC allows you to terminate the SayService task completely by typing...
  125.  
  126.   SAY !
  127.  
  128.   I would be interested to hear of any comments, suggestions, or bugs, you
  129. have about this utility. I would also like to hear about what kind of
  130. bridgecard utilities you  would like to see in the future. Some ideas I hope
  131. to pursue are ... 
  132.  
  133. 1. A new version of !  A pc keyboard emulator, very useful for sending
  134. dos prompt commands to the PC without using PCWindow. Especially useful for
  135. those using a separate screen (Hercules, EGA, VGA, etc) for their bridgecard!
  136.  
  137. 2. A FAST and tiny mono-chrome replacement for PCWindow
  138.  
  139. 3. A bridgecard diagnostics/+ program
  140.  
  141. 4. Something very special for 'special' people.
  142.     Sorry, no clues just yet! :)  
  143.  
  144. #1. and #2 of the above mentioned programs will be shareware, but the larger
  145. projects (#3 and #4) will most likely be distributed on an order-by-order
  146. basis. If you feel you would like to be registered for the shareware utilities
  147. automatically, then include at least $10US with your registration. This allows
  148. me to send you a disk with the final release versions, and reduces the
  149. financial restrictions involved with development. Registered users will also
  150. have the option of purchasing (at a substantially reduced rate) the first
  151. release versions of the larger applications, when they become available for
  152. marketing. In the here and now however, I sincerely hope you enjoy SayService!
  153.  
  154. Registration address:
  155.  
  156.     Inertial Frames
  157.     609 West 23 St.
  158.     North Vancouver, B.C.
  159.     Canada V7M 2C2
  160.  
  161.     or contact me with comments, requests, etc, via usenet at 
  162.     Wayde_Police@Mindlink.UUCP
  163.