home *** CD-ROM | disk | FTP | other *** search
/ Computerworld: Vánoce 98 / Computerworld_1998-12_cd.bin / cw / programy / utility / m2buzz3c.exe / EASYXMID.ZIP / EASYXMID.TXT < prev   
Encoding:
Text File  |  1998-02-01  |  4.3 KB  |  142 lines
  1.             ----------------------------
  2.                EASYXMID v1.0 by Stefano Maini - documentation
  3.  
  4.                             Updated Feb 1, 1998
  5.             ----------------------------
  6.  
  7.  
  8.  
  9.              *** IMPORTANT WARNINGS ***
  10.  
  11.  
  12.     1) The author is not responsible for any damage and/or data loss
  13.        caused by this product. Please read carefully the documentation
  14.        before using it.
  15.  
  16.  
  17.     2) The files stored in this package are all FREEWARE. It means that
  18.        you may distribute,copy,modify,delete whatever you want. The
  19.        author is not responsible for any damage and/or data loss caused
  20.        by modified versions.
  21.  
  22.  
  23.     3) This package was checked with the author's best antivirus program.
  24.        The author apologize for any bugs and/or bad writing sentences
  25.        found in the original version of the package.
  26.  
  27.  
  28.     4) I am Italian, don't expect good English language in this doc !
  29.  
  30.  
  31.  
  32.             *** USER'S INFORMATIONS ***
  33.  
  34.  
  35.   1) WHAT IS 'EASYXMID' ?
  36.  
  37.   EASYXMID is a DOS utility that converts MIDI-format files (*.MID) in
  38.   Fast Tracker 2 format modules (*.XM). Useful when you want to play
  39.   your MIDI songs better than FM chips do (if you don't have a wavetable
  40.   in your soundcard).
  41.  
  42.   GOOD features:
  43.  
  44.     + Easy to use
  45.     + Very small code
  46.     + Doesn't need extra memory
  47.     + Doesn't need extra samples or GUS patches during conversion
  48.     + Optimized XM channels utilization
  49.     + Optimized instruments allocation
  50.     + Extended module output (volume col,8 octaves, note-off, 32 voices)
  51.     + Volume-pitch-program-tempo change
  52.  
  53.   BAD features:
  54.  
  55.     - Slow processing
  56.     - Produces very big XM files (doesn't compress patterns)
  57.     - Midi format 2 not supported
  58.     - STMPTE timing system not supported
  59.     - Panning usupported (no stereo output)
  60.  
  61.   2) WHAT MUST I HAVE ?
  62.  
  63.     - A MS-DOS 6.0 platform
  64.     - The utility works well on a 80x386 processor or better.
  65.     - A copy of Fast Tracker 2 to make your converted song working.
  66.  
  67.   3) HOW THE CONVERSION WORKS ?
  68.  
  69.   Type at the dos prompt the following command line:        
  70.     
  71.         EASYXMID <source> <dest> <qfact> <drumchn>
  72.  
  73.   Where: (the arguments must be IN ORDER, don't forget any parameter!)
  74.  
  75.     <source> Is the name of your source MIDI file. 
  76.          You MUST specify complete path.
  77.          Include the .MID extension.
  78.          No Jolly characters allowed (only 1 file per time!)
  79.  
  80.     <dest> Is the name of your destination XM file.  
  81.            You MUST specify complete path.
  82.            Include the .XM extension.
  83.     
  84.     <qfact> Is the quantization factor. It means that 
  85.         you can skip notes that are too short, reducing
  86.         also the lenght of your XM pattern list.
  87.         <qfact> must be an integer number between 0 and 4.
  88.         Refer to this scheme:
  89.  
  90.             <qfact>         Skip less than...
  91.              0               1/4 note
  92.              1               1/8 note
  93.              2               1/16 note
  94.              3               1/32 note
  95.              4               1/64 note
  96.  
  97.     <drumchn> is the number of the MIDI channel reserved to drums.
  98.           Usually is 10, but some MIDIs use 16.
  99.  
  100.  After the conversion, you will see some informations about channel
  101.  utilization and song lenght.
  102.  
  103.  Launch Fast Tracker 2 and load your converted XM :
  104.  
  105.     - Reduce your number of channels accordingly to the 
  106.           value written in the songname string.
  107.  
  108.     - Load your best samples/instruments into the respective slots
  109.       (Where the MIDI instruments name are stored!)
  110.  
  111.     - Tune up your samples, check volume and play it !!!
  112.  
  113.         - Save your fresh XM to disk. (You will notice that EASYXMID
  114.       stores pattern in uncompressed format. saving it again in
  115.       FT2 -with pattern compression- will save some disk space)
  116.  
  117.  
  118.  That's it! Hope you'll have fun with it.
  119.    
  120.  
  121.               *** TROUBLESHOOTING ***                  
  122.           
  123.  
  124.     1) The utility don't save changes.
  125.  
  126.         - Your disk is full. Always keep 1MB free on your HD 
  127.              (not only for this utility!) 
  128.  
  129.     2) My converted XM is -NO GOOD- 
  130.     
  131.         Sorry, this utility is a beta release. There are a lot
  132.         of bugs to fix... If you are sincerely interested about
  133.         this program (yeah, I mean you really NEED it, you really 
  134.         WANT to make it WORK) send me an e-mail with your comments 
  135.         about improvements and bug-finding.
  136.  
  137.  
  138.                                Stefano Maini
  139.  
  140.                                                     email: mainet@iol.it
  141.                                                            ^^^^^^^^^^^^^
  142.