home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C128CPM / MMPLAY11.ARC / MMPLAY.DOC < prev    next >
Encoding:
Text File  |  1993-03-26  |  8.3 KB  |  233 lines
  1.                      @@   @@ @@@@@@@  @@@@@   @@@@@
  2.                     @@@ @@@ @@      @@      @@   @@
  3.                    @@ @ @@ @@@@    @@  @@@ @@@@@@@
  4.                   @@   @@ @@      @@   @@ @@   @@
  5.                  @@   @@ @@@@@@@  @@@@@  @@   @@
  6.  
  7.                       Mega Media Player 1.1
  8.                   (C) 1992, 1993 Steve Goldsmith
  9.                        All Rights Reserved
  10.  
  11.  
  12. * NOTICE
  13.  
  14. THIS IS NOT FREE SOFTWARE!  If you paid a public domain vendor or
  15. communications service for this product, you paid for the service
  16. of copying or transferring the product, and not for the product
  17. itself.  I guarantee you that nothing ever gets to the originator
  18. of this product from such a sale.  You may evaluate this product,
  19. but if you make use of it, you must register your copy.
  20.  
  21. I offer several incentives for you to register.  First of all,
  22. you receive the most up-to-date copy of the program that I have
  23. which is updated on a regular basis.  You also receive support for
  24. Mega Media Player which can be quite valuable.  Finally, you get an
  25. assortment of professionally recorded ZBF sound files and late
  26. breaking information on new developments such as the Z Blaster
  27. Developer's package not included in this evaluation package.
  28.  
  29.  
  30. * REGISTRATION INFORMATION
  31.  
  32. The non-commercial registration fee for Mega Media Player 1.0 is
  33. $10.00 plus $3.00 for shipping in US funds.
  34.  
  35. Send a check or money order for the appropriate amount to:
  36.  
  37. Steve Goldsmith
  38. 2805 Jamaica Street
  39. Sarasota, FL 34231
  40.  
  41. Please indicate what product you are ordering and if you have a
  42. requirement for 3.5" media.  I normally ship 5.25" Commodore GCR
  43. format diskettes, but will furnish 3.5" media upon request.
  44. Customers outside of the United States and Canada should include an
  45. extra $5.00 for airmail.
  46.  
  47. If you are a registered user of this product and desire an update,
  48. please send $6.00 for handling and I will ship you an up-to-date
  49. copy.
  50.  
  51.  
  52. * DISTRIBUTION NOTICE
  53.  
  54. This is "user-supported" software.  You are hereby granted a
  55. license by Steve Goldsmith to distribute this evaluation copy of
  56. Mega Media Player and its documentation, subject to the following
  57. conditions:
  58.  
  59. 1.   Mega Media Player may be distributed freely without charge in
  60.      evaluation form only.
  61.  
  62. 2.   Mega Media Player may not be sold, licensed, or a fee charged
  63.      for its use.  If a fee is charged in connection with Mega
  64.      Media Player, it must cover the cost of copying or
  65.      dissemination only.  Such charges must be clearly identified
  66.      as such by the originating party.  Under no circumstances may
  67.      the purchaser be given the impression that he is buying Mega
  68.      Media Player itself.
  69.  
  70. 3.   Mega Media Player must be presented as a complete unit,
  71.      including this documentation.   Neither Mega Media Player nor
  72.      its documentation may be amended or altered in any way.
  73.  
  74. 4.   By granting you the right to distribute the evaluation form of
  75.      Mega Media Player, you do not become the owner of Mega Media
  76.      Player in any form.  Any other use, distribution or
  77.      representation of Mega Media Player is expressly forbidden
  78.      without the written consent of Steve Goldsmith.
  79.  
  80. Commodore 128 is a trademark of Commodore Business Machines.  CP/M
  81. and CP/M 3.0 are trademarks of Digital Research.
  82.  
  83.  
  84. * OVERVIEW
  85.  
  86. Mega Media Player allows you to create multimedia shows on a C128
  87. running CP/M 3.0 or compatible operating system!  Mega Media Player
  88. uses a simple script file to combine graphics and digitized sound
  89. sequences into a awesome show for the eyes and ears!  Best of all
  90. you can get graphics and sound files from existing sources or you
  91. can create your own.
  92.  
  93.  
  94. * REQUIREMENTS
  95.  
  96. + A C128 or C128D running CP/M 3.0 or compatible OS
  97. + At least one 1541 or 100% compatible drive.
  98. + external amplified sound output such as a stereo is recommended
  99. + 64K VDC and 80 column monitor for viewing PCX images only
  100. + Z Blaster Kit 2.0 or later for making your own ZBF files
  101.  
  102.  
  103. * WHAT'S NEW WITH VERSION 1.1
  104.  
  105. Fixed false out of memory problem causing .ZBF files to be skipped.
  106. Now you can use all of the available heap space!
  107.  
  108. No strange video display when setting the VDC to 64K.
  109.  
  110. PCX viewer is now overlaid in MMPLAY.000.  You need to include this
  111. with MMPLAY.COM in the same drive and user.
  112.  
  113. MMPLAY.DOC with version 1.0 incorrectly stated that is was for
  114. version 2.0.  When you run MMPLAY.COM it correctly states which
  115. version it is.
  116.  
  117.  
  118. * MEGA MEDIA PLAYER
  119.  
  120. Mega Media Player MMPLAY.COM is a command line driven .MMF file
  121. player.  To play a file:
  122.  
  123. [D:]MMPLAY [D:]FILENAME
  124.  
  125. FILENAME = standard 1 to 8 character CP/M file name without .MMF
  126.            extension.
  127.  
  128. MMPLAY will play a Multi Media File (.MMF) you create with your
  129. favorite text file editor or word processor.  Some error recovery
  130. is automatic, but there are fatal errors which will be reported
  131. after processing the .MMF file is complete.
  132.  
  133.  
  134. * MMF FILE FORMAT
  135.  
  136. The .MMF file format is straight forward and flexible.  What
  137. follows is a sample .MMF file.
  138.  
  139. ;This is a comment.  Blank lines are allowed too!
  140.  
  141. Chain chainfil  ;chain will execute chainfil.mmf after playing
  142.                 ;zbf sequences
  143.  
  144. ViewPCX pcxfile ;viewpcx will view 1 bit pcx file pcxfile.pcx
  145.                 ;before playing sound sequences
  146.  
  147. LoadZBF         ;load zbf files file1, file2 and file3 into memory
  148.  
  149.   file1 file2 file3
  150.  
  151. End            ;end of load block
  152.  
  153. PlayZBF        ;play zbf sequences
  154.  
  155.   file1 file1 file1
  156.   file2 file2 file2
  157.   file3 file3 file3
  158.  
  159. End            ;end of play block
  160.  
  161.  
  162. * MMF COMMANDS
  163.  
  164. MMPLAY reads a .MMF line, strips comments and converts it to upper
  165. case, so .MMF text is not case sensitive.  The first pass on the
  166. .MMF file is used to collect information about how many files and
  167. sequences to process.  The second pass processes the commands if
  168. the .MMF completes the first pass without any errors.  Below is a
  169. detailed description of each command.
  170.  
  171. CHAIN FILENAME
  172.  
  173. CHAIN (not required) is used to allow you to run multiple .MMF
  174. files in sequence.  FILENAME is the .MMF file you want to run next.
  175. Do not use the .MMF extension because it is added automatically.
  176.  
  177. VIEWPCX FILENAME
  178.  
  179. VIEWPCX (not required) displays a 1 bit .PCX file on the VDC screen
  180. before .ZBF files are loaded and played.  FILENAME is the .PCX file
  181. you want to display.  Do not use the .PCX extension because it is
  182. added automatically.  
  183.  
  184. If the .PCX is greater than 640 X 200 then only the top left 640 X
  185. 200 is displayed.  If a error occurs such as file not found then
  186. VIEWPCX is skipped, no image is displayed and processing resumes. 
  187. A 64K VDC and 80 column monitor is required to use VIEWPCX.  If the
  188. VDC is not set for 64K then MMPLAY moves the character sets to a
  189. buffer, sets the VDC to use 64K and restores the character sets.
  190.  
  191. LOADZBF FILENAME END
  192.  
  193. LOADZBF (required) loads the .ZBF file(s) you want to play. 
  194. FILENAME is the .ZBF to load.  Multiple file names are separated by
  195. at least one space (FILE1 FILE2 FILE3 ...).  END (required) tells
  196. MMPLAY that there are no more files to load.  Do not use the .ZBF
  197. extension because it is added automatically.
  198.  
  199. You are limited to about a 36K work area, so keep an eye on the
  200. size of the .ZBFs.  If there is not enough memory to hold the .ZBF
  201. then it is skipped.
  202.  
  203. PLAYZBF FILENAME END
  204.  
  205. PLAYZBF (required) plays the .ZBF files loaded in memory.  FILENAME
  206. is the .ZBF to play.  Multiple file names are separated by at least
  207. one space (FILE1 FILE2 FILE3 ...).  END (required) tells MMPLAY
  208. that there are no more files to play.  Do not use the .ZBF
  209. extension because it is added automatically.
  210.  
  211. REST FILENAME
  212.  
  213. REST (not required) is used inside a PLAYZBF block to silence the
  214. SID for the duration of FILENAME.  The first file in the LOADZBF
  215. block cannot be RESTed.  Do not use the .ZBF extension because it
  216. is added automatically.
  217.  
  218. Each PlayZBF sequence is assigned a two byte index that points to
  219. the .ZBF in memory.  REST causes a negative index to be stored.
  220. There must be enough memory to hold all the .ZBFs and two byte
  221. indexes in memory at the same time.
  222.  
  223.  
  224. * HOW TO CONTACT ME
  225.  
  226. Please report any support questions (for registered users only),
  227. problems, suggestions, etc. to me via GEnie as
  228. S.GOLDSMITH2, voice phone (813) 925-1064 or mail to:
  229.  
  230. Steve Goldsmith
  231. 2805 Jamaica Street
  232. Sarasota, FL 34231
  233.