home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / mmpm2 / ssnd / readme.bcs < prev    next >
Text File  |  1993-07-21  |  9KB  |  205 lines
  1.  
  2.  
  3.                   BocaSoft System Sounds Version 1.0
  4.  
  5.                          BocaSoft Incorporated
  6.                          117 NW 43rd St.
  7.                          Boca Raton, FL 33431
  8.  
  9.  
  10. INTRODUCTION
  11. ------------
  12.  
  13. BocaSoft System Sounds allows you to attach audio to over 40 system
  14. events and any keyboard key.  Over 100 sound effects in .WAV format are
  15. included with the software.  In addition a recording capability is provided
  16. that allows you to record your own sound files in a variety of formats. 
  17.  
  18. The software has been tested under OS/2 2.0 with MMPM/2 1.0 in addition
  19. to OS/2 2.1 with MMPM/2 1.1.  All currently supported audio cards have
  20. been tested including the IBM M-AUDIO, Sound Blaster and Media Vision 
  21. Pro-Audio Spectrum.  As more cards provide support for the MMPM/2
  22. interface, BocaSoft System Sounds will automatically support them. 
  23.  
  24. DEBUGGING PROBLEMS
  25. ------------------
  26.  
  27. BocaSoft System Sounds uses the MMPM/2 subsystem to generate audio. When 
  28. attempting to debug problems with System Sounds the user should FIRST 
  29. determine if they are capable of playing digital audio from the MMPM/2 
  30. media player. If MMPM/2 can successfully play audio this assures a working
  31. hardware/software subsystem for System Sounds.
  32.  
  33. NOTES
  34. -----
  35.  
  36. 1.  Some audio cards may clip off the end of an audio file.  For example
  37.     using the Sound Blaster Pro with the recorded keystrokes may cause
  38.     the keystroke recording to be cut off.
  39.  
  40. 2.  Using audio with WinOS/2 may cause a conflict between System Sounds
  41.     and WinOS/2 for the audio card.  A small DOS program has been provided
  42.     which can be used in a DOS autoexec.bat to make System Sounds open
  43.     and close the device.  The file is located in the sstoolkt directory
  44.     and is called "SSNDDOS.COM".  Please see the readme file in that
  45.     directory for more information. 
  46.  
  47. 3.  BocaSoft System Sounds creates a named pipe which can be accessed
  48.     from any OS/2, DOS, or WinOS/2 session.  The pipe is called
  49.     "\pipe\bs_ssnd".  Any program may write an index to this pipe which 
  50.     in turn will play the associated sound.  Index values for system 
  51.     events are 0 - 49 in order of the list box.  5 user events 45 - 49 
  52.     are provided specifically for use with the named pipe.  Index values 
  53.     for keys are displayed in the key setup dialog.  Please see sstoolkt 
  54.     and sstoolkt\sspipe for more information. 
  55.  
  56. 4.  The named pipe interface can be used to instruct System Sounds to
  57.     close the audio device.  An index value of -3 opens the audio device
  58.     and a value of -2 closes the device.
  59.  
  60. 5.  An error "Device Not Ready" can be caused by multiple conflicting
  61.     audio requests.  This error should be ignored.  If the error persists
  62.     try reducing the amount of active system events. 
  63.  
  64. 6.  Record mode disables all sounds while the record dialog is on
  65.     the screen.  Dismissing this dialog will return the application
  66.     to normal operation. 
  67.  
  68. 7.  Overlapping events may not be heard.  Some system activity may 
  69.     generate multiple window messages.  System Sounds will play the 
  70.     first message received and ignore other messages while this sound
  71.     is playing.  The effect also holds true for keystrokes.  A faster
  72.     typist will be able to overrun the application and drop key sounds.
  73.  
  74. 8.  All event and key sounds files are loaded into swappable memory
  75.     for faster response.  Disabling an event will remove the associated
  76.     audio file and free memory.  Disabling the keys will remove ALL of
  77.     key sounds and free their memory.  If the same audio file is used
  78.     for multiple events only one copy of the audio data is maintained
  79.     in memory.  In light of this, users with low memory machines can
  80.     tune memory usage by using the same audio file for multiple events.
  81.     Users may also force files to be accessed from disk only by setting
  82.     the appropriate file size limit in the Memory File Size Limit field
  83.     of the System Sounds Setup dialog 
  84.  
  85. 9.  Some keys such as F1 are difficult to enter into the Key Setup
  86.     Dialog.  These keys are best entered using the scan code directly.
  87.     For example the F1 scan code is 59.  See below for a list of scan
  88.     codes.
  89.  
  90. 10. Support for all BocaSoft products is available through Compuserve.
  91.     Enter GO BOCASOFT at any ! prompt to access the BocaSoft section
  92.     of the OS/2 Vendor Forum.
  93.  
  94. KEYBOARD SCAN CODES:
  95.  
  96.  
  97. Wave File    Description        On/Off                Scan Code
  98. ---------       -----------             ------                  ---------
  99.  
  100. "ESCAPE.WAV",    "Escape",        "1",    /* ESCAPE     1 */
  101. "1.WAV",    "One",            "1",    /* ONE        2 */
  102. "2.WAV",    "Two",            "1",    /* TWO         3 */
  103. "3.WAV",    "Three",        "1",    /* THREE     4 */
  104. "4.WAV",    "Four",            "1",    /* FOUR     5 */
  105. "5.WAV",    "Five",            "1",    /* FIVE     6 */
  106. "6.WAV",    "Six",            "1",    /* SIX         7 */
  107. "7.WAV",    "Seven",        "1",    /* SEVEN    8 */
  108. "8.WAV",    "Eight",        "1",    /* EIGHT    9 */
  109. "9.WAV",    "Nine",            "1",    /* NINE        10 */
  110. "0.WAV",    "Zero",            "1",    /* ZERO        11 */
  111. "HYPHEN.WAV",    "Hyphen",        "1",    /* -        12 */
  112. "EQUAL.WAV",    "Equal",        "1",    /* =        13 */
  113. "BACKSP.WAV",    "Back Space",        "1",    /* BACKSPACE    14 */
  114. "TAB.WAV",    "Tab",            "1",    /* TAB        15 */
  115. "Q.WAV",    "Q",            "1",    /* Q        16 */
  116. "W.WAV",    "W",            "1",    /* W        17 */
  117. "E.WAV",    "E",            "1",    /* E        18 */
  118. "R.WAV",    "R",            "1",    /* R        19 */
  119. "T.WAV",    "T",            "1",    /* T        20 */
  120. "Y.WAV",    "Y",            "1",    /* Y        21 */
  121. "U.WAV",    "U",            "1",    /* U        22 */
  122. "I.WAV",    "I",            "1",    /* I        23 */
  123. "O.WAV",    "O",            "1",    /* O        24 */
  124. "P.WAV",    "P",            "1",    /* P        25 */
  125. "LEFTBRK.WAV",    "Left Bracket",        "1",    /* [        26 */
  126. "RIGHTBRK.WAV",    "Right Bracket",    "1",    /* ]        27 */
  127. "ENTER.WAV",    "Enter",        "1",    /* ENTER    28 */
  128. "CONTROL.WAV",    "Left Control",        "0",    /* Left CTL    29 */
  129. "A.WAV",    "A",            "1",    /* A        30 */
  130. "S.WAV",    "S",            "1",    /* S        31 */
  131. "D.WAV",    "D",            "1",    /* D        32 */
  132. "F.WAV",    "F",            "1",    /* F        33 */
  133. "G.WAV",    "G",            "1",    /* G        34 */
  134. "H.WAV",    "H",            "1",    /* H        35 */
  135. "J.WAV",    "J",            "1",    /* J        36 */
  136. "K.WAV",    "K",            "1",    /* K        37 */
  137. "L.WAV",    "L",            "1",    /* L        38 */
  138. "SEMICOL.WAV",    "Semicolon",        "1",    /* ;        39 */
  139. "APOSTRO.WAV",    "Apostrophe",        "1",    /* Apostraphe    40 */
  140. "GRAV.WAV",    "Grave",        "1",    /* `         41 */ 
  141. "SHIFT.WAV",    "Left Shift",        "0",    /* Shift Left    42 */
  142. "BACKSL.WAV",    "Back Slash",        "1",    /* \         43 */
  143. "Z.WAV",    "Z",            "1",    /* Z         44 */
  144. "X.WAV",    "X",            "1",    /* X         45 */
  145. "C.WAV",    "C",            "1",    /* C         46 */
  146. "V.WAV",    "V",            "1",    /* V         47 */
  147. "B.WAV",    "B",            "1",    /* B         48 */
  148. "N.WAV",    "N",            "1",    /* N         49 */
  149. "M.WAV",    "M",            "1",    /* M         50 */
  150. "COMMA.WAV",    "Comma",        "1",    /* ,         51 */
  151. "PERIOD.WAV",    "Period",        "1",    /* .         52 */
  152. "SLASH.WAV",    "Foward Slash",        "1",    /* /         53 */
  153. "SHIFT.WAV",    "Right Shift",        "0",    /* Shift Right    54 */
  154. "ASTERSK.WAV",    "Key Pad Astrck",    "0",    /* *         55 */
  155. "ALT.WAV",    "Left Alt",        "0",    /* Alt Left    56 */
  156. "SPACE.WAV",    "Space Bar",        "1",    /* Space Bar    57 */
  157. "CAPSLCK.WAV",    "Caps Lock",        "1",    /* Caps Lock     58 */
  158. "F1.WAV",    "Function Key 1",    "0",    /* F1         59 */
  159. "F2.WAV",    "Function Key 2",    "0",    /* F2         60 */
  160. "F3.WAV",    "Function Key 3",    "0",    /* F3         61 */
  161. "F4.WAV",    "Function Key 4",    "0",    /* F4         62 */
  162. "F5.WAV",    "Function Key 5",    "0",    /* F5         63 */
  163. "F6.WAV",    "Function Key 6",    "0",    /* F6         64 */
  164. "F7.WAV",    "Function Key 7",    "0",    /* F7         65 */
  165. "F8.WAV",    "Function Key 8",    "0",    /* F8         66 */
  166. "F9.WAV",    "Function Key 9",    "0",    /* F9          67 */
  167. "F10.WAV",    "Function Key 10",    "0",    /* F10         68 */
  168. "NUMLCK.WAV",    "Num Lock",        "1",    /* Num Lock    69 */
  169. "SCROLLCK.WAV",    "Scroll Lock",        "1",    /* Scroll Lock     70 */
  170. "KEYP7.WAV",    "Key Pad Seven",    "0",    /* Key Pad 7    71 */
  171. "KEYP8.WAV",    "Key Pad Eight",    "0",    /* Key Pad 8    72 */
  172. "KEYP9.WAV",    "Key Pad Nine",        "0",    /* Key Pad 9    73 */
  173. "KEYP-.WAV",    "Key Pad Minus",    "0",    /* Key Pad -    74 */
  174. "KEYP4.WAV",    "Key Pad Four",        "0",    /* Key Pad 4    75 */
  175. "KEYP5.WAV",    "Key Pad Five",        "0",    /* Key Pad 5    76 */
  176. "KEYP6.WAV",    "Key Pad Six",        "0",    /* Key Pad 6    77 */
  177. "KEYP+.WAV",    "Key Pad Plus",        "0",    /* Key Pad +    78 */
  178. "KEYP1.WAV",    "Key Pad One",        "0",    /* Key Pad 1    79 */
  179. "KEYP2.WAV",    "Key Pad Two",        "0",    /* Key Pad 2    80 */
  180. "KEYP3.WAV",    "Key Pad Three",    "0",    /* Key Pad 3    81 */
  181. "KEYP0.WAV",    "Key Pad Zero",        "0",    /* Key Pad 0    82 */
  182. "KEYPDOT.WAV",    "Key Pad Decimal",    "0",    /* Key Pad .     83 */
  183. "SYSREQ.WAV",    "SysRq",        "0",    /* System Req.     84 */
  184. "NULL.WAV",    "NULL",            "0",    /*         85 */
  185. "NULL.WAV",    "NULL",            "0",    /*         86 */
  186. "F11.WAV",    "Function Key 11",    "0",    /* F11         87 */
  187. "F12.WAV",    "Function Key 12",    "0",    /* F12         88 */
  188. "NULL.WAV",    "NULL",            "0",    /*         89 */
  189. "KEYPENT.WAV",    "Key Pad Enter",    "0",    /* Key Pad Ent.    90 */
  190. "CONTROL.WAV",    "Right Control",    "0",    /* Right Ctl    91 */
  191. "KEYPFSL.WAV",    "Key Pad B Slash",    "0",    /* Key Pad /    92 */
  192. "PRINTSCR.WAV",    "Print Screen",        "1",    /* Print Screen    93 */
  193. "ALT.WAV",    "Right Alt",        "0",    /* Alt Right    94 */
  194. "PAUSE.WAV",    "Pause",        "1",    /* Pause    95 */
  195. "HOME.WAV",    "Home",            "1",    /* Home        96 */
  196. "UP.WAV",    "Up Arrow",        "1",    /* Up Arrow     97 */
  197. "PGUP.WAV",    "Page Up",        "1",    /* Page Up    98 */
  198. "LEFT.WAV",    "Left Arrow",        "1",    /* Left Arrow     99 */
  199. "RIGHT.WAV",    "Right Arrow",        "1",    /* Right Arrow     100 */
  200. "END.WAV",    "End",            "1",    /* End         101 */
  201. "DOWN.WAV",    "Down Arrow",        "1",    /* Down Arrow    102 */
  202. "PGDOWN.WAV",    "Page Down",        "1",    /* Page Down    103 */
  203. "INSERT.WAV",    "Insert",        "1",    /* Insert    104 */
  204. "DELETE.WAV",    "Delete",        "1",    /* Delete     105 */
  205.