home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / CDMENUE2 / PLAYROL.DOC < prev    next >
Text File  |  1993-12-01  |  4KB  |  119 lines
  1.                     Adlib Command Line .ROL Player
  2.                             Version 1.2
  3.  
  4.                   (c) Copyright 1989 by Tracy Harton
  5.  
  6. Usage:
  7.  
  8.      PLAYROL ROLfile.ROL <BNKfile.BNK>
  9.      
  10.      where ROLfile.ROL is the name of the .ROL file to play and BNKfile.BNK
  11.      is the name of the .BNK file to use.  The file extensions will default
  12.      to .ROL and .BNK if omitted.  The BNKfile.BNK will default to
  13.      STANDARD.BNK if omitted.  Wildcards may be used in the ROLfile.ROL
  14.      parameter.
  15.  
  16.        Examples:
  17.  
  18.        PLAYROL Aria.ROL Standard.BNK      Plays file Aria.ROL using the bankfile
  19.        PLAYROL Aria.ROL                       Standard.BNK
  20.  
  21.        PLAYROL B*                         Plays all files beginning with B
  22.  
  23.  
  24.      PLAYROL @SCRfile.SCR
  25.  
  26.      where SCRfile.SCR is the name of the script file containing any of
  27.      the following commands:
  28.  
  29.      /R ROLfile.ROL           The name of the .ROL file to play
  30.      /B BNKfile.BNK           The name of the .BNK file [optional]
  31.      /Tn Text_Text_Text       Text to display before playing, n = 1-5
  32.      /F TXTfile.TXT           The name of the text file to display
  33.                                   before playing
  34.      /L n                     Plays n seconds of song [not implemented]
  35.  
  36.      NOTE: The /R command must be given before each of the other commands.
  37.  
  38.  
  39.        Examples:
  40.  
  41.        PLAYROL @Songs.SCR         Plays the .ROL Brahms1.ROL using the
  42.                                   bankfile STANDARD.BNK.  It display the
  43.                                   line "Brahms 1st Symphony" and then
  44.                                   display the text file, INFO.TXT.
  45.  
  46.        Songs.SCR contains:
  47.  
  48.        /R Brahms1
  49.        /B Standard.BNK
  50.        /T1 Brahm's 1st Symphony
  51.        /F INFO.TXT
  52.        /L 30
  53.  
  54.  
  55. When playing a single Song:
  56.  
  57.      Any key will abort song.
  58.  
  59. When playing multiple Songs:
  60.  
  61.      Space to skip song and go to the next one.
  62.      ESC to quit.
  63.  
  64. When playing script files:
  65.  
  66.      Space to skip to the next song or skip the text file.
  67.      ESC to quit.
  68.  
  69. History:
  70.  
  71.      Version 1.0 - The legacy of playrol began.
  72.  
  73.      Version 1.1 - Added Script files, memory allocation
  74.           checking, and correct .ROL and .BNK structure checking.
  75.  
  76.      Version 1.2 - Added this history section, version numbers as
  77.           requested, and reduced the overall memory needed a little.
  78.  
  79. Problems:
  80.  
  81.      Theoretically, if you have a slow computer, a very small Sound
  82.      Driver buffer, and a very large .ROL file consiting of small notes,
  83.      problems may arise.  If this happens, correct one or more of these
  84.      problems.
  85.  
  86.      The program now checks for correct .ROL and .BNK files.  It also
  87.      aborts if there is not enough memory to correctly load the .ROL
  88.      file.  It has been tested on an 640K XT Clone with the 12K Sound
  89.      Driver (sound b3000)
  90.  
  91.      If you bought your Adlib card a long time ago, you may not have
  92.      .BNK files.  I believe versions 1.5 and above use .BNK files.
  93.      If this is the case, Look on BBSs for the Bank Manager called
  94.      BANKMNG or perhaps call Adlib.
  95.  
  96.  
  97.  
  98.  
  99. FeedBack:
  100.  
  101.      If you have any comments, criticisms, or suggestions, I can be reached
  102.      in the Adlib conference on RelayNet (->U2U), on User-to-User (214-492-6565)
  103.      or on my BBS, Salamandria (214-238-5539)  The latest version of
  104.      Playrol can be found on the later two.
  105.  
  106.      If you feel compelled, donations are welcome!  This software is not
  107.      public domain, it's shareware.  A relaxed form of shareware that
  108.      is. You are not required to register, but it may perhaps encourage
  109.      me to write other Adlib software.  Another thing, I really need the
  110.      money and I wouldn't want you to feel guilty for not contributing.
  111.      You can contact me at one of the places above.
  112.  
  113.  
  114.                                    Tracy Harton
  115.  
  116.  
  117.  
  118.  
  119.