home *** CD-ROM | disk | FTP | other *** search
/ Bila Vrana / BILA_VRANA.iso / 031A / IT206.ZIP / MMCMP.TXT < prev    next >
Text File  |  1996-09-26  |  22KB  |  528 lines
  1.                             MUSIC MODULE COMPRESSOR
  2.                                  version  1.34
  3.                       
  4.                                  User's Manual
  5.  
  6.  
  7.  
  8. Table of contents:
  9.  
  10.  
  11.         1. Introduction
  12.         2. Information on MMCMP:
  13.           2.1.  Requirements
  14.           2.2.  Files in this packages      
  15.           2.3.  Features of this version
  16.         3. Usage:
  17.           3.1.  Compressing files
  18.           3.2.  Decompressing files
  19.           3.3.  Using MMTSR
  20.             3.3.1. Loading MMTSR
  21.             3.3.2. Enabling/Disabling
  22.             3.3.3. Removing MMTSR from memory
  23.             3.3.4. More about MMTSR
  24.         4. Some legal stuff...
  25.         5. Contacting the author
  26.         6. Where to get the latest release?
  27.         7. Closing words
  28.  
  29.  
  30.         <See MMUPDATE.DOC for the latest implementations!>
  31.  
  32.  
  33.  
  34. 1. Introduction
  35.  
  36.  
  37.         As music modules and samples are constantly growing larger and 
  38.         larger, it is essential to be able to compress those files to save
  39.         space on disk. However, files compressed using "standard" compression
  40.         utilities may be understood only by a few players and can't usually be
  41.         loaded into any conventionnal tracker for editing and composing.  But 
  42.         now, MMCMP offers you the possibility to do so.
  43.  
  44.  
  45.         MMCMP, Music Module Compressor, is a conventionnal compression utility 
  46.         that compresses music files, giving approximatively the same ratio you 
  47.         could expect with any popular compression utility.  It is not some kind 
  48.         of special sound compression like MPEG2, for example, which may give a 
  49.         very gound compression ratio, but modifies the data and tends to lower 
  50.         sound quality.  MMCMP does not modify the original sound data, and 
  51.         decompressing a compressed file (using MMUNCMP) gives back the 
  52.         original, unmodified data.
  53.  
  54.         
  55.         Its name may suggest that it only compress "modules".  In fact, this is
  56.         what it was intended for at first.  However, as MMCMP was developping,
  57.         it became more flexible and could accept practically any file format.
  58.         Thus, since "instruments" file size has almost increase tenfold over 
  59.         the last years, it was now more than useful to have some way to  
  60.         compress them and still have access to them anytime.  Actually, almost 
  61.         every new version of MMCMP brings support for new sound files formats!
  62.  
  63.  
  64.         "Have access to them anytime."  What does this really means?  What's 
  65.         special about MMCMP is the small TSR (Terminate and Stay Resident) 
  66.         utility (MMTSR.COM) which, once loaded, will decompress the module in 
  67.         the "background" when they are loaded by *ANY* player or tracker.  So 
  68.         you DON'T NEED TO DECOMPRESS MODULES OR SAMPLES TO PLAY THEM BACK AND 
  69.         USE THEM! However, due to technical reasons, MMTSR can't compress 
  70.         modules when, within a tracker, you save a module back on disk. You'll 
  71.         have to do this "manually" with MMCMP.
  72.  
  73.  
  74.         Fortunately, this shall be soon possible, as I'm currently working
  75.         with Jeffrey Lim, the author of *Impulse Tracker*, so that IT will
  76.         include compression/decompression routines.  A few trackers already
  77.         use some kind of sample compression, but as far that I know, this
  78.         shall be the first tracker (I guess) with such a reasonable
  79.         compression (ratio approximatively equal to ZIP, ARJ, LZH, etc.. and
  80.         twice or thrice faster!)
  81.  
  82.  
  83.  
  84.  
  85.  
  86. 2. Information on MMCMP
  87.  
  88.  
  89.   2.1. Requirements:
  90.  
  91.  
  92.         - A 80386 based or better computer (does anybody still have something
  93.           worse????)
  94.         - around 300k of free conventionnal memory (MMCMP/MMUNCMP)
  95.         - 64 k of free exTended memory OR 64k of free exPanded memory (for
  96.           MMTSR only)
  97.         - some free space on your drive C: (for MMTSR only) to uncompress a
  98.           file (the size of a big module is enough...)
  99.  
  100.  
  101.         These requirements may change with future version of the program.
  102.         See the "Features" section below and the MMUPDATE.DOC file.
  103.  
  104.  
  105.   2.2. Files in this package:
  106.  
  107.  
  108.         You should have all of the following files:
  109.  
  110.  
  111.         MMCMP.EXE       The compression utility
  112.         MMUNCMP.EXE     The decompression utility
  113.         MMTSR.COM       The TSR version of MMUNCMP
  114.         MMCMP.TXT       The MMCMP manual (this file...)
  115.         MMTSR.TXT       Technical information on MMTSR
  116.         MMUPDATE.TXT    Information on previous, current and future releases
  117.         FILE_ID.DIZ     Small description for BBS
  118.  
  119.  
  120.         If there's more files, don't worry, but if some of those files are
  121.         missing, please try to find an "original" version so you may benefit of
  122.         everything MMCMP has to offer you!  See Section 6. Where to get the
  123.         latest release?
  124.  
  125.         If you wish to distribute MMCMP, see Section 4. Some legal stuff...
  126.  
  127.  
  128.   2.3. Features of this version
  129.  
  130.  
  131.         MMCMP can actually compress modules of the following formats and
  132.         will support everything supported by the specified tracker version:
  133.          - S3M: Scream Tracker 3 module (ST3 version 3.21)
  134.                 (adlib samples not supported (who cares.:]) but MMCMP supports
  135.                 16 bits samples even if ST3 doesn't)
  136.          - IT:  Impulse Tracker module (IT version 2.03)
  137.          - XM:  Extended Module (Fast Tracker 2.06)
  138.          - MOD: Amiga MOD format (made with any good MOD tracker, except old
  139.                 MODs with only 15 instruments, they are not supported yet)
  140.  
  141.         MMCMP also handles samples files of the following formats...
  142.  
  143.          - DigiPlayer / Scream Tracker 3 Sample file (often refered as S3I or
  144.            SMP)
  145.          - Impulse Tracker samples.
  146.          - WAV: 'Conventionnal' WAV files.  WAV format being very flexible, 
  147.                 files may sometimes contain unsupported data (names, samples
  148.                 lists, cue points, etc...).  It should not cause any problem
  149.                 if you try yo compress such files, but you probably won't get
  150.                 an optimal compression ratio.
  151.  
  152.         ...as well as instrument files:
  153.  
  154.          - XI:  Fast Tracker 2 Extended Instrument
  155.  
  156.         Thracker versions are the latest version of those trackers with which
  157.         MMCMP has been tested.  Of course, MMCMP may work correctly with a 
  158.         module made with newer versions of those trackers as long as modules 
  159.         don't hold newly implemented features, but it is possible that MMCMP 
  160.         may incorrectly handle the features that are "currently unsupported" 
  161.         by those trackers. Note that a lot of other file formats (notably IFF, 
  162.         PAT, and others) shall be implemented SOON!  (at least, when I'll find
  163.         documentation!)
  164.  
  165.  
  166.         Actually, MMCMP supports only 8/16 bits mono compression.  This doesn't
  167.         mean much though, because data like patterns, which aren't samples, are
  168.         compressed too, exactly like samples.  It only means that, for example,
  169.         stereo samples will soon have their own compression scheme so they can
  170.         be compressed much better.  However, among currently supported module
  171.         formats, none of their respective trackers actually support stereo
  172.         samples, so stereo support won't be implemented until necessary...
  173.  
  174.         NOTE:   If you happen to have descriptions of different file formats
  175.                 headers (especially .PAT and .IFF) and are willing to give 
  176.                 them to me, please do it!!  You'll get at least the honor to 
  177.                 be within theses docs, and probably more...
  178.                 See section 5: Contacting the author, below in this file!!
  179.  
  180.  
  181.  
  182.  
  183. 3. Usage
  184.  
  185.  
  186.   3.1. Compressing Files
  187.  
  188.  
  189.         To compress a module, simply type at the prompt:
  190.  
  191.  
  192.                          MMCMP filename [filename] [filename]...
  193.  
  194.  
  195.         "filename" may include a drive letter, a full path, as well as '*'
  196.         and '?' wildcards.  You may also specify more than one filename.