home *** CD-ROM | disk | FTP | other *** search
/ Bila Vrana / BILA_VRANA.iso / 031A / MELODY26.ZIP / MELODY26.EXE / TECH.DOC < prev   
Text File  |  1996-01-09  |  8KB  |  192 lines
  1.  
  2.       
  3.       
  4.                      M E L O D Y    M A S T E R
  5.                             Version 2.6
  6.       
  7.       
  8.       
  9.                   =================================
  10.                        P r o g r a m m e r s'
  11.                   M u s i c   S u p p o r t   K i t
  12.                   =================================
  13.  
  14.  
  15.  
  16.                 Copyright 1991-96 by Alexei A. Efros
  17.                          All Rights Reserved.
  18.       
  19.       
  20.  
  21.  
  22.     INTRODUCTION
  23.       
  24.  
  25.         When Melody Master was conceived, the idea was to  develop 
  26.       a utility that would  help  programmers  use  the  IBM  PC's 
  27.       internal speaker to add music  to  their  programs.   Melody 
  28.       Master can hardly be called a "utility", but  the  goal  has 
  29.       been reached. Melody Master  helps  to  create  music  using 
  30.       standard notation on a musical staff.   The  output  can  be 
  31.       saved in any of 16 different  music  formats!   The  program 
  32.       does not require music-writing expertise.  Over 140 melodies 
  33.       are included.
  34.  
  35.  
  36.     HOW TO GENERATE MUSIC
  37.  
  38.  
  39.       To generate music with Melody Master, load  (or  enter)  the 
  40.       tune you  want  to  use.   Select  tempo  and  style  (since 
  41.       currently Melody Master  cannot  output  any  of  the  Sound 
  42.       Blaster file formats the Instrument setting does not  effect 
  43.       anything).  Press F7 and choose the format you wish to  use.  
  44.       Melody Master will  create  a  music  file  in  the  current 
  45.       directory.  The file will have the same  name  as  the  tune 
  46.       that was loaded plus an extension (.pas, .bas, .dat, and  so 
  47.       on).  The file may now be copied into any other program. 
  48.  
  49.       If the music is not completely satisfying  the  first  time, 
  50.       return to Melody Master  and  change  some  of  the  musical 
  51.       parameters  such  as  tempos,  styles,  and  octaves.   Some 
  52.       formats cannot play very high notes; it may  be  helpful  to 
  53.       move everything down  one  octave.  (Use  F9,  Miscellaneous 
  54.       Utilities and the "8 down" command.) 
  55.  
  56.       NOTE: To  use  Melody  Master  output  files  in  for-profit 
  57.       software, a Commercial License is required.      
  58.  
  59.  
  60.     MUSIC FORMATS OVERVIEW
  61.  
  62.       
  63.       The following chart contains a comparison of the music formats
  64.       available with Melody Master.  Formats are compared by quality
  65.       of music, size if executable, and the applications required.
  66.  
  67.  
  68.  
  69.       Name      |Quality|  Size | Application(s)
  70.  
  71.       ================================================================
  72.  
  73.       TP Proc.  | great | worst | Turbo Pascal 4.0+
  74.       ----------------------------------------------------------------
  75.       TP Array  | great | good  | Turbo Pascal 4.0+ and PLARRAY.PAS**
  76.       ----------------------------------------------------------------
  77.       TP B.G.   | avg.# | great | Turbo Pascal 4.0+ and SOUNDER.PAS**
  78.       ----------------------------------------------------------------
  79.       TP Play   | good  | great | Turbo Pascal 4.0+ and MUSIC.PAS**
  80.       ----------------------------------------------------------------
  81.       C B.G.    |great #| good  | C, PLAYBG.C** and SOUNDSYS.C**
  82.       ----------------------------------------------------------------
  83.       Turbo C   | great | poor  | Turbo C/Borland C++
  84.       ----------------------------------------------------------------
  85.       BASIC     | good #| great | GW-BASIC,QBASIC,QuickBASIC, etc.
  86.       ----------------------------------------------------------------
  87.       Data File | great | avg.  | PLAY.EXE**
  88.       ----------------------------------------------------------------
  89.       ANSI      | good  | great | QModem*,ANSIplay*,A_TYPE*,etc...
  90.       ----------------------------------------------------------------
  91.       ASCII     | good  | best! | VMUSIC*, POLY*, etc.
  92.       ----------------------------------------------------------------
  93.       Norton BE | poor  | poor  | Norton Utilities 4.5
  94.       ----------------------------------------------------------------
  95.       DRVSPKR   | great#| good  | DRVSPKR.SYS**
  96.       ----------------------------------------------------------------
  97.       PianoMan 3| good  | great | PIANOMAN 3.0*
  98.       ----------------------------------------------------------------
  99.       PianoMan 4| good  | great | PIANOMAN 4.0*
  100.       ----------------------------------------------------------------
  101.       4DOS/NDOS | aver. | good  | 4DOS* / NDOS from UN 6.0+
  102.       ================================================================
  103.  
  104.       #  - Plays music in background.
  105.       *  - Available as Shareware or Public Domain
  106.       ** - File is included in the Melody Master package.
  107.       
  108.  
  109.  
  110.     MUSIC FORMATS
  111.                                                                
  112.       
  113.       "TP Proc." - Turbo Pascal procedure.  Can be called from your
  114.       program. Requires a CRT unit. Use only with short tunes.
  115.  
  116.       "TP Array" - Constant array. Must be included in PLARRAY.PAS
  117.       unit using {$I filename} directive. Place PLARRAY in your
  118.       program and call PlayArray (style) procedure.
  119.  
  120.       "TP  B.G."  -  Constant array.  Must  be  used  with  Nels
  121.       Anderson's SOUNDER.PAS unit. Plays music in the background.
  122.            
  123.       "TP play" - Turbo Pascal procedure. Must be used with a
  124.       MUSIC.PAS unit included in the package.
  125.  
  126.       "C  B.G." - Global array. Plays music in background. Uses P/D
  127.       routine SOUNDSYS.C. A sample function PLAYBG.C is provided  to
  128.       help  you  understand  how  it works. Also can be used to play
  129.       music foreground.
  130.  
  131.       "Turbo C" - Turbo C function.  Can be called from your program
  132.       to play music.  Use only with short tunes.
  133.  
  134.       "BASIC"  - BASIC program in ASCII.  The "Tn" and "M" directives
  135.       may be changed.
  136.  
  137.       "Data File" - ASCII text file.  Use PLAY.EXE to play in DOS.
  138.       Several melodies may be included in one data file.  PLAY.EXE
  139.       can play all melodies, a specified melody, or random melodies.
  140.       Great for batch files!  See PLAY.EXE for more details.  The
  141.       music file will have a .dat extension.
  142.  
  143.       "ANSI" - ANSI music file. Contains screen and music codes in [MF
  144.       notation. Recommended for long music pieces. Extension '.ANS'.
  145.       
  146.       "ANSI-BBS" - ANSI music file. Contains screen and music codes in
  147.       [M notation specificly for putting short music pieces into BBS
  148.       screens. Extansion '.BBS'.
  149.      
  150.       "ASCII" - ASCII file of BASIC PLAY codes without the PLAY
  151.       command. Can be used for different applications. Extension '.ASC'.
  152.  
  153.       "Norton BE" - Must be called by BE BEEP filename. BE is a
  154.       command in Norton Utilities. Extansion '.be'.
  155.  
  156.       "DRVSPKR" - DRVSPKR.SYS must be installed in the CONFIG.SYS
  157.       file.  Copy the generated file into SPKR.  The music will play
  158.       in the background.  Please note that this program is also
  159.       shareware and to use it you need to register it with its
  160.       author.
  161.  
  162.       "PianoMan 3" - produces *.MUS files for use with PIANOMAN 3.
  163.       "PianoMan 4" - produces *.MUZ files for use with PIANOMAN 4.
  164.  
  165.       "4DOS/NDOS" - Batch file fragment for use in the 4DOS or NDOS
  166.       environment. (NDOS is a part of Norton Utilities 6.0+).
  167.       
  168.  
  169.  
  170.     ANSI MUSIC
  171.       
  172.       
  173.       So-called ANSI music consists of a set of codes that are
  174.       primarily used in communications.  ANSI music is not related
  175.       to ANSI organization.  The general structure is as follows:
  176.       
  177.            ESC[MF ...music codes... ^N
  178.                        or
  179.            ESC[M ...music codes... ^N
  180.                                                    
  181.       The music codes are the same as in BASIC's PLAY statements.
  182.  
  183.       These codes are recognized by many popular communication
  184.       software programs such as QModem and Deluxe2. The problem is
  185.       that ANSI music is NOT supported by the ANSI.SYS driver.
  186.       Therefore, it cannot be heard using the DOS TYPE command. For
  187.       more information on ANSI music in the BBS world you may contact
  188.       Linda Bloom, the SYSO