home *** CD-ROM | disk | FTP | other *** search
/ MORE-MultiMedia / mmultimedia.iso / cmv / cmv.doc < prev    next >
Text File  |  1992-05-18  |  13KB  |  360 lines
  1.  
  2.  
  3.  
  4.                             CALLIOPE MUSIC VISION
  5.                             -=-=-=-=-=-=-=-=-=-=-
  6.              Copyright (c) 1992 Melvin Douglas All Rights Reserved
  7.                         Single-Track Midi Music Player
  8.                                    for the
  9.                            Sound Blaster Music Card
  10.                             Version 1.02 May 1992
  11.  
  12.  
  13.  
  14.  
  15.  
  16. -----------
  17. LEGAL STUFF:
  18. -----------
  19.  
  20.     CALLIOPE MUSIC VISION software is hereafter referred to as CALLIOPE.
  21.  
  22.     Users of CALLIOPE must accept this disclaimer of warranty:
  23.  
  24.     "CALLIOPE  is  supplied as is.   The author disclaims  all  warranties,
  25.     expressed or implied, including, without limitation,  the warranties of
  26.     merchantability and of fitness for any purpose.   The author assumes no
  27.     liability for damages,  direct or consequential,  which may result from
  28.     the use of CALLIOPE."
  29.  
  30.     CALLIOPE is a "shareware program"  and is provided at no charge to  the
  31.     user  for evaluation.   Feel free to share it with your  friends,   but
  32.     please do not give it away altered or as part of another system.    The
  33.     essence  of "user-supported"  software is to provide personal  computer
  34.     users  with quality software without high prices,  and yet  to  provide
  35.     incentive for programmers to continue to develop new products.   If you
  36.     find  this  program  useful and find that you are  using  CALLIOPE  and
  37.     continue to use CALLIOPE after a 21 day trial period,  you must make  a
  38.     registration payment of $20.00 U.S Dollars.
  39.  
  40.     To register this copy, print and complete the REGISTER.FRM file
  41.     and send it along with the registration fee of $20 directly to:
  42.  
  43.                        Melvin Douglas
  44.                        Post Office Box 141
  45.                        Uniondale, New York
  46.                        11553-0141
  47.  
  48.     Adlib is a registered trademark of Adlib inc.
  49.     Sound Blaster is a registered trademark of Creative Labs Inc.
  50.     QuickBasic is a registered trademark of Microsoft Corp.
  51.  
  52.                PROGRAM FILES:
  53.                -------------
  54.                CMV.EXE       - Calliope program
  55.                CMV.DOC       - Calliope documentation
  56.                ROL2MIDI.EXE  - Conversion utility program
  57.                REGISTER.FRM  - Registration form
  58.                FILE_ID.DIZ   - BBS file description text
  59.                DESC.SDI      - BBS file description text
  60.                VENDOR.DOC    - Vendor distribution agreement   
  61.                *.MDI         - several pre-converted midi music files
  62.  
  63. Note: A music file with the extension ".ROL" is an Adlib format sound 
  64. file.  ".ROL" files may be found on almost any Bulletin Board system.
  65.  
  66. In case you don't read any further, note that you may use the "/S" 
  67. command line switch to bypass the opening screen: i.e., "CMV /S".
  68.  
  69. ------------------
  70. ABOUT THIS PROGRAM:
  71. ------------------
  72.  
  73. Thank you for trying CALLIOPE MUSIC VISION (CMV).  This program was created
  74. for use with a Sound Blaster sound board.   It will play single track  Midi
  75. compatible music files.  Included with CALLIOPE is a program (ROL2MIDI.EXE)
  76. which  allows  you  to easily convert a .ROL file into  a  Midi  compatible
  77. (.MDI) file, which is a type 0 midi.   CALLIOPE IS NOT CRIPPLED IN ANY WAY.
  78.  
  79. To convert any .ROL file to MIDI:
  80.  
  81.    C>ROL2MIDI filename /Bbankfile /Onewfile
  82.  
  83.    for example, to convert ROCKNROL.ROL to ROCKNROL.MDI using the
  84.    standard instrument bankfile:
  85.  
  86.    C>ROL2MIDI rocknrol.rol /Bstandard.bnk /Orocknrol.mdi
  87.  
  88.    Note: Case is sensitive.
  89.  
  90. The  resulting  file is the only format that CALLIOPE  will  recognize  and
  91. play.   MDI files do not require Bank (.BNK)  or instrument files once they
  92. have been converted from their .ROL format into single track Midi's.    All
  93. of  the  musical information is self contained in a  single  compact  file.
  94.  
  95. Several pre-converted files are included so that you may experience the
  96. "Sight and Sound" of CALLIOPE immediately.
  97.  
  98. ---------------------
  99. HARDWARE REQUIREMENTS:
  100. ---------------------
  101.  
  102.     o  An IBM PC/XT/AT/386/486 or true "compatible" running
  103.        MS-DOS or PC-DOS 3.0 or later.
  104.  
  105.     o  528K System Memory.
  106.  
  107.     o  CGA/EGA/VGA Video Adaptor.
  108.  
  109.     o  One floppy disk drive or hard drive.
  110.  
  111.     o  A Sound Blaster Sound board.
  112.  
  113. ----------
  114. BACKGROUND:
  115. ----------
  116.  
  117. None really, but like many of you, when I first purchased my sound board, I
  118. rediscovered all of my games which supported sound, and seemingly my PC was
  119. a whole new thing again.   Then, I became interested in the board's ability
  120. to play music (or simulate playing music).
  121.  
  122. Most of the available music players were good, but I found that I wanted to
  123. know more about the music that was playing...not just the filename and it's
  124. size.    I  also  wanted a display that was  dynamic  rather  than  static,
  125. something  that presented me with lots of information,  and I  wanted  more
  126. control of the file selection process too.
  127.  
  128. Those are some of the reasons CALLIOPE was created.   Here is a list of the
  129. features that CALLIOPE will provide.   I hope you like them well enough  to
  130. make CALLIOPE your favorite Music Player.
  131.  
  132. --------
  133. FEATURES:
  134. --------
  135.  
  136.  
  137.   File Selection Via a Popup scrolling window with mouse support, plus:
  138.   --------------------------------------------------------------------
  139.  
  140.   -  Sort files by Name, Size or Date.
  141.   -  Tag or un-tag single files or ALL files.
  142.   -  Support for 1000 files.
  143.  
  144.   A Play-Mode screen which provides the following information:
  145.   -----------------------------------------------------------
  146.  
  147.   -  The I/O port address and IRQ number location of your sound board.
  148.   -  Name of the current directory.
  149.   -  Name of the music currently playing.
  150.   -  Name of the music to be played next.
  151.   -  The elapsed time for the current music.
  152.   -  The total number of selections made.
  153.   -  The number of selections remaining to be played.
  154.   -  The number of the current selection.
  155.  
  156.   File Buffer Information:
  157.   -----------------------
  158.  
  159.   -  The current size of the buffer.
  160.   -  The byte currently being processed in the buffer (ascending).
  161.   -  The percentage of the buffer already completed.
  162.   -  The mode of the current music: Melodic or Percussive.
  163.  
  164.   A Status window to advise you of any changes:
  165.   --------------------------------------------
  166.  
  167.   -  Plus various symbols to provide an alternate measure of music duration.
  168.   -  A pointer-bar graphic across the top row for estimating the music
  169.      duration from a distance.  Admittedly, some of these are redundant,
  170.      but, so what?
  171.  
  172.   Active Play Controls as follows:
  173.   -------------------------------
  174.  
  175.   -  Pause the music.
  176.   -  Continue music from a paused state.
  177.   -  Skip the current music (immediate).
  178.   -  Cancel music play mode and return to the main menu.
  179.  
  180. -----------------
  181. CALLIOPE COMMANDS:
  182. -----------------
  183.  
  184. I  tried to make CALLIOPE as intuitive as possible so that you can  use  it
  185. "right out of the box".   However,  all software should contain at least  a
  186. brief   explanation   of   the  available  commands,   so   here   it   is:
  187.  
  188. When  CALLIOPE is first invoked,  the file selection window will popup  and
  189. search the current directory for all files with an extension of .MDI,   and
  190. will  present  a list of these files within this window.   If  no  matching
  191. files  are  found,  CALLIOPE will notify you of this via  a  popup  message
  192. window,   allowing you to return to the DOS prompt.   While the  files  are
  193. displayed,  you may scroll the window up or down to view and/or select  the
  194. files.
  195.  
  196. COMMAND LINE:  You may use the "/S" switch to bypass the opening screen:
  197.                i.e., "CMV /S".
  198.  
  199. ---------------------
  200. FILE SELECTION WINDOW:
  201. ---------------------
  202.  
  203. To activate the File Selection Window from the main menu, type Alt-M.
  204.  
  205. -------------------------------
  206. FILE (MUSIC) SELECTION COMMANDS:
  207. -------------------------------
  208.  
  209. Tag  one file at a time by pressing the right arrow key,  or <Shift>  Right
  210. Arrow key.   Unshifted,  the highlighted bar will move down one file  after
  211. each tag.   S