home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / b / bgp11.zip / READ.ME < prev    next >
Text File  |  1992-02-09  |  8KB  |  167 lines
  1.  
  2.                                BACKGROUND PLAYER
  3.                                  Version 1.1.
  4.                    (C) Copyright 1990,1992 by Alex Reshetov
  5.  
  6.           ╔════════════════════════════════════════════════════════╗
  7.           ║  Version 1.1 is shareware and may be freely copied and ║
  8.           ║  shared on a non-commercial basis.  If you  choose  to ║
  9.           ║  register ($20 fee), I will send you latest version of ║
  10.           ║  BGP with source code and updated music library.       ║
  11.           ╚════════════════════════════════════════════════════════╝
  12.  
  13.  
  14.                              Hardware requirements
  15.                              ═════════════════════
  16.  
  17.           - IBM PC/XT/AT or compatible,
  18.           - DOS 2.0 or higher.
  19.  
  20.  
  21.                                  Installation
  22.                                  ════════════
  23.  
  24.                The following files are provided:
  25.  
  26.           - READ.ME        This file.
  27.           - BGP.COM        BackGround Player version 1.1.
  28.           - MUSIC.ZIP      Description of various melodies.
  29.           - INSTALL.BAT    Batch file to uncompress MUSIC.ZIP
  30.                            (with subdirectories).
  31.  
  32.                After executing  INSTALL.BAT  directory  MUSIC will be
  33.           created.  It contains descriptions of various melodies. Run
  34.           any batch file to load and play a melody.
  35.  
  36.  
  37.                                  Introduction
  38.                                  ════════════
  39.  
  40.                BGP is a  resident  program  which  plays user-defined
  41.           melody  in background mode.  While BGP is playing music You
  42.           can use computer for anything else: editing, compiling etc.
  43.           BGP  understands  music  in  format  of  Basic  Music Macro
  44.           Language (┬m) of Microsoft Corporation. This permits You to
  45.           use   a  large  volume  of  melodies  developed  for  Basic
  46.           language.
  47.  
  48.                Resident part of BGP uses only 0.7 Kb of memory + size
  49.           of  melody  itself.  You  can unload BGP from memory at any
  50.           time. To call BGP enter from DOS prompt:
  51.  
  52.           BGP <command string>
  53.  
  54.                After that  You  can  work  as  usual:  load  editors,
  55.           compilers  etc.  And  melody  which  have been described in
  56.           <command string> will go on. To drop the melody in any time
  57.           You  may  call  BGP  without  parameters.  If  You call BGP
  58.           without parameters while there is no copy of BGP in memory,
  59.           You receive some help.
  60.  
  61.                <Command string>  is very similar to Basic Music Macro
  62.           Language with the following exceptions:
  63.           1. Instead  of  command  X<var>; to execute string variable
  64.           <var> BGP  use  command  X<file>; to  execute  melody  from
  65.           <file>.
  66.           2. With  symbols  '<'/'>'  to  lower/raise  octave  symbols
  67.           '{'/'}' is also used.  This extension is done to bypass DOS
  68.           files redirection.
  69.           3. Commands 'MB'/'MF' (music back/foreground) is absent.
  70.           4. Repetition symbol '$' is added.
  71.  
  72.           The single character commands in <command string> are:
  73.  
  74.           A-G[#,+,-] Play the note.  A "#" or  "+"  afterwards  means
  75.                      sharp  and  "-" means flat.  Sharp or flat notes
  76.                      must correspond  to  a  black  piano  keys.  The
  77.                      following notes are meaningful:
  78.                      C C# D- D D# E- E F F# G- G G# A- A A# B- B
  79.           Ln         Sets the  length of each note (n in range from 0
  80.                      to 64). The length may also follow the note when
  81.                      it is desired to change the length only for this
  82.                      note, for example: A16
  83.           M[N,L,S]   Music [Normal, Legato, Staccato]. Each note will
  84.                      play [7/8th, full, 3/4th] of the period set by L.
  85.           X<file>;   Load melody  from  <file>.  Files  may be nested
  86.                      without constrains.
  87.           {[.,:]}    Scale duration  of the previous note or pause by
  88.                      (3/2)*(# of dots), for example: A4..
  89.           [>,<,{,}]  Raise, lower] current octave.
  90.           On         Set octave n (0..6).
  91.           Nn         Play absolute note n (0..84).
  92.           Pn         Pause (1..64).
  93.           Tn         Tempo (32..255).
  94.           $          Play "forever" (loop).
  95.  
  96.                Default settings  is  O4L4T120MN,  scale  is  BAGFEDC.
  97.           Successive  calls of BGP replace melody with new one.  Call
  98.           without parameters makes music off (if any) and deletes BGP
  99.           from memory or output help screen.
  100.  
  101.                Convenient way  to produce file-like melody from Basic
  102.           program is to replace all  operators  "PLAY"  to  operators
  103.           "WRITE" to file.
  104.  
  105.                If a  program  which  have been load after BGP is also
  106.           using  dynamic  it  led   to   two   possible   situations:
  107.           interferation  of  sound  will  arise or BGP will play it's
  108.           melody soundless and resume it in full strength  after  the
  109.           program  finish  it's work.  The later is very probably for
  110.           computer games.
  111.  
  112.                BGP needs DOS version 2.0 or higher and no  less  than
  113.           40 Kb of free memory to parse command line.
  114.  
  115.  
  116.                              Music library for BGP
  117.                              ═════════════════════
  118.  
  119.                Sample melodies are contained in the  MUSIC  directory
  120.           and it's subdirectories (extracted from file MUSIC.ZIP). To
  121.           load any melody execute according batch file.
  122.  
  123.                In this version  of  BGP  music  of  Bach,  Beethoven,
  124.           Julius   Fucik,  DeBussy,  Ernesto  Lecuona,  S.Morrow  and
  125.           several unknown (for me) composers is used.  The adaptation
  126.           for  PC was performed by Michael Baum,  Con Spirito,  Carol
  127.           Hall,  Tom Sorber,  PC WORLD,  Richard Eaton, Tina Anameier
  128.           and several other programmers.
  129.  
  130.  
  131.                             DISCLAIMER AND WARRANTY
  132.                             ═══════════════════════
  133.  
  134.                This program is supplied AS IS without  any  warranty,
  135.           expressed or implied,  including but not limited to fitness
  136.           for a particular purpose.
  137.  
  138.                You may freely copy and  distribute  this  product  as
  139.           long as you abide by the following conditions:
  140.  
  141.           a) You may not charge any fee for  making  copies  or  sell
  142.              this product.
  143.           b) You may not distribute this as part of  any  product  or
  144.              service for which you charge a fee.
  145.           c) You must copy  the  product  in  its  entirety  with  no
  146.              changes.
  147.  
  148.  
  149.                                  REGISTRATION
  150.                                  ════════════
  151.  
  152.                If you find BGP useful, a registration of $20.00 would
  153.           be appreciated. For your registration, you will receive the
  154.           assembly  source  for  BGP and updated music library.  Send
  155.           check to:
  156.  
  157.           District "B"-2, 86
  158.           Troitsk, Moscow region
  159.           142092, Russia
  160.           Alexander Reshetov
  161.  
  162.    ///////////////////////////////////\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
  163.  //  Reshetov Alexander,             II  Voice : (+7 095) 334-09-79       \\
  164. ||   Russian Academy of Sciences,    II  E-mail: ar@kaon-inr.msk.su        ||
  165.  \\  Moscow                          II                                   //
  166.    \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\////////////////////////////////////
  167.