home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / util / misc / mhsutil3.lha / MusicBox / Manual < prev    next >
Text File  |  1995-09-25  |  7KB  |  203 lines
  1.     -------------------------------------------------------------------------
  2.     INTRODUCTION
  3.     -------------------------------------------------------------------------
  4.  
  5.     Imagine having a small CD player on your screen that plays most
  6.     standard NT/PT/ST sound tracker music modules!  The player would
  7.     even allow 'dropping' the icon for your favorite song on it,
  8.     automatically loading it, then beginning playback.  'MusicBox'
  9.     does just that!  'MusicBox' is a graphical 'APPWINDOW' music
  10.     module player.
  11.  
  12.  
  13.     -------------------------------------------------------------------------
  14.     FEATURES
  15.     -------------------------------------------------------------------------
  16.  
  17.     --------------------------
  18.     Standard features include:
  19.     --------------------------
  20.     o - Multitasks.
  21.     o - Uses standard INTUITION interfaces.
  22.  
  23.  
  24.     -------------------------
  25.     Special features include:
  26.     -------------------------
  27.     o - Uses the 'SOFTCONFIG' environment.
  28.  
  29.  
  30.     --------------------------
  31.     Programs features include:
  32.     --------------------------
  33.     o - The player's window resembles a standard CD player.
  34.     o - Plays standard NT/ST/PT sound tracker music modules.
  35.     o - Playback features include: PLAY, RESTART, PAUSE, RESUME, STOP
  36.         and EJECT.
  37.     o - Uses an APPWINDOW: icons for sound tracker music modules can
  38.         be -dropped- onto the player's window to begin playback.
  39.     o - Has real time 'synthesized' elapsed time playback timer.
  40.  
  41.  
  42.  
  43.     -------------------------------------------------------------------------
  44.     USING MUSICBOX
  45.     -------------------------------------------------------------------------
  46.  
  47.     ----------------
  48.     Getting Started:
  49.     ----------------
  50.     You can start 'MusicBox' from one of the supplied icons, or from
  51.     the CLI/ Shell by using:
  52.  
  53.     >Run MusicBox
  54.  
  55.     ... if you specify the name of the music module to load, 'MusicBox'
  56.     will load (if it exists) then begin playback.
  57.  
  58.     (Please refer to the online help file for more information.)
  59.  
  60.  
  61.     --------
  62.     Options:
  63.     --------
  64.     The following options are available from the CLI/ Shell.
  65.  
  66.     -x<value> ..... Window (CD player's) X screen position.
  67.     -x<value> ..... Window (CD player's) Y screen position.
  68.  
  69.     (For information on 'TOOLTYPES' please refer to the online help file.)
  70.  
  71.  
  72.     ----------------
  73.     Pull-Down Menus:
  74.     ----------------
  75.  
  76.     Project Menu:
  77.     -------------
  78.     Load .......... Load a new NT/PT/ST music module.
  79.     About ......... Program credits & info.
  80.     Quit .......... Exit 'MusicBox'.
  81.  
  82.  
  83.     Music Menu:
  84.     -----------
  85.     Start ......... Start/ Restart music module playback.
  86.     Pause ......... Pause/ UnPause playback.
  87.     Stop .......... Stop playback.
  88.     Eject ......... Eject current NT/PT/ST music module.
  89.  
  90.  
  91.     Special Menu:
  92.     -------------
  93.     Move Player ... Move player anywhere on the screen.
  94.  
  95.  
  96.     --------------
  97.     Playing Songs:
  98.     --------------
  99.     'MusicBox' will only play NT/PT/ST type music modules or '.mod'
  100.     songs.  If a module does not play correctly, load then re-save it
  101.     using the most recent version of 'ProTracker'.  Other music formats
  102.     including MED & 3SM are not supported.
  103.  
  104.     There will only be one copy of 'MusicBox' running in memory at
  105.     at any given time.  This is due to the fact that 'MusicBox' could
  106.     allocate all four sound channels, thereby causing playback problems
  107.     if more than one copy is playing modules simultaneously.
  108.  
  109.     The Amiga has four seperate sound channels.  If 'MusicBox' is
  110.     playing a module you should not attempt to play sounds or other
  111.     music modules using other programs.  If you must use another module
  112.     player, or play a sound file, while 'MusicBox' is playing back a
  113.     module, PAUSE the current module, then when your done, RESTART it.
  114.  
  115.     You can begin module playback by:
  116.  
  117.       o - Using 'Run MusicBox <module>' from the CLI/ Shell.
  118.       o - Dragging -n- dropping the icon for a module onto the 'MusicBox'
  119.           window (CD Player).
  120.       o - Double clicking on an icon that specifies the name of a module
  121.           or uses the 'SONG=' tooltype to specify the module name.
  122.  
  123.     ... dragging -n- dropping the icon onto the CD player is the preferred
  124.     option!
  125.  
  126.     'MusicBox' does not support 'activating' multiple modules before
  127.     starting 'MusicBox' thereby create a juke-box type environment.
  128.     This feature will be supported in a future release.
  129.  
  130.  
  131.     --------
  132.     Warning:
  133.     --------
  134.     Some sound tracker music modules were created with versions of
  135.     'ProTracker' that contained a 'bug' in the save module routine.
  136.     These modules contain a odd sized data block and can cause
  137.     memory corruption if/ when loaded with 'MusicBox'.  This is also
  138.     true when loaded with other music module players!  The 'bug'
  139.     has been corrected, however, there are still many modules that
  140.     might contain this problem.  Load the music module(s) in question
  141.     using the most recent verion of 'ProTracker', then resave them.
  142.     This should alleviate the problem.  If you've got the extra time:
  143.     it's better to be safe than sorry!
  144.  
  145.  
  146.     -----------------------
  147.     Software Configuration:
  148.     -----------------------
  149.     The following variables (flags) are used:
  150.  
  151.     SCREEN TO FRONT
  152.     USE PUBLIC SCREEN
  153.  
  154.     (Please refer to the help file(s) for 'SoftConfig' for more information.)
  155.  
  156.  
  157.     -------------------------------------------------------------------------
  158.     FOR ADVANCED USERS
  159.     -------------------------------------------------------------------------
  160.  
  161.     ----------------
  162.     Playing Modules:
  163.     ----------------
  164.     You can place all your music modules in one drawer, then using
  165.     the WORKBENCH pull-down menu option "Window/Show/All Files",
  166.     produce icons for all modules within the drawer.  Now, drag
  167.     the icon for the module you want to listen to, dropping it,
  168.     onto the 'MusicBox' window (the CD player).
  169.  
  170.  
  171.     -----------
  172.     Final Note:
  173.     -----------
  174.     'FKEY' can be used to 'launch' this program via pre-determined
  175.     keystroke(s).
  176.  
  177.  
  178.     -------------------------------------------------------------------------
  179.     CREDITS
  180.     -------------------------------------------------------------------------
  181.  
  182.     This program was designed and coded by Michael Thomas Hurt  of
  183.     MIKE HURT SOFTWARE!, coded in & compiled using Blitz Basic 2.0
  184.     available from Acid Software.
  185.  
  186.     Software testing was done using:
  187.  
  188.       o - Amiga 500 : AmigaDOS 2.1, GVP HD 500+ w/ 2MEGS.
  189.  
  190.       o - Amiga 2000: AmigaDOS 2.1, Microbotics VXL030 w/MMU,
  191.           Microbotics VXLRAM 2MEGS, Microbotics 8-UP! 4MEGS,
  192.           GVP Series II hard card w/ 100MEG HD.
  193.  
  194.       o - Amiga 3000: AmigaDOS 2.1, 6MEGS.
  195.  
  196.       o - Amiga 4000: AmigaDOS 3.0
  197.  
  198.  
  199.     -------------------------------------------------------------------------
  200.     PROGRAM HISTORY
  201.     -------------------------------------------------------------------------
  202.  
  203.     v1.0    07/11/1995    Original program.