home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / GRAV_PAT / PPLT_V11.ZIP / PATMENU / PATMENU.TXT < prev    next >
Encoding:
Text File  |  1995-08-22  |  8.3 KB  |  195 lines
  1.         *****************************************************
  2.         *                 «Patmenu  v0.5»                   *
  3.         *             by Eero Räsänen (C) 1995              *
  4.         *****************************************************
  5.  
  6. Purpose:
  7.  
  8.   A program for managing custom patch sets, especially ProPats Lite patch set.
  9.   You can start patmenu without any parameters and do the work easily with
  10.   a menuing system. However, some times it would be handy to manage the patch
  11.   set also from command-line, for example, optimizing the patch set for
  12.   some game in a batch file. Next section describes the command-line parameters.
  13.  
  14. Note:
  15.  
  16.   When started the first time Patmenu creates a directory called "backup" under
  17.   your \ultrasnd\midi directory. Patmenu uses this directory to backup the
  18.   original patches which are replaced by some custom patches. So DON'T
  19.   EVER remove this directory !!!
  20.  
  21. Usage:
  22.  
  23.   PATMENU [s|p|q|r|X Y]
  24.  
  25.   Parameter  Meaning
  26.   =========  =======
  27.      s          Full mode - uses all the ProPats Lite patches. 
  28.  
  29.      p          Game compability mode - for games which use a lot of patches.
  30.                 *** Works only when in "full mode" ! ***
  31.  
  32.      q          For megaem 3.xx - makes patch set for megaem 3.xx. With
  33.                 this command, you can build 1024.bnk file with megaem 3.xx.
  34.                 *** Works only when in "full mode" or
  35.                     in "Game compability mode" ! ***
  36.  
  37.      r          Restores all orginal patches. You Shouldn't have to use this.
  38.  
  39.      X Y        Command line version of the user interface of the patmenu.
  40.                 Same as starting patmenu without any parameters and pressing
  41.                 key "X" and after that pressing key "Y". For example, restoring
  42.                 original drums could be done with command "patmenu i 0" and
  43.                 with command "patmenu i 1" would vopy the ProPats Lite versions
  44.                 back. 
  45.  
  46.  
  47. INI - files:
  48.   
  49.     You already may have noticed that there are some .ini files included
  50.     with the patmenu program. These .ini files describe the cathegories
  51.     of patches used in the program. For example, when you are in the main
  52.     menu of the patmenu and you press key "0" then what ever you decide
  53.     to do, settings in the "0pats.ini" will take effect. Likewise, "1" for
  54.     "1pats.ini", "2" for "2pats.ini" and so on... The last ini -file which
  55.     can be used is "opats.ini" because the "ppats.ini" is already used
  56.     for game compability mode. So, you still have five free ini -files to
  57.     use after that "ipats.ini" used by ProPats Lite drums. You can make
  58.     new ini -files to have more cathegories patches.
  59.  
  60.     If you would like to have more options in some of the existing
  61.     cathegories ( like "808 drums" in the "drums" menu ) check out
  62.     the next section of this file and study the format of the ini -files.
  63.     
  64.         INI file   Description
  65.         ==========================
  66.         0pats.ini  Acoustic pianos
  67.         1pats.ini  Electric pianos
  68.         2pats.ini  Chromatic percussion
  69.         3pats.ini  Organs
  70.         4pats.ini  Acoustic guitars
  71.         5pats.ini  Electric guitars
  72.         6pats.ini  Basses
  73.         7pats.ini  Strings
  74.         8pats.ini  Ensemble
  75.         9pats.ini  Brass
  76.         apats.ini  Reed
  77.         bpats.ini  Pipe
  78.         cpats.ini  Synth lead
  79.         dpats.ini  Synth pad
  80.         epats.ini  Synth fx
  81.         fpats.ini  Ethnic
  82.         gpats.ini  Percussive
  83.         hpats.ini  Sound effects
  84.         ipats.ini  Drums
  85.  
  86.         ppats.ini  For playing games  - do not change unless you know what you
  87.                       are doing !
  88.         qpats.ini  For megaem 3.xx - do not change either unless you try to
  89.                       make patch set for 512kB GUS ( could be possible ) !
  90.  
  91.  
  92. Format of INI files:
  93.  
  94.    It's essential to know the format of the INI- files, if you want to
  95.    use also some other custom patches. This version of patmenu doesn't
  96.    have any editor included, so you have to do it manually by editing
  97.    the files with some nice editor, like the on which came with DOS :).
  98.    Well, the format is quite simple. Mostly it just looks very cryptic
  99.    because of the "*" and "#" characters.
  100.  
  101.    Let's take a look into file 0PATS.INI
  102.  
  103.    -----------------------------------------------------------------------
  104. (1)     #0*ACOUSTIC PIANOS*ORIGINAL*PROPATS Lite
  105.  
  106. (2)     0*acpiano**_*
  107.         1*britepno*_*
  108.         3*honky****_*
  109.         6*hrpschrd*_*
  110.         7*clavinet*_*
  111.   ------------------------------------------------------------------------
  112.  
  113.  
  114. (1)  First character of the first line of the file is a "#" char. That
  115.      character describes that the line is the header line of the cathegory.
  116.      So, then comes number "0". Right now, it has no meaning. There could be
  117.      any other number.
  118.      After that comes the first "*" character. As you already may have
  119.      noticed, "*" characters are used for string separators in the file
  120.      because strings can also include spaces. So, there must be at least
  121.      one "*" character to separate two strings. This also means that
  122.      there can be many "*" chars beetween to strings...
  123.      The string "ACOUSTIC PIANOS" describe the option in the main menu
  124.      of the patmenu.
  125.      The strings "ORIGINAL" and "PROPATS Lite" describe the options in
  126.      the menu under the option "ACOUSTIC PIANOS"...got it ?
  127.  
  128. (2)  The second part of the file describes the patch files used in the
  129.      section. As before, the first number could be anything. I have used
  130.      it as patch number.
  131.      The second string describes the original patch file name.
  132.      Don't change these !!! 
  133.      The third string ("_") is a special case for ProPats Lite patch.
  134.      It means that the patch has same file name as the original one but
  135.      it resides in the ProPats Lite directory. So, the "_" char in the
  136.      "0*acpiano**_*" means same as "0*acpiano*acpiano*".
  137.      It's just a way to make the lines shorter.
  138.  
  139.      In other words, the second column in the file describes patches for the
  140.      "ORIGINAL" option in the menu and third column describes the same
  141.      thing for the option "PROPATS Lite".
  142.  
  143.  
  144. Changing INI files:
  145.  
  146.      After you have understood the format of the INI -file described
  147.      above it is a good time to know how to make changes to them.
  148.      For example, lets assume that you have two new pianos under
  149.      directory "C:\PATCHES\BIGPIANO" and your ProPats Lite resides
  150.      under directory "C:\PATCHES". These two files are "BIGACPNO.PAT"
  151.      and "BIGBTPNO.PAT" and they are both very nice sounding, but
  152.      both are over 500kB in size. So, you would like to use them
  153.      in time to time for playing some midi files played with a solo
  154.      piano.
  155.  
  156.      First thing to do is to add a menu option for the pianos. It
  157.      can be done as follows.
  158.  
  159.      ----------------------------------------------------------------------
  160.  
  161.      #0*ACOUSTIC PIANOS*ORIGINAL*PROPATS Lite*BIG PIANOS
  162.                                             
  163.      0*acpiano**_*BIGPIANO\BIGACPNO*
  164.      1*britepno*_*BIGPIANO\BIGBTPNO*
  165.      3*honky****_*_*****************
  166.      6*hrpschrd*_*_*****************
  167.      7*clavinet*_*/*****************
  168.  
  169.      ----------------------------------------------------------------------
  170.  
  171.      As you can see, the changes consist of one more string in the header
  172.      line to describe the new option in the menu and a column of text
  173.      in the second part of the file to describe the new patches.
  174.  
  175.      When the "BIG PIANOS" option is chooced from the menu "Acoustic pianos",
  176.      files acpiano Patmenu copies file "C:\patches\bigpiano\binacpno.pat" to     
  177.      file "C:\ultrasnd\midi\acpiano.pat" and file "C:\patches\bigpiano\binbtpno.pat" to
  178.      file "C:\ultrasnd\midi\britepno.pat".
  179.  
  180.      The next two lines are processed as decribed before and then comes
  181.      the last thing to wonder about - "/" character. This character is
  182.      invertion of "_" character. In this case it would restore the
  183.      original version of the "clavinet" patch. In other words, it
  184.      makes sure that original version of the patch is used when
  185.      "BIG PIANOS" option is chooced from the the menu "Acoustic pianos".
  186.  
  187.                                                     
  188.  
  189.  
  190. BE SURE THAT YOU TAKE BACKUPS OF THE .INI FILES BEFORE CHANGING THEM !!
  191.  
  192.  
  193.  
  194. ***End of File***
  195.