home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C128CPM / MMPLAY.ARC / MMPLAY.DOC < prev    next >
Encoding:
Text File  |  1993-03-16  |  7.9 KB  |  219 lines
  1.                      @@   @@ @@@@@@@  @@@@@   @@@@@
  2.                     @@@ @@@ @@      @@      @@   @@
  3.                    @@ @ @@ @@@@    @@  @@@ @@@@@@@
  4.                   @@   @@ @@      @@   @@ @@   @@
  5.                  @@   @@ @@@@@@@  @@@@@  @@   @@
  6.  
  7.                       Mega Media Player 2.0
  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, 1541 compatible or better disk drive
  98. + external amplified sound output such as a stereo is recommended 
  99. + 64K VDC and 80 column monitor for viewing PCX images
  100. + Z Blaster Kit 2.0 or later for making your own ZBF files
  101.  
  102.  
  103. * MEGA MEDIA PLAYER
  104.  
  105. Mega Media Player MMPLAY.COM is a command line driven MMF file
  106. player.  To play a file:
  107.  
  108. [D:]MMPLAY [D:]FILENAME
  109.  
  110. FILENAME = standard 1 to 8 character CP/M file name without .MMF
  111.            extension.
  112.  
  113. MMPLAY will play a Multi Media File (.MMF) you create with your
  114. favorite text file editor or word processor.  Some error recovery
  115. is automatic, but there are fatal errors which will be reported
  116. after processing the .MMF file is complete.
  117.  
  118.  
  119. * MMF FILE FORMAT
  120.  
  121. The .MMF file format is straight forward and flexible.  What
  122. follows is a sample .MMF file.
  123.  
  124. ;This is a comment.  Blank lines are allowed too!
  125.  
  126. Chain chainfil  ;chain will execute chainfil.mmf after playing
  127.                 ;zbf sequences
  128.  
  129. ViewPCX pcxfile ;viewpcx will view 1 bit pcx file pcxfile.pcx
  130.                 ;before playing sound sequences
  131.  
  132. LoadZBF         ;load zbf files file1, file2 and file3 into memory
  133.  
  134.   file1 file2 file3
  135.  
  136. End            ;end of load block
  137.  
  138. PlayZBF        ;play zbf sequences
  139.  
  140.   file1 file1 file1
  141.   file2 file2 file2
  142.   file3 file3 file3
  143.  
  144. End            ;end of play block
  145.  
  146.  
  147. * MMF COMMANDS
  148.  
  149. MMPLAY reads a .MMF line, strips comments and converts it to upper
  150. case, so .MMF text is not case sensitive.  The first pass on the
  151. .MMF file is used to collect information about how many files and
  152. sequences to process.  The second pass processes the commands if
  153. the .MMF completes the first pass without any errors.  Below is a
  154. detailed description of each command.
  155.  
  156. CHAIN FILENAME
  157.  
  158. CHAIN (not required) is used to allow you to run multiple .MMF
  159. files in sequence.  FILENAME is the .MMF file you want to run next. 
  160. Do not use the .MMF extension because it is added automatically.
  161.  
  162. VIEWPCX FILENAME
  163.  
  164. VIEWPCX (not required) displays a 1 bit .PCX file on the VDC screen
  165. before .ZBF files are loaded and played.  FILENAME is the .PCX file
  166. you want to display.  Do not use the .PCX extension because it is
  167. added automatically.  
  168.  
  169. If the .PCX is greater than 640 X 200 then only the top left 640 X
  170. 200 is displayed.  If a error occurs such as file not found then
  171. VIEWPCX is skipped, no image is displayed and processing resumes. 
  172. A 64K VDC and 80 column monitor is required to use VIEWPCX.  If the
  173. VDC is not set for 64K then MMPLAY moves the character sets to a
  174. buffer, sets the VDC to use 64K and restores the character sets. 
  175. This might make a strange screen for a brief moment.
  176.  
  177. LOADZBF FILENAME END
  178.  
  179. LOADZBF (required) loads the .ZBF file(s) you want to play. 
  180. FILENAME is the .ZBF to load.  Multiple file names are separated by
  181. at least one space (FILE1 FILE2 FILE3 ...).  END (required) tells
  182. MMPLAY that there are no more files to load.  Do not use the .ZBF
  183. extension because it is added automatically.
  184.  
  185. You are limited to about a 37K work area, so keep an eye on the
  186. size of the .ZBFs.  If there is not enough memory to hold the .ZBF
  187. then it is skipped.
  188.  
  189. PLAYZBF FILENAME END
  190.  
  191. PLAYZBF (required) plays the .ZBF files loaded in memory.  FILENAME
  192. is the .ZBF to play.  Multiple file names are separated by at least
  193. one space (FILE1 FILE2 FILE3 ...).  END (required) tells MMPLAY
  194. that there are no more files to play.  Do not use the .ZBF
  195. extension because it is added automatically.
  196.  
  197. REST FILENAME
  198.  
  199. REST (not required) is used inside a PLAYZBF block to silence the
  200. SID for the duration of FILENAME.  The first file in the LOADZBF
  201. block cannot be RESTed.  Do not use the .ZBF extension because it
  202. is added automatically.
  203.  
  204. Each file is converted to a two byte index that points to the .ZBF
  205. in memory.  REST causes the negative index to be stored.  There
  206. must be enough memory to hold all the .ZBFs and two byte indexes in
  207. memory at the same time.
  208.  
  209.  
  210. * HOW TO CONTACT ME
  211.  
  212. Please report any support questions (for registered users only),
  213. problems, suggestions, etc. to me via GEnie as
  214. S.GOLDSMITH2, voice phone (813) 925-1064 or mail to:
  215.  
  216. Steve Goldsmith
  217. 2805 Jamaica Street
  218. Sarasota, FL 34231
  219.