home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Sound / Player / pgp-m204.lha / MoosePlayer / MoosePlayer.doc < prev    next >
Encoding:
Text File  |  1994-12-02  |  9.0 KB  |  194 lines
  1.                             DaMoosePlayer v2.04
  2.                        A module player for the Amiga
  3.                              Written by F.Ultra
  4.                        © 1994  PGP (Organized Crime)
  5.  
  6.  
  7.                                  Copyright
  8.                                  ---------
  9. DaMoosePlayer is © F.Ultra, but is freely distributed as long as long as no
  10. more than a nominal fee for time and copying costs is charged. I assume no
  11. responsibilities for the behavior of this program (and I really mean it !!).
  12.  
  13.  
  14.                                    Files
  15.                                    -----
  16. DaMoosePlayer package should contain the following files:
  17.  
  18.                  MoosePlayer            - Program.
  19.                  MoosePlayer.doc        - This document.
  20.                  InstallLibs            - Program that installs the LIBS.
  21.                  LIBS (DIR)             - Contains the libraries.
  22.  
  23.  
  24.                                  Libraries
  25.                                  ---------
  26. These freely distributable shared libraries are included in the
  27. MoosePlayer-Package:
  28.  
  29.                  ReqTools.library    © Nico François
  30.                  Powerpacker.library © Nico François
  31.                  MedPlayer.library   © Teijo Kinnunen
  32.                  OctaPlayer.library  © Teijo Kinnunen
  33.  
  34. MoosePlayer can also use the XPK libraries, but I don't know if they are freely
  35. distributable or not, so I have not included them, and if I'd included the XPK
  36. package the MoosePlayer package would be wery large !!
  37.  
  38.  
  39.                             Fast Installation
  40.                             -----------------
  41. To install Mooseplayer, simply drag the program icon to a desired directory, or
  42. use the copy command to copy "Mooseplayer" & "Mooseplayer.info" to a desired
  43. directory, then doubleclick on the InstallLibs icon. Could it be easyer ????
  44.  
  45.  
  46.                                Installation
  47.                                ------------
  48. Mooseplayer uses the REQTOOLS.library for it's requesters so this library is
  49. vital. In addiction Mooseplayer can use either the XPK-libraries or the
  50. POWERPACKER.library in order to load'n decrunch modules that is crunched using
  51. those methods, this is however optional !!!
  52.  
  53. Mooseplayer is designed to play SOUNDTRACKER/NOISETRACKER/STARTREKKER and
  54. PROTRACKER type of modules, but if you install the MEDPLAYER.library and/or the
  55. OCTAPLAYER.library, Mooseplayer will be able to play modules made with MED &
  56. OCTAMED (using 4-8 channels !!).
  57. In order to make it easy for the user, I've included a program that installs
  58. the libraries needed to the right drawers and so on.
  59.  
  60.  
  61.                                Introduction
  62.                                ------------
  63. Da MoosePlayer is a tool for playing music_modules on the COMMODORE AMIGA
  64. computer, using 4-8 digital channels. Through history there have been many of
  65. these tools, but i think that MoosePlayer has some advantages that makes it
  66. above the average :-). And yes there are players with more functions, but they 
  67. are also alot of kb's bigger.
  68.  
  69. - Coded in 100% fast, optimized machinecode.
  70. - Small Window, uses less chip-memory.
  71. - Easy to use interface.
  72. - Low CPU usage (wery important if you want to raytrace or something !!).
  73. - Extreme fast replayroutine for the Protracker modules.
  74. - Works on all machines and configurations.
  75. - Uses CIA timers to ensure accurate speed on both PAL and NTSC machines.
  76. - Allocates the audio channels in order to prevent other programs from using
  77.   them.
  78. - MED/OCTA player.library to be able to play the latest MED modules. And by
  79.   using OctaPlayer.library you will be able to listen to all 8 channels !!
  80. - More DOS compatible than DOS itself !!!!
  81.  
  82.  
  83.                           Supported module types:
  84.                           -----------------------
  85. SoundTracker, NoiseTracker, StarTrekker, Protracker and probably most of
  86. the other tracker-type of modules. MED and OCTAMED type of modules
  87. (MMD0-MMD9) are also supported by the usage of Med/OctaPlayer.library.
  88.  
  89. Yes, I know that there's this players which supports hundreds of module types,
  90. but I prefer a player that's able to play most of the types and which is still
  91. wery low on memory usage. E.g PowerPlayer (which is the most popular player
  92. around) is able to play ALOT of types but is about 100kb in filesize,
  93. MoosePlayer is less then 9kb !!!!!!!!!!!!
  94.  
  95.  
  96.                       How to start from the WorkBench
  97.                       -------------------------------
  98. To execute the MoosePlayer, you only have to double-click on it's icon on
  99. the WorkBench-Screen. At startup MoosePlayer will open a requester that
  100. allows you to select which module you want to play. When executed from
  101. WorkBench, MoosePlayer can be configured by the usage of TOOLTYPES.
  102.  
  103.  
  104.                          How to start from the CLI
  105.                          -------------------------
  106. To execute the MoosePlayer, you have to write the name and path of MoosePlayer
  107. in a CLI-Window, e.g if you have MoosePlayer in your C: directory, you have to
  108. type: "C:MoosePlayer". At startup MoosePlayer will open a requester that allows
  109. you to select which module you want to play.
  110.  
  111.  
  112.                                 Mouse_Usage
  113.                                 -----------
  114. DaMoosePlayer is wery simple to use with the mouse, because if I'd added more
  115. functions, the window had to be larger and more chipmem would be allocated, and
  116. I don't think that there is really a need for more functions.
  117.  
  118. Load new module:    Simply press the RIGHT_MOUSE button !!
  119. Quit:            Click in the Upper-Left gadget.
  120.  
  121.  
  122.                               Keyboard_Usage
  123.                               --------------
  124. There's some more options available from the keyboard than from the mouse:
  125.  
  126. "P"        - Plays the module from the beginning.
  127. "S"        - Stops and Ejects the module. Any memory used by the module
  128.              will be freed, and the CIA-timers will be deallocated.
  129.              WARNING, this option can't be canceled !
  130. "N"        - Put's up a requester that allows you to load another module.
  131. "<RETURN>" - Does the same thing as the "N"-key.
  132. "<SPACE>"  - Pause/UnPause.
  133. "<ESCAPE>" - Quits the program and frees the module from memory.
  134.  
  135.  
  136.                                  ToolTypes
  137.                                  ---------
  138. You can configure some of the MoosePlayers functions by the usage of tooltypes.
  139. Note that tooltypes is only used if Mooseplayer is executed from workbench !!
  140. You change the tooltypes in the ICON of MoosePlayer, tooltypes surrounded by
  141. parenthesis is ignored. MoosePlayer supports the following ToolTypes:
  142.  
  143. DEFAULTDIR      Specifies the directory you want to load your
  144.                 modules from, e.g "DEFAULTDIR=dh0:music/modules" forces
  145.                 MoosePlayer to load the modules from dh0:music/modules.
  146.  
  147. PATTERN         Normally all modules have a prefix (mod.) to signify that
  148.                 the file is a module, and by default MoosePlayer only shows
  149.                 the files which begins with "mod.", but you may alter this
  150.                 yourself, e.g PATTERN=#? shows all files independent of 
  151.                 prefixes or suffixes.
  152.  
  153. DONT_ALLOCATE   This option prevents MoosePlayer from allocating the audio-
  154.                 channels. This lets other programs use them simultaneously
  155.                 (but it will probably sound awfull !!)
  156.                 Note that Med & OctaPlay.library always allocates the channels.
  157.  
  158. DONT_POPUP      By default MoosePlayer pops up a filerequester at startup,
  159.                 which enables you to choose a module to play. But I know that
  160.                 some people however don't want this to happen, so by using this
  161.                 tooltype, MoosePlayer will start silently.
  162.  
  163. XPOS            This lets you decide where the MoosePlayer window should appear
  164.                 on the screens x-axis, the default is 80.
  165.  
  166. YPOS            This lets you decide where the MoosePlayer window should appear
  167.         on the screens y-axis, the default is 35.
  168.  
  169.  
  170.                              Here We Go Again
  171.                              ----------------
  172. Mooseplayer uses a dynamic loading routine which ensures that big modules will
  173. fit in the memory even if the memory is wery fragmented, it will load the
  174. patterndata into publicmem, and the samples will be loaded to chipmem sample by
  175. sample. This is however only valid if the module is uncrunched since the XPK &
  176. POWERPACKER decrunching routines only supports decrunching into one big block.
  177. The MED/OCTAMEDPLAYER.libraries uses their own loading routines to ensure future
  178. compatibility, so I don't know how they load their stuff !!
  179.  
  180. MoosePlayer has been fully tested on ALOT of different configurations, and
  181. should work on ANY configuration available, but if there would appear any
  182. problem with your configuration let me know !
  183.  
  184. I have tested MoosePlayer with both Enforcer and Mungwall in memory, and they
  185. had nothing to complain about, so I asume that MoosePlayer is 100% safe to use
  186. in an multitasking environment !
  187.  
  188. Thanks to Mauritz "KIDNEY" Nilsson for drawing the program icon.
  189.  
  190. Watch out for other MOOSE-utilities, there will be others in the future !!!
  191.  
  192. If you got any questions, suggestions or something like that, don't hesitate
  193. to contact the author (If you can get me !!!) somewhere in Skåne, SWEDEN !!!
  194.