home *** CD-ROM | disk | FTP | other *** search
/ Sound Sensations! / sound_sensations.iso / rol / intune20 / intune.doc next >
Text File  |  1991-05-01  |  33KB  |  813 lines
  1.  
  2.  
  3.  
  4.        
  5.        
  6.                                  InTune v2.0
  7.                        An AdLib ROL File Music Player
  8.         Copyright (c) 1990,1991 by Doug Brandon - All rights reserved
  9.        
  10.        
  11.        
  12.                               Table of Contents
  13.                                        
  14.        
  15.       1.  InTune Overview  . . . . . . . . . . . . . . . . . . . .   1
  16.        
  17.       2.  System Requirements  . . . . . . . . . . . . . . . . . .   1
  18.        
  19.       3.  License and Disclaimer . . . . . . . . . . . . . . . . .   2
  20.        
  21.       4.  Registration Information . . . . . . . . . . . . . . . .   2
  22.        
  23.       5.  InTune Options . . . . . . . . . . . . . . . . . . . . .   3
  24.        
  25.       6.  AdLib SOUND.COM Driver . . . . . . . . . . . . . . . . .   5
  26.        
  27.       7.  InTune Command Line Mode . . . . . . . . . . . . . . . .   5
  28.                 Playing Songs  . . . . . . . . . . . . . . . . . .   6 
  29.                 Getting Technical Information  . . . . . . . . . .   7 
  30.        
  31.       8.  InTune Full Screen Mode  . . . . . . . . . . . . . . . .   7
  32.                 Selecting Songs  . . . . . . . . . . . . . . . . .   8 
  33.                 Marking Songs  . . . . . . . . . . . . . . . . . .   8 
  34.                 Issuing Commands . . . . . . . . . . . . . . . . .   8 
  35.                 Command Summary  . . . . . . . . . . . . . . . . .   9 
  36.                 The Play Window  . . . . . . . . . . . . . . . . .  10 
  37.        
  38.       9.  InTune Script Mode . . . . . . . . . . . . . . . . . . .  11
  39.                 Script Mode Commands . . . . . . . . . . . . . . .  11 
  40.        
  41.       10. Miscellaneous  . . . . . . . . . . . . . . . . . . . . .  13
  42.        
  43.       11. History  . . . . . . . . . . . . . . . . . . . . . . . .  13
  44.        
  45.  
  46.       1.  InTune Overview
  47.       -----------------------------------------------------------------
  48.        
  49.            InTune  is a  very versatile and  easy to  use program which
  50.       plays  AdLib ROL format music files in  a variety of ways: 1) via
  51.       command  line mode  in which songs  to play are  specified on the
  52.       command  line at the DOS  prompt, 2) via the  full screen mode in
  53.       which all files are listed on the screen and you use the keyboard
  54.       and/or  mouse to select songs to play, and 3) via the script mode
  55.       where  songs to play, and additional  commands are specified in a
  56.       file. 
  57.        
  58.            InTune  supports playing of ROL files from within compressed
  59.       PKZIP  files, saving disk space.  InTune also supports 43/50 line
  60.       display  mode on EGA/VGA displays, allowing  display of up to 240
  61.       songs  per screen.  InTune can play  songs at random, and you may
  62.       also mark multiple songs to be played in any order you desire. 
  63.        
  64.        
  65.        
  66.       2.  System Requirements 
  67.       ----------------------------------------------------------------- 
  68.        
  69.       InTune requires the following to run: 
  70.            - IBM PC or compatible with DOS 3.0 or higher 
  71.            - AdLib music synthesizer card (or equivalent) with       
  72.              SOUND.COM driver 
  73.            - 90K of free memory minimum (more depending on size of                                                                                    
  74.              instrument bank file and number/size of ROL files) 
  75.        
  76.       The following hardware is not necessary, but supported: 
  77.        
  78.            - Mouse 
  79.            - EGA/VGA display hardware 
  80.        
  81.        
  82.        
  83.        
  84.        
  85.        
  86.        
  87.        
  88.        
  89.        
  90.        
  91.        
  92.        
  93.        
  94.        
  95.        
  96.        
  97.        
  98.        
  99.        
  100.        
  101.  
  102.       
  103.                                    Page 1
  104.        
  105.       3.  License and Disclaimer
  106.       -----------------------------------------------------------------
  107.        
  108.       InTune  is  copyrighted software,  and  all rights  are reserved.
  109.       InTune  may not be changed  or modified in any  way except by the
  110.       author.
  111.        
  112.       All  warranties, whether  expressed or  implied,   are disclaimed
  113.       relating to this software.  The author will not be liable for any
  114.       type  of damage created by  the use of InTune.   The person using
  115.       the  software bears all risk as to the quality and performance of
  116.       this software.
  117.        
  118.       You are free to use, copy and distribute InTune for noncommercial
  119.       use  if: 1) The InTune distribution files are not modified in any
  120.       way,  and 2) no fee is  charged for use, copying or distribution.
  121.       Computer  user groups or clubs, or disk distributors of shareware
  122.       may  distribute InTune for a fee of $10 or less in order to cover
  123.       duplication and administrative costs.
  124.  
  125.        
  126.       4.  Registration Information
  127.       -----------------------------------------------------------------
  128.        
  129.       InTune  is distributed as a "shareware" product.  The "shareware"
  130.       concept  gives  perspective  buyers  an  opportunity  to  use and
  131.       evaluate  a software  package before  deciding whether  or not to
  132.       purchase  it.  You may use InTune freely for a ten (10) day trial
  133.       period.   After the ten day trial period expires, you should have
  134.       evaluated  this programs usefulness.   If you find InTune useful,
  135.       and  continue to use it beyond the ten day trail period, you MUST
  136.       register  it  with the  author.   Registration  ensures continued
  137.       support  and  development of  InTune, as  well as  supporting the
  138.       shareware concept.  Please support the user-supported (shareware)
  139.       concept!   You determine whether or not it will be worthwhile for
  140.       myself and other shareware authors to continue developing quality
  141.       software.
  142.        
  143.       The   one-time  InTune  registration  fee   is  $20.    The  file
  144.       REGISTER.TXT  is a  registration form  which is  distributed with
  145.       this  package.   To register your  copy of InTune,  print out the
  146.       registration form and fill it in.  Send the completed form, along
  147.       with a check for $20 made out to Doug Brandon, to:
  148.        
  149.                 Doug Brandon 
  150.                 21136 Via Santiago 
  151.                 Yorba Linda, California  92687-3421 
  152.        
  153.       This one-time registration of InTune will get you several things.
  154.       A  5.25" disk will  be supplied to you  which contains the latest
  155.       version  of the InTune files.   This disk also contains a program
  156.       named  REGTUNE.EXE  (and  instructions) which  will  register all
  157.       present,  and future versions of InTune.  You will also receive a
  158.       printed copy of the latest documentation.  Registration of InTune
  159.       also removes the delays and registration notices at the beginning
  160.       and ending of the program.
  161.  
  162.                                    Page 2
  163.        
  164.       5.  InTune Options
  165.       -----------------------------------------------------------------
  166.        
  167.            All  of the options  to used with InTune  are entered on the
  168.       command line at the DOS prompt.  The options used with InTune are
  169.       explained   in  detail  in  the  following  section,  along  with
  170.       examples. 
  171.        
  172.  
  173.            Listed below is a summary of important facts to keep in mind
  174.       while specifying InTune options. 
  175.        
  176.            - The options can be typed using either upper case or lower
  177.              case.
  178.        
  179.            - All options must be preceded by a '/' or '-' character.
  180.        
  181.            - Typing "INTUNE ?", "INTUNE /? ", or "INTUNE /H" will
  182.              display a help screen showing all options.
  183.        
  184.            - Options may appear in any order.
  185.        
  186.            - Options can NOT be combined. 
  187.        
  188.            - If no extension for an option taking a filename as a  
  189.              parameter is specified, the appropriate extension will be
  190.              automatically appended.  (.BNK for /B, and .ZIP for /Z).
  191.        
  192.        
  193.            The  following table lists all of  the InTune options, and a
  194.       brief description of each option.  A more detailed explanation of
  195.       each option is in the next section. 
  196.        
  197.            Option    Summary 
  198.            ------    -------------------------------------------------- 
  199.              /B      Specify bankfile to use instead of STANDARD.BNK 
  200.              /D      Specify an alternate directory for ROL files 
  201.              /H      Display InTune options and help screen     
  202.              /I      Display technical information on named ROL files 
  203.              /X      Use extended display in full screen mode 
  204.              /Z      Specify PKZIP file to read songs from 
  205.              /?      Same as /H
  206.       
  207.  
  208.        
  209.       /B = Specify an alternate instrument bank file
  210.        
  211.            InTune   defaults   to  using   the  instrument   bank  file
  212.       STANDARD.BNK.    This  option allows  you  to tell  InTune  use a
  213.       different  instrument bankfile.  The  name of the instrument bank
  214.       file  you wish to specify must immediately follow the "/B".  If a
  215.       filename extension is omitted, ".BNK" is automatically appended. 
  216.        
  217.       Examples: 
  218.                 "INTUNE /BSTRINGS.BNK" 
  219.                 "INTUNE /BWINDS 
  220.  
  221.                                    Page 3
  222.        
  223.       /D = Specify an alternate directory for ROL files
  224.        
  225.            InTune  defaults to looking in the current directory for the
  226.       ROL  files to  play.   This option  allows playing  of songs from
  227.       other  directories.  The directory specification must immediately
  228.       follow the "/D". 
  229.        
  230.       Examples: 
  231.                 "INTUNE /D\ADLIB\ROLS" 
  232.                 "INTUNE /DC:\ROLFILES" 
  233.                 "INTUNE /D.." 
  234.        
  235.       
  236.  
  237.       /H (and /?) = Display InTune options and help screen
  238.        
  239.            This option displays how to invoke the three different modes
  240.       of  InTune,  and  a list  of  the  various options  which  may be
  241.       specified. 
  242.        
  243.        
  244.  
  245.       /I = Display ROL technical information. 
  246.        
  247.            This  option forces  InTune to read  and display information
  248.       contained  in the specified ROL files.  The information displayed
  249.       for each ROL file includes the following: name of instrument bank
  250.       file,  number of instruments in bankfile, name of ROL file, ticks
  251.       per  beat, beats per measure, music mode, basic tempo, play time,
  252.       instruments  used, instruments  used which  are missing  from the
  253.       instrument  bank file,  and event  counts.   This option  is only
  254.       valid  when  using the  command  line mode  of  InTune (discussed
  255.       later), and is ignored otherwise. 
  256.        
  257.       Examples: 
  258.                 "INTUNE /I NEWS.ROL" 
  259.                 "INTUNE /I YANKEE" 
  260.       
  261.  
  262.        
  263.       /X = Use extended display in InTune full screen mode
  264.        
  265.            If  this option is specified, and InTune detects your system
  266.       is  equipped with an EGA or VGA  display, it will switch to 43/50
  267.       line display mode if you use InTunes full screen mode.  This mode
  268.       can  allow InTune to display up to 240 ROL filenames at once.  If
  269.       you do not have the correct hardware to support this function, an
  270.       error message is displayed.  This option is only valid when using
  271.       the  full screen mode of InTune (discussed later), and is ignored
  272.       otherwise. 
  273.        
  274.       Example: 
  275.                 "INTUNE /X" 
  276.        
  277.        
  278.        
  279.        
  280.                                    Page 4
  281.        
  282.       /Z = Specify PKZIP file to use 
  283.        
  284.            InTune  supports playing of ROL files from within compressed
  285.       PKZIP  files.  This  option allows savings of  disk space in most
  286.       cases of up to 80%.  When this option is used, all ROL files will
  287.       be  extracted  and  played  from the  specified  PKZIP  file, and
  288.       deleted  afterwards.   The  name of  the PKZIP  file to  use must
  289.       immediately follow the "/Z".  If a filename extension is omitted,
  290.       ".ZIP"  is automatically appended.   The file  PKUNZIP must be in
  291.       the DOS PATH variable in order to use this option. 
  292.        
  293.       Examples: 
  294.                 "INTUNE /ZROLS.ZIP" 
  295.                 "INTUNE /ZROLFILES" 
  296.        
  297.        
  298.        
  299.       6.  AdLib SOUND.COM Driver
  300.       -----------------------------------------------------------------
  301.        
  302.            Before   you  can   run  InTune,  the   AdLib  sound  driver
  303.       (SOUND.COM)  file  must be  loaded.   This  is a  memory resident
  304.       program  supplied by AdLib (and  also included with this package)
  305.       which  manages  the  low  level  interface  to  the  AdLib  music
  306.       synthesizer  card.  If you run InTune and the sound driver is not
  307.       installed, an error message will be displayed. 
  308.        
  309.            The  sound driver file SOUND.COM has one parameter, which is
  310.       the  size of an internal  memory buffer used by  the driver.  For
  311.       best  results, use a buffer size of 1K.  To load the sound driver
  312.       with a 1K internal buffer, type "SOUND B1000" on the command line
  313.       at the DOS prompt.  You only need to load the sound driver once. 
  314.        
  315.        
  316.       7.  InTune Command Line Mode 
  317.       ----------------------------------------------------------------- 
  318.        
  319.            The  command line mode of InTune allows you to specify which
  320.       songs  to play on the command line  at the DOS prompt.  This mode
  321.       gives  you a quick way to play the songs you want with no hassle.
  322.       It  also  allows  you to  use  InTune with  other  programs which
  323.       require  an external program to play ROL  songs.  Both of the DOS
  324.       wildcard   characters  ?   and  *  are   supported  for  filename
  325.       specification.  The option /X is ignored in the command line mode
  326.       of operation. 
  327.        
  328.        
  329.        
  330.        
  331.        
  332.        
  333.        
  334.        
  335.        
  336.        
  337.        
  338.  
  339.                                    Page 5
  340.        
  341.       Playing Songs
  342.       -------------
  343.        
  344.            To  play  songs with  the command  line  mode is  very easy.
  345.       Simply  type INTUNE followed by  the files you want  to play.  If
  346.       you  do not specify file extensions, ".ROL" with automatically be
  347.       appended to each filename.  The songs will then begin play in the
  348.       order  you specified.  While songs  are playing you may press the
  349.       space  bar to skip  the currently playing song,  or you may press
  350.       the  escape key to stop the playing  of all songs.  The following
  351.       examples show a variety of ways to play songs in the command line
  352.       mode: 
  353.        
  354.        
  355.        
  356.       Play all ROL files in the current directory 
  357.            INTUNE *   or   INTUNE *.ROL
  358.        
  359.       Play the three named ROL files in the current directory
  360.            INTUNE ZARDOZ.ROL AXEL-F STAIRWAY
  361.        
  362.       Play all ROL files beginning with the letter 'A' 
  363.            INTUNE A*   or   INTUNE A*.ROL
  364.        
  365.       Play all three letter ROL files
  366.            INTUNE ???   or   INTUNE ???.ROL
  367.        
  368.       Play all ROL files contained in the PKZIP file ROLS.ZIP 
  369.            INTUNE /ZROLS.ZIP *   or   INTUNE /ZROLS *.ROL
  370.        
  371.       Play RAIDERS.ROL from within the PKZIP file THEMES.ZIP 
  372.            INTUNE /ZTHEMES.ZIP RAIDERS.ROL
  373.        
  374.       Play the three named ROL files from various directories 
  375.            INTUNE C:\ROLS\REDBARCH ..\DARKMOON  D:\ROCK\CROWLEY.ROL
  376.        
  377.       Play all songs using an alternate instrument bank file 
  378.            INTUNE /BBIGBANK.BNK *
  379.        
  380.        
  381.        
  382.        
  383.        
  384.        
  385.        
  386.        
  387.        
  388.        
  389.        
  390.        
  391.        
  392.        
  393.        
  394.        
  395.        
  396.  
  397.        
  398.                                    Page 6
  399.        
  400.       Getting Technical Information on Songs 
  401.       -------------------------------------- 
  402.        
  403.            You  can get technical information on the specified songs by
  404.       simply adding the /I option to the command line.  The AdLib sound
  405.       driver  does  not need  to  be loaded  in  order to  perform this
  406.       operation.   The  following examples  show a  variety of  ways to
  407.       obtain technical information on songs in the command line mode: 
  408.        
  409.       Get info on all ROL files in the current directory 
  410.            INTUNE /I *   or   INTUNE /I *.ROL
  411.        
  412.       Get info on the three named ROL files in the current directory 
  413.            INTUNE /I ZARDOZ.ROL AXEL-F STAIRWAY
  414.        
  415.       Get info on all ROL files contained in the PKZIP file ROLS.ZIP 
  416.            INTUNE /I /ZROLS.ZIP *   or   INTUNE /I /ZROLS *.ROL
  417.        
  418.       Get info on RAIDERS.ROL from within the PKZIP file THEMES.ZIP 
  419.            INTUNE /I /ZTHEMES.ZIP RAIDERS.ROL
  420.        
  421.       Get info on all songs using an alternate instrument bank file 
  422.            INTUNE /I /BBIGBANK.BNK *
  423.        
  424.        
  425.        
  426.        
  427.       8.  InTune Full Screen Mode
  428.       -----------------------------------------------------------------
  429.        
  430.            The full screen mode of InTune is a user interactive mode in
  431.       which  you are presented with screens  of ROL filenames.  You use
  432.       the  keyboard and/or  mouse to  select songs  to play,  and issue
  433.       commands.  This is the most powerful and useful mode of InTune. 
  434.        
  435.            The  top line of the screen  always displays the InTune full
  436.       screen  commands.  The bottom two  lines display various items of
  437.       information  including InTune  version number,  name and  size of
  438.       currently  selected song, sound driver  version number, amount of
  439.       free memory, and the name of the PKZIP file being used (if the /z
  440.       option  was specified).   All other lines in  between are used to
  441.       display the names of songs. 
  442.        
  443.        
  444.        
  445.        
  446.        
  447.        
  448.        
  449.        
  450.        
  451.        
  452.        
  453.        
  454.        
  455.        
  456.  
  457.                                    Page 7
  458.       
  459.       Selecting Songs 
  460.       --------------- 
  461.        
  462.            Selection of songs involves positioning a highlighted cursor
  463.       over  the desired song to select or  play.  To select songs using
  464.       the keyboard, the following keys may be used: 
  465.        
  466.            - The four arrow keys may be used to move the cursor up,        
  467.              down, right or left. 
  468.            - The home key moves the cursor to the first song. 
  469.            - The end key moves the cursor to the last song. 
  470.            - The page up and page down keys move forward and backward  
  471.              through the various display screens. 
  472.            - Pressing a letter between 'A' and 'Z' moves the cursor to 
  473.              the first song beginning with that letter. 
  474.        
  475.            To  select songs using the  mouse, simply position the mouse
  476.       pointer  over the desired  song, and single  click the left mouse
  477.       button.   The  page up  and page  down keys  may be  simulated by
  478.       placing  the  mouse pointer  on either  the  right or  left arrow
  479.       characters  located on the top of  the screen and single clicking
  480.       the left mouse button (note: these arrow characters are displayed
  481.       only if a mouse is detected). 
  482.        
  483.        
  484.        
  485.       Marking Songs 
  486.       ------------- 
  487.        
  488.            You  may mark  multiple songs for  playing.  To  mark a song
  489.       using  the keyboard, position the cursor  to the song you wish to
  490.       mark,  and then press  the space bar.   To mark  a song using the
  491.       mouse,  place the mouse  pointer over the song  you wish to mark,
  492.       and  single click the  right mouse button.   If the  song was not
  493.       previously  marked, a green number  indicating the songs position
  494.       in the marked song queue will appear next to the song.  To unmark
  495.       a  song, just hit the space bar  again, or single click the right
  496.       mouse button again, the green number will disappear, and the song
  497.       will be unmarked. 
  498.        
  499.        
  500.        
  501.       Issuing Commands 
  502.       ---------------- 
  503.        
  504.            The  InTune full screen mode commands  are listed on the top
  505.       line  of the display.   Each command has  a highlighted letter in
  506.       its  name,  which  is  the  "command  letter"  for  that command.
  507.       Pressing  the  ALT  key together  with  the  highlighted "command
  508.       letter"  invokes  the command.   To  invoke  a command  using the
  509.       mouse, just place the mouse pointer over the desired command, and
  510.       single click the left mouse button. 
  511.        
  512.        
  513.        
  514.        
  515.  
  516.                                    Page 8
  517.  
  518.       Command Summary 
  519.       --------------- 
  520.            A  description  of each  command,  as well  as  the keyboard
  521.       sequence to invoke each command follows: 
  522.        
  523.       About    (ALT-A) 
  524.            Pops up a window and displays a copyright notice, and how to
  525.       contact  the author.   The  release date  of the  program is also
  526.       located in the lower right corner of this window. 
  527.        
  528.       Play     (ALT-P or <return> or double-click left mouse button) 
  529.            Begins playing songs, and pops up the play window (described
  530.       later).   If there are no songs marked, the currently highlighted
  531.       song is played, otherwise the first marked song begins playing. 
  532.        
  533.       Repeat   (ALT-R) 
  534.            This command enabled or disables the repeat mode, which only
  535.       takes  effect  when  songs are  playing.   This  command  will be
  536.       highlighted  if the repeat mode is  enabled, otherwise it will be
  537.       displayed  normally if  disabled.   If no  songs are  marked, the
  538.       currently  highlighted song will  play repeatively until stopped.
  539.       If  there are marked songs, the  entire marked song queue will be
  540.       played repeatively until stopped. 
  541.        
  542.       Shuffle  (ALT-F) 
  543.            The shuffle command continuously plays songs at random until
  544.       stopped.  A song will never be played twice in a row unless there
  545.       is only one song. 
  546.        
  547.       Clear    (ALT-C) 
  548.            The  clear command  unmarks all  songs, clearing  the marked
  549.       song queue. 
  550.        
  551.       Markall  (ALT-M) 
  552.            The  markall command marks  all songs, placing  all songs in
  553.       the  marked song queue.  If  there were already some songs marked
  554.       before  invoking the Markall command, the position of those songs
  555.       in  the marked song queue is retained, and all unmarked songs are
  556.       place in the queue after the already marked songs. 
  557.        
  558.       Info     (ALT-I) 
  559.            Displays  technical information  for the  currently selected
  560.       song.    This information  includes  the following:  name  of the
  561.       current   instrument  bank  file  being   used,  version  of  the
  562.       instrument  bank file, number  of entries used  in the instrument
  563.       bank  file, name  and version  of ROL  file, number  of ticks per
  564.       beat,  number  of beats  per  measure, music  mode,  basic tempo,
  565.       playing  time, instruments used in  the song, instruments used in
  566.       the  song which are missing from  the instrument bank file, and a
  567.       table  of event  types and counts.   Most of  this information is
  568.       useless  to the average user, but  is supplied for the people who
  569.       are experimenting with ROL files. 
  570.        
  571.       Quit     (ALT-Q) 
  572.            Immediately stops playing songs and exits to DOS. 
  573.  
  574.        
  575.                                    Page 9
  576.        
  577.       Help     (ALT-H or F1) 
  578.            Pops up the on-line help information window. 
  579.        
  580.       Arrows 
  581.            If  a mouse is detected in your system, left and right arrow
  582.       characters  are  displayed, and  may be  used  by mouse  users to
  583.       switch  between pages (same  as page up and  page down when using
  584.       the  keyboard).   These  arrows will  only appear  if a  mouse is
  585.       detected in your system. 
  586.        
  587.        
  588.       The Play Window 
  589.       --------------- 
  590.        
  591.            When  songs are played  in the InTune  full screen mode, the
  592.       play  window appears.  This window displays information about the
  593.       song   currently  being  played,  and  adds  three  song  control
  594.       commands.  The play window looks like this: 
  595.  
  596.              ╔═════════════════════════════════════════════════╗
  597.              ║                                                 ║
  598.              ║               Playing ZARDOZ.ROL                ║
  599.              ║                                                 ║
  600.              ║               Progress Indicator                ║
  601.              ║            ▐▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▌    0%        ║
  602.              ║                                                 ║
  603.              ║   Time Remaining 01:38    Time Elapsed 00:00    ║
  604.              ║                                                 ║
  605.              ║           Stop       Pause       Skip           ║
  606.              ║                                                 ║
  607.              ╚═════════════════════════════════════════════════╝
  608.  
  609.            The  top  line  of  the  window  describes  what  InTune  is
  610.       presently  doing (unzipping, loading,  playing, or deleting), and
  611.       the name of the file it is operating on.  Error messages are also
  612.       displayed  on this line.   The next line  contains three items of
  613.       information. The musical note on the left side of the window will
  614.       be red when the song is still being loaded into the sound drivers
  615.       queues,  and will change  to green when the  entire song has been
  616.       loaded.   The middle of this  line contains a "meter" which gives
  617.       you  a visual  indication of the  progress of  the song currently
  618.       being  played.  There are twenty  positions on the meter, and one
  619.       position gets lighted for every 5% of the song played.  The right
  620.       side of this line shows the percentage of the song which has been
  621.       played.  The next line displays the time remaining of the current
  622.       song,  as well as elapsed  time of the current  song.  The bottom
  623.       line  gives you the option of stopping the play of all songs, and
  624.       pausing  or skipping the  current song.   These three options are
  625.       additional   commands  which  may  be   invoked  by  command  key
  626.       sequences, or by using the mouse. 
  627.        
  628.        
  629.        
  630.        
  631.        
  632.        
  633.  
  634.                                    Page 10
  635.  
  636.       9.  InTune Script Mode
  637.       -----------------------------------------------------------------
  638.        
  639.            The  InTune script mode reads  InTune commands from an ASCII
  640.       text file.  Not only does this mode play songs, but also provides
  641.       screen  output  and  control,  as well  as  access  to  other DOS
  642.       programs.   This mode of InTune can be useful for creating simple
  643.       demonstrations. 
  644.        
  645.       Script Mode Commands 
  646.       -------------------- 
  647.        
  648.       # 
  649.        
  650.            Any  line with the # character in the first column signifies
  651.       that  the rest of the line is to  be ignored.  This is useful for
  652.       placing  commands in  your script  files.   Blank lines  are also
  653.       ignored.  Example: 
  654.        
  655.            #this line is a comment 
  656.        
  657.        
  658.       !
  659.        
  660.            Any  line with the ! character in the first column signifies
  661.       that the rest of the line is to be treated as a DOS command.  The
  662.       entire  line past the ! character is passed to COMMAND.COM and is
  663.       executed.   This is useful for shelling out to DOS to temporarily
  664.       run  other programs.  For example, it is possible to run VPIC.EXE
  665.       to display and leave a GIF picture on the screen, and play a song
  666.       at  the  same time,  or run  another  program which  modifies the
  667.       screen before playing a song.  Example: 
  668.        
  669.            !vpic /r moon.gif 
  670.        
  671.        
  672.       GOTOXY column row
  673.        
  674.            This  command places the cursor at the position specified by
  675.       the  user specified coordinates  column and row.   This is mainly
  676.       used  to  position the  cursor before  using  the SAY  command to
  677.       output text.  Example: 
  678.        
  679.            GOTOXY 1 20 
  680.        
  681.        
  682.       SAY text
  683.        
  684.            This  command outputs  the specified text.   If  there is no
  685.       text  specified with this command, a carriage return and linefeed
  686.       are output.  Example: 
  687.        
  688.            SAY Now playing "Stairway to Heaven" 
  689.            SAY 
  690.            SAY Press escape to quit 
  691.  
  692.        
  693.                                    Page 11
  694.  
  695.       CLS
  696.        
  697.            This command clears the screen.  Example:
  698.        
  699.            CLS
  700.        
  701.       COLOR foreground [ON background]
  702.        
  703.            This  command sets the attributes which  are to be used when
  704.       the SAY command is used to output text.  This command sets either
  705.       the  foreground  color,  or both  the  foreground  and background
  706.       colors.   If you  want to set both  the foreground and background
  707.       colors,  the keyword "ON"  must separate the  color names.  Valid
  708.       color  names are black, blue,  green, cyan,  red, magenta, brown,
  709.       lightgray, darkgray, lightblue, lightgreen,  lightcyan, lightred,
  710.       lightmagenta, yellow, and white.  Examples: 
  711.        
  712.            COLOR RED
  713.            COLOR WHITE ON BLUE
  714.        
  715.        
  716.       PAUSE [KEY] [seconds]
  717.        
  718.            This command either pauses InTune until a key is pressed, or
  719.       pauses for the specified number of seconds.  Examples: 
  720.        
  721.            PAUSE KEY                ;pauses until a key is pressed
  722.            PAUSE 5                  ;pauses for 5 seconds
  723.        
  724.        
  725.       PLAY rolfile
  726.        
  727.            This  command starts playing the specified song, and outputs
  728.       the  message "Playing rolfile...".   If an  extension is omitted,
  729.       ".ROL"  is automatically appended to the filename.  The space bar
  730.       may be pressed to skip the currently playing song, and the escape
  731.       key  aborts  the  script  file and  returns  to  the  DOS prompt.
  732.       Examples: 
  733.        
  734.            PLAY STAIRWAY.ROL
  735.            PLAY STAIRWAY
  736.        
  737.        
  738.       PLAYX rolfile
  739.        
  740.            This command starts playing the specified song, but does not
  741.       output  any message.   This command is intended  for the user who
  742.       wants  to output  his own  message describing  the song  which is
  743.       about  to play.   If an  extension is omitted  from the filename,
  744.       ".ROL"  is automatically appended.  The  space bar may be pressed
  745.       to skip the currently playing song, and the escape key aborts the
  746.       script file and returns to the DOS prompt.  Examples: 
  747.        
  748.            PLAYX STAIRWAY.ROL
  749.            PLAYX STAIRWAY
  750.  
  751.        
  752.                                    Page 12
  753.  
  754.       10.  Miscellaneous
  755.       -----------------------------------------------------------------
  756.        
  757.            If  you use the extended display  mode and the mouse pointer
  758.       does not go below the 25th row, get a newer version of your mouse
  759.       driver.  Earlier versions of various mouse drivers to not support
  760.       anything beyond 25 columns. 
  761.        
  762.            The  /Z  PKZIP  mode of  InTune  has only  been  tested with
  763.       PKUNZIP  versions  1.01  and 1.1,  and  may not  work  with other
  764.       versions. 
  765.        
  766.            Thanks  to Kevin Fischer, Don  Blumberg, and John Mifsud for
  767.       beta testing. 
  768.        
  769.        
  770.       InTune - Copyright (c) 1990,1991 by Doug Brandon 
  771.       All rights reserved 
  772.        
  773.        
  774.       If you have comments or suggestions for future version of InTune,
  775.       please send them to me at the following address: 
  776.        
  777.            Doug Brandon
  778.            21136 Via Santiago
  779.            Yorba Linda, CA  92687-3421
  780.        
  781.        
  782.        
  783.       I can also be reached by the following:
  784.        
  785.            Prodigy: CTJP63A
  786.        
  787.            Motown LA-BBS:      (714) 535-1319  HST 
  788.            N.S.T.T.Z:          (714) 879-4052  HST
  789.        
  790.        
  791.       11.  History
  792.       -----------------------------------------------------------------
  793.        
  794.       05/01/91 - Version 2.0 released, major revision
  795.                      * Rewritten sound routines
  796.                      * Command line mode & script mode added
  797.                      * ZIP file support added
  798.                      * Shuffle mode added
  799.                      * Multiple song queue added (marking songs)
  800.                      * Online help added
  801.                      * 43/50 line display support added
  802.                      * ROL technical information display added
  803.                      * several minor bug fixes
  804.                      * option help screen added (INTUNE /?)
  805.        
  806.       09/25/90 - Version 1.0, Initial Release
  807.        
  808.        
  809.  
  810.        
  811.                                    Page 13
  812.  
  813.