home *** CD-ROM | disk | FTP | other *** search
/ Media Depot 5 / mediadepotvolume51993.iso / FILES / 15 / MMP2_606.ZIP / MMP_DOC.TXT next >
Text File  |  1996-05-05  |  15KB  |  362 lines
  1.                      ▒█   █  ▒█   █  ▒█    ██████  ▒█
  2.                      ▒██▒██  ▒█   █  ▒█      ▒█    ▒█
  3.                      ▒█ █ █  ▒█   █  ▒█      ▒█    ▒█
  4.                      ▒█   █  ▒█   █  ▒█      ▒█    ▒█
  5.                      ▒█   █  ▒█   █  ▒█      ▒█    ▒█
  6.                      ▒█   █  ▒█   █  ▒█      ▒█    ▒█
  7.                      ▒█   █   ░███   ░████   ▒█    ▒█
  8.  
  9.                  ▒█   █    ███   ▒████   ▒█   █  ▒█    ▒████
  10.                  ▒██▒██  ▒█   █  ▒█   █  ▒█   █  ▒█    ▒█
  11.                  ▒█ █ █  ▒█   █  ▒█   █  ▒█   █  ▒█    ▒█
  12.                  ▒█   █  ▒█   █  ▒█   █  ▒█   █  ▒█    ▒███
  13.                  ▒█   █  ▒█   █  ▒█   █  ▒█   █  ▒█    ▒█
  14.                  ▒█   █  ▒█   █  ▒█   █  ▒█   █  ▒█    ▒█
  15.                  ▒█   █   ░███   ░████    ░███   ░████ ▒████
  16.  
  17.                  ▒████   ▒█       ░███   ▒█   █  ▒████ ▒████
  18.                  ▒█   █  ▒█      ▒█   █  ▒█   █  ▒█    ▒█   █
  19.                  ▒█   █  ▒█      ▒█   █  ▒█   █  ▒█    ▒█   █
  20.                  ▒████   ▒█      ▒█████    ▒█    ▒███  ▒████
  21.                  ▒█      ▒█      ▒█   █    ▒█    ▒█    ▒█ █
  22.                  ▒█      ▒█      ▒█   █    ▒█    ▒█    ▒█  █
  23.                  ▒█      ░████   ▒█   █    ▒█    ▒████ ▒█   █
  24.  
  25.  
  26.                 version 2.606 - (C) Charles Attard - April 1996
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                    Introduction
  33.                                    ▒▒▒▒▒▒▒▒▒▒▒▒
  34.  
  35.       What can it play ?
  36.       ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  37.  
  38.  
  39.        The Multi Module Player is a very high quality digital music module
  40.       player. It supports the following types of modules :
  41.  
  42.         NST          NoiseTracker (4 channels, 15 instruments @16574 Hz)
  43.  
  44.         MOD          ProTracker , SoundTracker, FastTracker,
  45.                      StarTrekker and TakeTracker
  46.                      (1 to 32 channels, 31 instruments @16574 Hz)
  47.  
  48.         669          Composer 669 v1.x Module
  49.                      (8 channels, 64 instruments @17480 Hz)
  50.  
  51.         MTM          Multi Tracker Module v1.x
  52.                      (1 to 32 channels, 64 instruments @16574 Hz)
  53.  
  54.         S3M          Scream Tracker v3.x Module
  55.                      (1 to 32 channels, 100 instruments at any sample rate)
  56.                      Note : Old STM format can easily be converted to S3M
  57.                      format using Scream Tracker v3.x.
  58.  
  59.         (if you want a tracker and have access to Internet, you
  60.          can try FTP : ftp.luth.se (130.240.16.39) in /pub/msdos/demos ...)
  61.  
  62.  
  63.       System requirements
  64.       ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  65.  
  66.  
  67.       The hardware support is only Sound Blaster 16/ASP/AWE32(in SB16 mode)
  68.      and Sound Blaster Pro for now. I've got the informations to program many
  69.      types of sound cards (Gravis UltraSound, Pro Audio Spectrum ,
  70.      Windows Sound System) but i don't own them (!) and i need to know from
  71.      you if it's neccessary to do so (i will also need your help to debug
  72.      these routines ...).
  73.  
  74.      The screen output is graphical (640x480x256) and uses VESA v1.0 routines,
  75.       so you need a video card with VESA BIOS extensions or a resident patch.
  76.  
  77.      About memory, MMP uses 4 modes to avoid a "not enough memory message"
  78.      (very annoying when you have a 4, 8, 16 or more Megabytes of memory
  79.      in your system and you only need some hundreds of kilobytes).
  80.       It uses DOS, EMS and XMS types of memory.
  81.      The possible modes are:
  82.  
  83.       Mode:    Why MMP uses this mode:
  84.  
  85.       DOS
  86.                The module loaded is small enough to hold in conventionnal
  87.                memory. But if an instrument has a size over 64 KB (the
  88.                module loaded is a 669 or a MTM), MMP will use the
  89.                DOS/XMS 32 bits linear mode instead to avoid truncature.
  90.                This is a fast mode.
  91.  
  92.       DOS/EMS
  93.                The instruments can't hold in DOS memory, but the patterns can
  94.                (it is assumed that it will always be the case).
  95.                The instruments are loaded in EMS but are truncated to
  96.                64 KB (you will be warned), as MTMs and 669s can have
  97.                instruments 1 MB long.
  98.                To avoid this, you must allow MMP to enter XMS 32 bits linear
  99.                mode by disabling any expanded memory manager as EMM386,
  100.                QEMM386 ... and enabling HIMEM.SYS.
  101.                Note that the DOS/EMS mode is slow, so, if you have less than a
  102.                486DX-120 MHz you should really do it !
  103.  
  104.       DOS/XMS 32 bits linear
  105.  
  106.                As in DOS/EMS mode, the total size of instruments is to big
  107.                to fit in DOS memory.
  108.                This is the best mode (fast, all free memory is available,
  109.                and samples are not truncated to 64 KB).
  110.                See above to enable it.
  111.                In this mode the processor does linear adressing in real mode !
  112.                The Global Descriptor Table is modified, that's why it's
  113.                totally incompatible with other applications running in
  114.                protected mode.
  115.  
  116.       DOS/XMS segmented
  117.  
  118.                 This mode is used when the processor is in protected mode
  119.                (preventing MMP from using the DOS/XMS 32 bits linear mode)
  120.                and there is no free EMS. If you have less than a 486DX-120 MHz
  121.                you should try to disable EMM386.
  122.                 Moreover, you have to enable HIMEM.SYS with the option
  123.                /numhandles=100 for modules with more than 32 instruments.
  124.                (you should always set this option, it doesn't need any memory)
  125.  
  126.                 Why do this ? This mode is really special and can be very
  127.                heavy in short times when a module is  playing : when a new
  128.                instrument needs to be used it must be "downloaded" from XMS
  129.                to conventionnal memory, so, imagine what can happen when you
  130.                have a 16 tracks module; The amount of data to transfer can be
  131.                as high as (16 tracks*64 KB)=1 MB in about 0.01 s
  132.                (the Sound Card sends an IRQ at about 100 Hz),
  133.                so, your system must be able to transfer up to 100 MB/s !
  134.  
  135.                 Even a fast Pentium can't do this. My system
  136.                has a Triton chipset with standard DRAM and a 120 MHz Pentium
  137.                (the cache can't be effective in this case), and can only
  138.                transfer at 80 MB/s in 32 bits, so, 40 MB/s in this mode.
  139.                 But in practice, the transfer rate achieved by a 486DX-120 MHz
  140.                should be enough ...
  141.  
  142.                 If you really can't disable EMM386, ... you should at least
  143.                declare some EMS (1 MB is enough for any module).
  144.                 In this mode, instruments are truncated to 64 KB.
  145.  
  146.  
  147.       Why a new player ?
  148.       ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  149.  
  150.        I've always been disappointed by the output quality of players
  151.       (except DMP 3.x+, Mod4Win 2.x+ ) or by the precision of patterns
  152.       playing (all players !).
  153.        Technically, the output is computed in a 32 bits buffer, with a 16
  154.       bits resolution (even for 8 bits sound card) and is clipped to fit
  155.       in the 16 bit (or 8 bit) output stream. This allows a greater signal to
  156.       noise ratio and is very useful when the number of tracks is high (8 and
  157.        over).
  158.        To improve quality, a dynamic linear interpolator (or dynamic filter,
  159.       or oversampler ...) for each channel can be enabled. It ensures a
  160.       full use of the 16 bits resolution and filters useless harmonics (noise).
  161.        A low-pass filter can also be enabled, instead or with oversampling,
  162.       if you have sensitive ears about high frequencies ... :)
  163.       All this nice things give the highest possible output for all ears !
  164.  
  165.        MMP version 2.606 has been thoroughly tested with more than 5000
  166.       modules to ensure the highest quality in playing modules. I've spent
  167.       hundreds, perhaps thousands hours listening, debugging, listening,
  168.       debugging ... this player (and sometimes debugging, debugging ... ;),
  169.       so i'm confident in its quality ! Of course, there's always
  170.       a little bug flying or crawling somewhere, so if you can help me
  171.       to catch it ...
  172.        Moreover, I've also used the associated trackers (Scream Tracker 3.x
  173.       for S3M, Composer 669 v1.x for 669 ...) to have an identical
  174.       interpretation of patterns from the tracker and from MMP.
  175.  
  176.       Miscellaneous features
  177.       ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  178.  
  179.        + 15000 lines of pascal and 286 assembler
  180.        +  6000 lines of 386 assembler
  181.        + Play engine in higly optimized 386 assembler. Scheduling
  182.          optimizations for Pentium and 486.
  183.        + Ultra fast FFT implementation of Cooley and Tukey algorithm (1965)
  184.          in 386 assembler (on a Pentium-120 MHz, 250 per second 1024 points
  185.           FFTs computed, only 4 ms a 1024 points transform !)
  186.        + CPU overload detection and load adjustment (disabled for now)
  187.        + Automatic detection of Sound Blaster cards (16 and Pro)
  188.        + No file prompt mode (enter MMP <module_name> )
  189.        + List file mode playing (enter MMP <@liste.txt> )
  190.        + All Protracker 2.x (NST, MOD, MTM), Scream Tracker 3.x (S3M) and
  191.          Composer 669 1.x (669) commands supported
  192.  
  193.  
  194.       Is MMP running ? OK, let's see how to use it
  195.       ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  196.  
  197.  
  198.       Basic use
  199.       ▒▒▒▒▒▒▒▒▒
  200.  
  201.         MMP is very easy to use, just launch it, select the directory where
  202.        you have some modules, select a module then press Enter. The module
  203.        should play (hope so ... ;)
  204.         To pause module playing, press Pause or F4. To exit from MMP (what ?!)
  205.        press Esc.
  206.         When the module has finished playing, the file selector window
  207.        appears. If you don't want to listen more the module, press Enter or
  208.        F3 to make the file selector window appear and select a new module
  209.        (or press Esc or Pause or F4 or ... Reset, no ... i was joking ;)
  210.  
  211.         If you know the path to the modules, you can enter it directly. When
  212.        the file selector window is on (or press F3 if not), press alt-C,
  213.        enter then path, then validate with Enter.
  214.  
  215.        Press F1 under MMP to have some help about keyboard commands.
  216.        (Note: the help is different under the file selector window and
  217.        when you have the main screen)
  218.  
  219.  
  220.       For users that don't like the default configuration
  221.       ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  222.  
  223.        I hope there are some ...
  224.        You can display any of five elements, assuming there's enough space
  225.       on the screen :
  226.  
  227.                           status bar                  (key s)
  228.  
  229.                       channel descriptor              (key t)
  230.  
  231.                         instrument list               (key i)
  232.  
  233.                    oscilloscope (mono or stereo)      (key o)
  234.  
  235.                   frequency spectrum (mono or stereo) (key p)
  236.  
  237.  
  238.        To enable or disable an element, press the associated key.
  239.        When enabled, an element will be display at the bottom of the screen.
  240.         That's not much practical but you shouldn't change the configuration
  241.        very often, once you're satisfied.
  242.         To change elements size and caracteristics (oscilloscopes, channels
  243.        and spectrums) see the configuration menu (press c in the main screen).
  244.  
  245.  
  246.        Configuration saving
  247.        ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  248.  
  249.  
  250.        Whatever you changed is saved in the file MMP.CFG when you quit MMP.
  251.        There are two types of parameters, some "global", some "partial".
  252.        The "partial" parameters are dependent upon the number of tracks.
  253.        They are saved in different places of the configuration file, each
  254.        assigned to a 4 tracks block :
  255.  
  256.                    1-4   tracks
  257.                    5-8   tracks
  258.                    9-12  tracks
  259.                    13-16 tracks
  260.                    17-20 tracks
  261.                    21-24 tracks
  262.                    25-28 tracks
  263.                    29-32 tracks
  264.  
  265.        The "partial" parameters are the ...
  266.  
  267.            Spectrums height
  268.            Maximum spectrums height
  269.            Oscilloscope height
  270.            Maximum oscilloscope height
  271.            Output frequency
  272.            LDI mode (oversampling) enabler
  273.            Low-pass filter level
  274.            Digital amplification level
  275.            Default panning with speakers
  276.            Default panning with headphones
  277.            Number of displayed tracks
  278.            Channel display mode
  279.            Number and type of elements present
  280.  
  281.        The "global" parameters are the ...
  282.  
  283.            Modules path
  284.            Spectrums type (mono or stereo)
  285.            FFT display size
  286.            FFT size
  287.            Left spectrum video synchronization
  288.            Right spectrum video synchronization
  289.            Left oscilloscope video synchronization
  290.            Right oscilloscope video synchronization
  291.            Spectrum scale type (linear, power and logarithmic)
  292.            Spectrums scale factor
  293.            Oscilloscope type (mono or stereo)
  294.            Loop mode (allowed, forced, forbidden)
  295.            Pan enabler
  296.            Cursor position X
  297.            Cursor position Y
  298.            Menu enabler
  299.            Output mode (mono or stereo)
  300.            Headphones panning enabler
  301.  
  302.        If you don't understand everything, that's normal, just use MMP ;)
  303.        if you really want to understand, mail me, i always reply.
  304.        (cattard@mnserver.ulb.ac.be -> i'm french not belgian, just a remote
  305.         account).
  306.  
  307.  
  308.        Copyright  (the legal stuff)
  309.        ▒▒▒▒▒▒▒▒▒
  310.  
  311.         This program is freeware. This means you can copy it, do whatever
  312.         you want with it, as far as no money is involved and that you
  313.         copy the two files MMP.EXE and MMP_DOC.TXT, transfer them on any
  314.         server or any media (including CD-ROM) * UNMODIFIED *.
  315.         If you have any doubt about the files integrity, mail me.
  316.  
  317.  
  318.        Disclaimer (the legal stuff bis)
  319.        ▒▒▒▒▒▒▒▒▒▒
  320.  
  321.         In no event the Author will be liable for any damages, including any
  322.         lost profits, lost savings or other incidental or consequential
  323.         damages arising out of your use or inability to use the program, or
  324.         for any claim by any other party.
  325.  
  326.          All mentioned Trademarks and Copyrights are registered by their
  327.         respective owners.
  328.  
  329.         If you don't agree, delete the files and forget MMP ;)
  330.  
  331.  
  332.        Who am i ?
  333.        ▒▒▒▒▒▒▒▒▒▒
  334.  
  335.         I'm 27 and preparing a Ph.D in physics.
  336.  
  337.  
  338.        Snail mail
  339.        ▒▒▒▒▒▒▒▒▒▒
  340.  
  341.         If you want some modules, a new version or anything, send
  342.         FORMATTED 3½" disk(s) and enough money or more disks for the
  343.         expenses to :
  344.  
  345.                       Charles Attard
  346.                       7 rue des plantes
  347.                       44100 NANTES
  348.                       FRANCE
  349.  
  350.        E-mail
  351.        ▒▒▒▒▒▒
  352.  
  353.              Mail me for any comment, bug report, or anything i can do
  354.              to help you
  355.  
  356.                   cattard@mnserver.ulb.ac.be
  357.  
  358.  
  359.  
  360. C.A. 5/1/96
  361. ------------------------------------------------------------------------------
  362.