home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C128CPM / ZBKIT20.ARC / ZBKIT.DOC < prev    next >
Encoding:
Text File  |  1993-01-12  |  12.6 KB  |  311 lines
  1. ----------------------
  2. | ZZZZZ  BBBB   K  K | \
  3. |    Z   B   B  K K  | |
  4. |   Z    BBBB   KK   | |  Z Blaster Kit 2.0
  5. |  Z     B   B  K K  | |  (C) 1992, 1993 Steve Goldsmith
  6. | ZZZZZ  BBBB   K  K | |  All Rights Reserved
  7. ---------------------- |
  8.  \_____________________\
  9.  
  10.  
  11. * NOTICE
  12.  
  13. THIS IS NOT FREE SOFTWARE!  If you paid a public domain vendor or
  14. communications service for this product, you paid for the service
  15. of copying or transferring the product, and not for the product
  16. itself.  I guarantee you that nothing ever gets to the originator
  17. of this product from such a sale.  You may evaluate this product,
  18. but if you make use of it, you must register your copy.  This is a
  19. change from previous versions because very few people sent a
  20. "contribution" even though it was as little as one dollar!
  21.  
  22. I offer several incentives for you to register.  First of all,
  23. you receive the most up-to-date copy of the program that I have
  24. which is updated on a regular basis.  You also receive support for
  25. Z Blaster Kit which can be quite valuable.  Finally, you get the
  26. latest Z Blaster Mega player for point and shoot playing of ZBF
  27. files, an assortment of professionally recorded ZBF sound files
  28. and late breaking information on new developments such as the Z
  29. Blaster Developer's package not included in this evaluation
  30. package.
  31.  
  32.  
  33. * REGISTRATION INFORMATION
  34.  
  35. The non-commercial registration fee for Z Blaster Kit 2.0 is $10.00
  36. plus $3.00 for shipping in US funds.
  37.  
  38. Send a check or money order for the appropriate amount to:
  39.  
  40. Steve Goldsmith
  41. 2805 Jamaica Street
  42. Sarasota, FL 34231
  43.  
  44. Please indicate what product you are ordering and if you have a
  45. requirement for 3.5" media.  I normally ship 5.25" Commodore GCR
  46. format diskettes, but will furnish 3.5" media upon request.
  47. Customers outside of the United States and Canada should include an
  48. extra $5.00 for airmail.
  49.  
  50. If you are a registered user of this product and desire an update,
  51. please send $5.00 for handling and I will ship you an up-to-date
  52. copy.
  53.  
  54.  
  55. * DISTRIBUTION NOTICE
  56.  
  57. This is "user-supported" software.  You are hereby granted a
  58. license by Steve Goldsmith to distribute this evaluation copy of Z
  59. Blaster Kit and its documentation, subject to the following
  60. conditions:
  61.  
  62. 1.   Z Blaster Kit may be distributed freely without charge in
  63.      evaluation form only.
  64.  
  65. 2.   ZBlaster Kit may not be sold, licensed, or a fee charged for
  66.      its use.  If a fee is charged in connection with Z Blaster Kit, it
  67.      must cover the cost of copying or dissemination only.  Such charges
  68.      must be clearly identified as such by the originating party.  Under
  69.      no circumstances may the purchaser be given the impression that he
  70.      is buying Z Blaster Kit itself.
  71.  
  72. 3.   Z Blaster Kit must be presented as a complete unit, including
  73.      this documentation.   Neither Z Blaster Kit nor its documentation
  74.      may be amended or altered in any way.
  75.  
  76. 4.   By granting you the right to distribute the evaluation form of
  77.      Z Blaster Kit, you do not become the owner of Z Blaster Kit in any
  78.      form.  Any other use, distribution or representation of Z Blaster
  79.      Kit is expressly forbidden without the written consent of Steve
  80.      Goldsmith.
  81.  
  82. Commodore 128 is a trademark of Commodore Business Machines.  CP/M
  83. and CP/M 3.0 are trademarks of Digital Research.  IBM PC,  PC-XT
  84. and PC-AT are trademarks of International Business Machines.
  85. Sound Blaster is a trademark of Creative Labs, Inc.
  86.  
  87.  
  88. * OVERVIEW
  89.  
  90. Z Blaster Kit allows a C128 running CP/M 3.0 to record, play and
  91. import digitized sound files!  These files are called Z Blaster
  92. Files or ZBF files and have the .ZBF extension.  Z Blaster Player
  93. is a command line driven ZBF player.  If you were disappointed with
  94. the quality of the Covox Voice Master then dust it off and check
  95. out Z Blaster Recorder.  It creates better quality sound and has
  96. greater sampling range then the original software that came with
  97. the Voice Master!  If you have an IBM PC, other system or cannot
  98. produce your own sound files then give Z Blaster Import a try.  It
  99. will let you create ZBF files from other systems!  Programmers and
  100. Hackers should take a look at the ZBF file format.  It gives
  101. information on decoding and playing ZBF files.
  102.  
  103.  
  104. * REQUIREMENTS
  105.  
  106. + A C128 or C128D equipped with CP/M 3.0
  107. + At least one 1541, 1541 compatible or better disk drive
  108. + 40 or 80 column monitor with sound output
  109. + Covox Voice Master in plastic enclosure (required for recording
  110.   only)
  111.  
  112.  
  113. * Z BLASTER PLAYER
  114.  
  115. Z Blaster Player ZBPLAY.COM is a command line driven ZBF file
  116. player.  To play a file:
  117.  
  118. [D:]ZBPLAY [D:]FILENAME
  119.  
  120. FILENAME = standard 1 to 8 character CP/M file name without .ZBF
  121.            extension.
  122.  
  123. ZBPLAY will load a ZBF file into memory and allow you to play it
  124. until ESCAPE is pressed.  ZBPLAY can handle up to 32640 bytes of
  125. digitized data.  ZBF files larger than 32640 bytes will play, but
  126. only the first 32640 bytes are used.
  127.  
  128.  
  129. * Z BLASTER MEGA PLAYER
  130.  
  131. Z Blaster Mega Player ZBMEGA.COM allows you to play ZBF files from
  132. a file name pick list until ESCAPE is pressed.  ZBMEGA supports 80
  133. column VDC mode only.  This is included with Z Blaster Kit 1.0, but
  134. it will not play files created with Z Blaster Kit 2.0.  If you
  135. register Z Blaster Kit 2.0 then you will receive Z Blaster Mega
  136. Player 2.0 which will play 1.0 or 2.0 version ZBF files.  To run:
  137.  
  138. [D:]ZBMEGA
  139.  
  140. You must be logged into the drive with the ZBF files you want to
  141. play.  Also, no command line parameters are required.
  142.  
  143.  
  144. * Z BLASTER RECORDER
  145.  
  146. Z Blaster Recorder ZBREC.COM creates 1 bit ZBF files without
  147. leaving CP/M!  To record a ZBF file:
  148.  
  149. [D:]ZBREC [D:]FILENAME SIZE HZ
  150.  
  151. FILENAME = standard 1 to 8 character CP/M file name without .ZBF
  152.            extension.
  153.  
  154. SIZE     = 128 to 32640 bytes.  SIZE will be rounded to the nearest
  155.            128 byte block. i.e. SIZE = (SIZE DIV 128)*128.
  156.  
  157. HZ       = 4000 to 17000 Hz sample rate.  HZ will be adjusted to
  158.            match the closest timer latch value.
  159.  
  160. You need to have a Covox Voice Master with a plastic enclosure.
  161. The one in the aluminum enclosure will not work.  I'm not sure
  162. about the Jr.  If you get the Jr. to work drop me a line, so I can
  163. support it in future documentation releases.  ZBREC will not lock
  164. up if you don't have a Voice Master.  It will just create a silent
  165. sound file.
  166.  
  167. You may notice that when you plug the Voice Master into control
  168. port 2 that it affects the keyboard polling.  This does not occur
  169. in native 64 or 128 modes.  The only way around it is to plug the
  170. Voice Master in when ZBREC tells you to and unplug it when
  171. finished.  This can be a pain, but I was able to leave it plugged
  172. in and just delete the extra characters that pop out.  You can use
  173. the numeric key pad and ENTER since the Voice Master has no affect
  174. on the extended keys.  This should help save some retyping!
  175.  
  176. Once ZBREC is up and running you can press SPACE to record, P to
  177. play or Y to save until ESCAPE is pressed.
  178.  
  179.  
  180. * Z BLASTER IMPORT
  181.  
  182. Z Blaster Import ZBIMPORT.COM is for those of you that don't have
  183. a Covox Voice Master or other means to create ZBF files.  ZBIMPORT
  184. allows you to import 1, 4 and 8 bit uncompressed sound files to 1
  185. or 4 bit ZBF files.  To import a file:
  186.  
  187. [D:]ZBIMPORT [D:]SOURCE.EXT SBITS [D:]DEST DBITS HZ
  188.  
  189. SOURCE.EXT = standard 1 to 8 character CP/M file name with
  190.              extension.  Source file to read.
  191.  
  192. SBITS      = 1, 4 or 8 bit uncompressed source file.
  193.  
  194. DEST       = standard 1 to 8 character CP/M file name without .ZBF
  195.              extension.  ZBF file to create.
  196.  
  197. DBITS      = 1 or 4 bit ZBF file.
  198.  
  199. HZ         = 4000 to 17000 Hz sample rate.  HZ will be adjusted to
  200.              match the closest timer latch value.
  201.  
  202. You may have to import a couple of times to get the Hz right.
  203. ZBIMPORT allows you to import ANY file, so if you import a DOC file
  204. expect strange sounds.  If you are sure it is a digitized sound
  205. file make sure it doesn't use any form of compression.
  206.  
  207.  
  208. * WORKING WITH Z BLASTER KIT
  209.  
  210. Included are various sounds recorded with a PC Sound Blaster Pro
  211. card and 128 CP/M Z Blaster Recorder.  There are many utilities for
  212. the PC which allow you to convert sound files to various formats.
  213. I converted 8 bit Sound Blaster .VOC files to Macintosh 8 bit .SND
  214. files and used Z Blaster Import to make 4 and 1 bit ZBF files.
  215.  
  216. ZBF errors may pop up while using any of the command line driven
  217. programs.  If it is a positive value then it is a Turbo Pascal 3.1
  218. I/O error.  If it is a negative value then it is an internal error.
  219. If you can't figure what's causing it then drop me a line.  Most of
  220. the time you will not get any errors.
  221.  
  222.  
  223. * ZBF FILE FORMAT
  224.  
  225. The ZBF file format is straight forward and flexible.  If you are
  226. a Programmer or Hacker you might want to play ZBF files in your own
  227. programs or on other computers.  The first 128 bytes of a ZBF file
  228. make up the header in the following format:
  229.  
  230. Field    Type         Description
  231.  
  232. Version  word         ZBF version
  233. Compress byte         Type of compression
  234. SamBits  byte         Bits per sample
  235. Delay    word         Hardware timer value
  236. Size     long integer Sample Size
  237. Hz       word         Sample frequency
  238. Filler   array        116 byte filler
  239.  
  240. Remember that words are arranged in Intel lo/hi order.  The current
  241. ZBF version is 0200h which stands for 02.00.  Compress is set to 0
  242. which means no compression.  Future releases may include silence
  243. encoding and other encoding schemes to reduce file size.  SamBits
  244. is set to 1 or 4 for one or four bit sample data.  One bit files
  245. use strings of 0s and 1s from left to right make up the sound's
  246. shape.  You can play each bit through the SID's volume control to
  247. produce the sound on the 128.  Set volume to 0 for 0 bits and 1
  248. through 15 for 1 bits.  Four bit files hold two samples per byte.
  249. You extract the high nibble first by shifting the byte four times
  250. to the right.  Store this 4 bit value in the SID's volume control.
  251. Then and the same unmodified byte with 0fh to extract and play the
  252. second nibble.  Delay is hardware dependent.  Files created on the
  253. C128 will have CIA timer latch values and IBM created files will
  254. have 8253 timer latch values.  It is best to calculate the latch
  255. value from Hz instead of Delay.  Size is the sample size in bytes.
  256. On the IBM I use the whole 32 bit long integer.  With the C128 I'm
  257. only using the low word which gives a maximum length of 64K.  I
  258. support up to 32K right now due to the limited memory on the 128 in
  259. CP/M mode.  Hz is the samples per second frequency.  Higher Hz
  260. values create better sound quality at a cost of more memory.
  261. Filler is for future header expansion.  I set the filler bytes to
  262. 0 currently.
  263.  
  264. Immediately following the header is the digitized sound data.  Your
  265. program can figure how much to read from the lo word of the Size
  266. field.
  267.  
  268.  
  269. * HOW TO CONTACT ME
  270.  
  271. Please report any support questions (for registered users only),
  272. problems, suggestions, etc. to me via GEnie as
  273. S.GOLDSMITH2, voice phone (813) 925-1064 or mail to:
  274.  
  275. Steve Goldsmith
  276. 2805 Jamaica Street
  277. Sarasota, FL 34231
  278.  
  279.  
  280. * CHECK OUT THESE OTHER GREAT C128 CP/M FILES ON GENIE'S FLAGSHIP
  281.  
  282. ALL Libraries.
  283.  
  284.   No. File Name             Type Address      YYMMDD Bytes   Access Lib
  285. ----- ------------------------ - ------------ ------ ------- ------ ---
  286.  
  287. 10635 BLUE.ARC                 X S.GOLDSMITH2 921218   47232     19  11
  288.       Desc: CP/M VDC Arcade game! Digi sound!
  289. 10636 BLUE.LBR                 X S.GOLDSMITH2 921218   56960      9  11
  290.       Desc: Uncompressed CP/M LBR of BLUE.ARC
  291. 10693 BLUEINTU.ARC             X S.GOLDSMITH2 921225   43904     10  11
  292.       Desc: Interlace update of BLUE.ARC game!
  293. 10694 BLUEINTU.LBR             X S.GOLDSMITH2 921225   53632      7  11
  294.       Desc: Interlace update of BLUE.LBR game!
  295. 10187 IBMFONT.LBR              X S.GOLDSMITH2 921007   15104     10   9
  296.       Desc: IBM font for C128, VDC & CP/M!
  297. 10224 INTLACE.LBR              X S.GOLDSMITH2 921010   15744     17  23
  298.       Desc: Interlace 80X50 text for 128 & CP/M
  299. 10487 JOYSTICK.LBR             X S.GOLDSMITH2 921119   14848     10   9
  300.       Desc: Use joy stick in CP/M with TP source
  301. 10511 MDRAW.LBR                X S.GOLDSMITH2 921127   20736     11   9
  302.       Desc: CP/M 1351 Mouse Draw with TP source
  303. 10498 MOUSE.LBR                X S.GOLDSMITH2 921122   30464     11   9
  304.       Desc: Use 1351 mouse in CP/M with TP sourc
  305. 10088 ZBDEMO10.LBR             X S.GOLDSMITH2 920911   67072      8  22
  306.       Desc: C128 CP/M digitized music & voice!
  307. 10123 ZBKIT.LBR                X S.GOLDSMITH2 920920  111104     20  21
  308.       Desc: Make DIGITIZED sound files for 128!
  309. 10134 ZMMEDIA.LBR              X S.GOLDSMITH2 920925  155136     21  21
  310.       Desc: Multimedia for the C128, CP/M, VDC!
  311.