home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / s / zbkit.lbr / ZBKIT.DOC < prev    next >
Encoding:
Text File  |  1992-10-09  |  8.0 KB  |  216 lines
  1. ----------------------
  2. | ZZZZZ  BBBB   K  K | \
  3. |    Z   B   B  K K  | |  
  4. |   Z    BBBB   KK   | |  Z Blaster Kit 1.0
  5. |  Z     B   B  K K  | |  (C) 1992 Steve Goldsmith
  6. | ZZZZZ  BBBB   K  K | |  All Rights Reserved
  7. ---------------------- |
  8.  \_____________________\
  9.  
  10.  
  11. Z Blaster Kit may be copied and distributed freely providing that
  12. all files are kept intact, no fee is charged and it is not part of
  13. a package for which a charge is made.  ZBF files can be used in
  14. your own software royalty free as long as you display a message
  15. stating that you are using Z Blaster files.
  16.  
  17.  
  18. * OVERVIEW
  19.  
  20. Z Blaster Kit allows a C128 running CP/M 3.0 to record, play and
  21. import digitized sound files!  These files are called Z Blaster
  22. Files or ZBF files and have the .ZBF extension.  Included in the
  23. kit are two ZBF file players.  Z Blaster Player is command line
  24. driven and Z Blaster Mega Player is for 80 column VDC mode only. 
  25. If you were disappointed with the quality of the Covox Voice Master
  26. then dust it off and check out Z Blaster Recorder.  It creates
  27. better quality sound and has greater sampling range then the
  28. original software that came with the Voice Master!  If you have an
  29. IBM PC or other system give Z Blaster Import a try.  It will let
  30. you create ZBF files from other systems!  Programmers and Hackers
  31. should take a look at the ZBF file format.  It gives information on
  32. decoding and playing ZBF files. 
  33.  
  34.  
  35. * REQUIREMENTS
  36.  
  37. + A C128 or C128D equipped with CP/M 3.0
  38. + At least one 1541, 1541 compatible or better disk drive
  39. + 40 or 80 column monitor with sound output
  40. + Covox Voice Master in plastic enclosure (required for recording
  41.   only)
  42.  
  43.  
  44. * Z BLASTER PLAYER
  45.  
  46. Z Blaster Player ZBPLAY.COM is a command line driven ZBF file
  47. player.  To play a file:
  48.  
  49. ZBPLAY FILENAME
  50.  
  51. FILENAME = standard 1 to 8 character CP/M file name without .ZBF
  52.            extension.
  53.  
  54. ZBPLAY will load a ZBF file from the currently logged drive into
  55. memory and allow you to play it until ESCAPE is pressed.  ZBPLAY
  56. can handle up to 32640 bytes of digitized data.  ZBF files larger
  57. than 32640 bytes will play, but only the first 32640 bytes are
  58. used.
  59.  
  60. * Z BLASTER MEGA PLAYER
  61.  
  62. Z Blaster Mega Player ZBMEGA.COM allows you to play ZBF files from
  63. a file name pick list until ESCAPE is pressed.  ZBMEGA supports 80
  64. column VDC mode only.  To run:
  65.  
  66. ZBMEGA
  67.  
  68. You must be logged into the drive with the ZBF files you want to
  69. play.  Also, no command line parameters are required.
  70.  
  71. * Z BLASTER RECORDER
  72.  
  73. Z Blaster Recorder ZBREC.COM creates ZBF files on the currently
  74. logged drive without leaving CP/M!  To record a ZBF file:
  75.  
  76. ZBREC FILENAME SIZE HZ
  77.  
  78. FILENAME = standard 1 to 8 character CP/M file name without .ZBF
  79.            extension.
  80.  
  81. SIZE     = 128 to 32640 bytes.  SIZE will be rounded to the nearest
  82.            128 byte block. i.e. SIZE = (SIZE DIV 128)*128.
  83.  
  84. HZ       = 4000 to 17000 Hz sample rate.  HZ will be adjusted to
  85.            match the closest timer latch value.
  86.  
  87. You need to have a Covox Voice Master with a plastic enclosure. 
  88. The one in the aluminum enclosure will not work.  I'm not sure
  89. about the Jr..  If you get the Jr. to work drop me a line, so I can
  90. support it in future documentation releases.  ZBREC will not lock
  91. up if you don't have a Voice Master.  It will just create a silent
  92. sound file.
  93.  
  94. You may notice that when you plug the Voice Master into control
  95. port 2 that it affects the keyboard polling.  This does not occur
  96. in native 64 or 128 modes.  The only way around it is to plug the
  97. Voice Master in when ZBREC tells you to and unplug it when
  98. finished.  This can be a pain, but I was able to leave it plugged
  99. in and just delete the extra characters that pop out.  You can use
  100. the numeric key pad and ENTER since the Voice Master has no affect
  101. on the extended keys.  This should help save some retyping!
  102.  
  103. Once ZBREC is up and running you can press SPACE to record, p to
  104. play or y to save until ESCAPE is pressed.
  105.  
  106.  
  107. * Z BLASTER IMPORT
  108.  
  109. Z Blaster Import ZBIMPORT.COM is for those of you that don't have
  110. a Covox Voice Master or other means to create ZBF files.  ZBIMPORT
  111. allows you to import one bit uncompressed sound files from the
  112. currently logged drive.  To import a file:
  113.  
  114. ZBIMPORT SOURCE.EXT DEST HZ
  115.  
  116. SOURCE.EXT = standard 1 to 8 character CP/M file name with
  117.              extension.  Source file to read.
  118.  
  119. DEST       = standard 1 to 8 character CP/M file name without .ZBF
  120.              extension.  ZBF file to create.
  121.  
  122. HZ         = 4000 to 17000 Hz sample rate.  HZ will be adjusted to
  123.              match the closest timer latch value.
  124.  
  125. You may have to import a couple of times to get the Hz right. 
  126. ZBIMPORT allows you to import ANY file, so if you import a DOC file
  127. expect strange sounds.  If you are sure it is a digitized sound
  128. file make sure it is not compressed or higher resolution (i.e. 4 or
  129. 8 bit PCM).
  130.  
  131.  
  132. * WORKING WITH Z BLASTER KIT
  133.  
  134. I have included ZBF files for you to experiment with.  The ZBF
  135. files that start with HZ show the differences in quality.  I
  136. recorded my voice from 4000 Hz to 16200 Hz while using the same
  137. sample size.  Also included are various sounds recorded with a PC
  138. Sound Blaster card and 128 CP/M Z Blaster Recorder.
  139.  
  140. ZBF errors may pop up while using any of the command line driven
  141. programs.  If it is a positive value then it is a Turbo Pascal 3.1
  142. I/O error.  If it is a negative value then it is an internal error. 
  143. If you can't figure what's causing it then drop me a line.  Most of
  144. the time you will not get any errors.
  145.  
  146.  
  147. * ZBF FILE FORMAT
  148.  
  149. The ZBF file format is straight forward and flexible.  If you are
  150. a Programmer or Hacker you might want to play ZBF files in your own
  151. programs or on other computers.  The first 128 bytes of a ZBF file
  152. make up the header in the following format: 
  153.  
  154. Field    Type         Description
  155.  
  156. Version  word         ZBF version 
  157. Compress byte         Type of compression
  158. SamBits  byte         Bits per sample 
  159. Delay    word         Hardware timer value 
  160. Size     long integer Sample Size
  161. Hz       word         Sample frequency
  162. Filler   array        116 byte filler
  163.  
  164. Remember that words are arranged in Intel lo/hi order.  The current
  165. ZBF version is 0100h which stands for 01.00.  Compress is set to 0
  166. which means no compression.  Future releases may include silence
  167. encoding and other encoding schemes to reduce file size.  SamBits
  168. is set to 1 for one bit sample data.  Strings of 0s and 1s from
  169. left to right make up the sound's shape.  You can play each bit
  170. through the SID's volume control to produce the sound on the 128. 
  171. Set volume to 0 for 0 bits and 1 thru 15 for 1 bits.  Delay is
  172. hardware dependent.  Files created on the C128 will have CIA timer
  173. latch values and IBM files will have 8253 timer latch values.  It
  174. is best to calculate the latch value from Hz instead of Delay. 
  175. Size is the sample size in bytes.  On the IBM I use the whole 32
  176. bit long integer.  With the C128 I'm only using the low word which
  177. gives a maximum length of 64K.  I support up to 32K right now due
  178. to the limited memory on the 128 in CP/M mode.  Hz is the samples
  179. per second frequency.  Higher Hz values create better sound quality
  180. at a cost of more memory.  Filler is for future header expansion. 
  181. I set the filler bytes to 0 currently.
  182.  
  183. Immediately following the header is the digitized sound data.  Your
  184. program can figure how much to read from the lo word of the Size
  185. field.
  186.  
  187.  
  188. * SG TOOLS
  189.  
  190. If you like the look and feel of Z Blaster Mega Player (ZBMEGA.COM)
  191. then check out SG Tools Programmer's tool box for Turbo Pascal 2.0
  192. or higher.  To get a copy contact:
  193.  
  194. Parsec, Inc.
  195. PO Box 111
  196. Salem, MA 01970-0111
  197. (508) 745-9125
  198.  
  199. On-line on GEnie as C128.JBEE
  200.  
  201.  
  202. * PAYMENT
  203.  
  204. I would like a payment of $10.00 US currency to the address below
  205. if you use Z Blaster Kit or ZBF files.
  206.  
  207.  
  208. * HOW TO CONTACT ME
  209.  
  210. Please report any problems, suggestions, etc. to me via GEnie as
  211. S.GOLDSMITH2, voice phone (813) 925-1064 or mail to:
  212.  
  213. Steve Goldsmith
  214. 2805 Jamaica Street
  215. Sarasota, FL 34231
  216.