home *** CD-ROM | disk | FTP | other *** search
/ Sound Sensations! / sound_sensations.iso / demos / rcesqdmo / rcxlat.doc < prev    next >
Text File  |  1988-08-15  |  5KB  |  157 lines
  1.  
  2.  
  3.  
  4.                                   RCXLAT v1.00a
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                        Copyright 1988, C&M Research Group
  17.                                ALL RIGHTS RESERVED
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                                C&M Research Group
  50.                               302 Ridgehaven Place
  51.                                San Antonio, Texas
  52.                                    78209-3424
  53.  
  54.                              (512) 826-0721 [Voice]
  55.                              (512) 826-0659 [Modem]
  56.  
  57.  
  58.      RCXLAT is a program that converts banks of patches produced by other
  59.      ESQ/SQ-80 patch librarians to a format acceptable by RC and vice versa.
  60.      There are three formats that RCXLAT recognizes: Ensoniq/Blank/RC:ESQ,
  61.      MIDIex, and ESQLib.  RCXLAT can convert each of these formats to any of
  62.      the other.  RCXLAT can be used from a menu or the command line.
  63.  
  64.  
  65.      MENU OPERATION
  66.  
  67.           The easiest way to use RCXLAT is from the menu.  When RCXLAT is
  68.           typed in at the command line with no parameters, a menu will be
  69.           displayed.  There are only eleven valid commands on this menu.
  70.           The commands are simply numbers from [1]-[10] and a [Q] for Quit.
  71.           RCXLAT will terminate if [Q] is pressed.
  72.  
  73.           When one of the 10 numbers is entered, RCXLAT will perform the
  74.           conversion that the number corresponds to.  After the number is
  75.           entered, a list of files in that format that are in the current
  76.           directory are displayed.  If no files exist, then a message will
  77.           tell you that there are no files available for converting and then
  78.           RCXLAT will ask you if you wish to continue the program.
  79.  
  80.                ■ Any file with the "ESQ" extension is in Ensoniq/Blank/
  81.                  RC:ESQ format.
  82.                ■ Any file with the "MDX" extension is in MIDIex format.
  83.                ■ Any file with the "BNK" extension is in ESQLib format.
  84.                ■ Any file with the "SEQ" or "SSQ" extension is a Sequence.
  85.  
  86.           After the directory of the files that can be converted has been
  87.           displayed, you will be asked to enter the input file.  Notice that
  88.           there is an extension in the brackets right before the question
  89.           mark.  This indicates that if you type in the filename without the
  90.           extension, the extension you see in the brackets will be added to
  91.           what you typed in.  In order to not have the extension be added,
  92.           use the "." character right after the filename you chose (example:
  93.           PATCHES.).  You will then be asked to enter the output file. 
  94.           Again, you will notice the brackets except that the filename which
  95.           you chose is displayed, but with a different extension.  If you
  96.           just press [ENTER], RCXLAT will assume that you want to use the
  97.           filename that appeared in brackets.  If you wish not to use this
  98.           filename, simply type in the filename of your choice.
  99.  
  100.           Note:  You will be asked for the output file for all options  
  101.                  except for options 7-10, which is a sequence conversion 
  102.                  option.  The other sequence conversions can not be made
  103.                  from the command line.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.      THE SEQUENCE CONVERTER
  113.  
  114.           The sequence converter will convert an Ensoniq All Sequence Block
  115.           Sequence into RC All Sequence Block.  In this conversion, the
  116.           name of the input file you chose will be used as the output file. 
  117.           There are two output files.  One is a file with an "ESQ"
  118.           extension which is a bank of patches to be used with the
  119.           sequence.  The other is a file with a "RQA" extension which is
  120.           the sequence in a format acceptable by RC.
  121.                       
  122.           Once all of the files have been entered, RCXLAT will check the
  123.           format of the input file you chose.  If the format is invalid,
  124.           RCXLAT will terminate.  
  125.       
  126.           Note:  If the file being read is understood to be in  
  127.                  Ensoniq/Blank/RC:ESQ format and the file is really a
  128.                  sequence, RCXLAT will tell the user that the file is a
  129.                  sequence and terminate the program.
  130.  
  131.  
  132.      COMMAND LINE OPERATION
  133.  
  134.           Using RCXLAT via the command line is the fastest way to convert
  135.           banks, but not as easy as from the menu operation above.  To
  136.           start, two filenames must be placed on the command, each having
  137.           the extension of "ESQ", "BNK", or "MDX".
  138.  
  139.           Examples:
  140.  
  141.                A>RCXLAT PATCHES.MDX PATCHES.ESQ
  142.                     This command would convert file PATCHES.MDX into
  143.                     Ensoniq/Blank/RC:ESQ format.
  144.  
  145.                A>RCXLAT PATCHES.BNK CONVERT.MDX
  146.                     This command would convert the ESQLib bank PATCHES.BNK
  147.                     into a MIDIex bank called CONVERT.MDX.
  148.  
  149.                A>RCXLAT TRANSONQ.MDX TRANSONQ.MDX
  150.                     This command would be invalid.  There are two extensions
  151.                     that are the same and RCXLAT knows that you can not
  152.                     convert a file from one format into that same format.
  153.  
  154.                A>RCXLAT /H (or RCXLAT ?)
  155.                     This will display a brief help screen.
  156.  
  157.