home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / p / pmp210.zip / PMP.DOC < prev    next >
Text File  |  1993-03-05  |  12KB  |  240 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.      ──────────────────────────────────────────────────────────────────────
  9.      Protected Module Player PMP (C) 1993 Jussi Lahdenniemi and Otto Chrons
  10.      ──────────────────────────────────────────────────────────────────────
  11.  
  12.                                   Version 2.01
  13.  
  14.  
  15.  
  16.  
  17.  
  18.         Like the DMP, also PMP is just a demonstration about the possibilities
  19.      of the DSMI (Digital Sound and Music Interface). It is a module player,
  20.      which runs in the protected mode, offering lots of memory for the modules
  21.      to use. Also, because of this, the PMP gives you a fully-working DOS
  22.      shell, and takes only about 40k of memory regardless of the size of
  23.      the module! So, you can play a 700k module and still have over 550k of
  24.      memory free! If your computer is in the v86-mode (ie. you have a program
  25.      like QEMM installed) the PMP takes a little more memory (24k more),
  26.      because the buffers must reside in the low memory.
  27.  
  28.         The command line syntax of the PMP is just the same as DMP's :
  29.  
  30.            PMP [options] [modulename] [@listfile] [options]
  31.  
  32.            Where:
  33.            ------
  34.        modulename : name of a module (wildcards *,? allowed)
  35.        listfile   : name of a file containing list of module names
  36.  
  37.        options  : -Sxxxx          set sampling rate 4000-44100
  38.                       alternatively 4-44
  39.                       DON'T USE HIGHER THAN 21kHz ON A SB
  40.               -H or -?          show help screen
  41.               -Ix          interrupt number
  42.               -Pxxx          port address
  43.               -Dx          DMA channel
  44.               -O          Scramble module order
  45.               -L          Inhibit looping
  46.                       -M              Mono mode (SB16 & PAS)
  47.               -Q          Quality mode (on 8-bit cards only)
  48.                       -Cx             Desired card where x is:
  49.                     1 for Sound Blaster
  50.                     2 for Sound Blaster Pro
  51.                     3 for PAS+
  52.                     4 for PAS16
  53.                     5 for SB16
  54.                       -T[xxx]         Buffer size xxx (0-32000)
  55.                       -Fxxx           Force PMP to leave xxx kilobytes
  56.                                       of memory for the DOS shell
  57.                       -V              Force PMP to use its v86 mode support
  58.                                       (place the buffers to low memory)
  59.  
  60.         You may have to  give your soundcard's IRQ  number and/or
  61.      port address if PMP fails to find them. If you don't provide both
  62.      values then PMP will assume 220h for port address, and 7 for interrupt
  63.      number. Giving  wrong address  will hang  your machine,  but wrong
  64.      interrupt number only stops the playing after a second. The "/C"
  65.      option is useful if you want to use some other card, than the one PMP
  66.      automatically detects.
  67.  
  68.         You don't  have  to add  any extension  to  the name,  because the
  69.      program will try  extensions AMF, STM, MOD and  NST if it  doesn't find
  70.      the file. Note that you can supply many modulenames and list files, up
  71.      to the internal limit of 200 modulenames.
  72.  
  73.            Example:
  74.  
  75.        PMP beyond -s20 *.NST @goodmods
  76.  
  77.            goodmods is a text file containing following lines:
  78.            occ-san
  79.            stars
  80.            intro3
  81.  
  82.         PMP  will use  the  sampling  rate  of  20kHz  and  play following
  83.      modules: BEYOND.MOD,  OCC-SAN.STM, STARS.MOD, INTRO3.MOD  and all
  84.      .NST-files in the current directory.
  85.  
  86.         The above text was taken straight from the DMP's documentation. As you
  87.      can see: If you can use DMP, you can use PMP...
  88.  
  89.         Normally PMP uses all free XMS memory for its own purposes, but if you
  90.      want to save some XMS for other programs, use the environment variable
  91.      DPMIMEM:
  92.  
  93.      SET DPMIMEM=MAXMEM 1024
  94.  
  95.      limits the XMS use to one MB.
  96.  
  97.         Note : Borland's programs that run in the protected mode use also
  98.      this environment variable.
  99.  
  100.         Another supported environment variable is PMP. You can write your
  101.      preferred settings into the variable, so you don't have to write them
  102.      every time you start the program. For example, if you have the PMP
  103.      variable set as follows:
  104.  
  105.      SET PMP=/S30 /O C:\MODS\*.MOD
  106.  
  107.      and then you run PMP like this:
  108.  
  109.      PMP *.stm
  110.  
  111.      PMP will be started just like if you had written
  112.      PMP /S30 /O C:\MODS\*.MOD *.stm
  113.      from the command line.
  114.  
  115.  
  116.  !!!!   The included files RTM.EXE and DPMI16BI.OVL must be in the path!   !!!!
  117.  
  118.  
  119.                             Using PMP
  120.                             ---------
  121.  
  122.         There is a header in the top of the screen telling what program you
  123.      are using and other important info. In the right side of the screen
  124.      there is a big blue box with all the module names you have selected
  125.      in the command line. When a module is loaded into memory, it is marked.
  126.      That way it is easy to see which modules are to be played next, and
  127.      which modules are loaded.
  128.         After initializing everything it needs, PMP starts to load the first
  129.      module. After loading it, PMP starts to play the module and proceeds
  130.      with loading the next module. It loads as many modules as possible,
  131.      and then plays them from memory. If all the modules you selected do
  132.      not fit to the memory, PMP discards the module after playing it and
  133.      loads more modules. With the /F switch you can control the memory
  134.      allocation so that you always will have enough memory to shell to DOS.
  135.         While playing under PMP (not in the DOS shell), there is a status
  136.      bar just below the header text. This status bar shows the pattern
  137.      currently being played, the total number of patterns, the current row,
  138.      the master volume level, and indicators indicating which channels are
  139.      being played. It also helps you by telling that help is available by the
  140.      H key. The help screen that pops up as you press H is the same that the
  141.      /? or /H command line switch shows.
  142.  
  143.      Keys while the module is being played :
  144.  
  145.        Key        Meaning                              Also in DOS shell
  146.        ---        -------                              -----------------
  147.  
  148.        P          Pauses / resumes the module          alt-F11
  149.        N          Next module                          alt-F12
  150.        H,?        Help screen
  151.        D          DOS shell (with lots of memory!)
  152.        C          Clear the information screen
  153.        S          Toggle SB Pro stereo mode on/off
  154.        F1-F10     Set the master volume
  155.        +,-        Change the master volume one step    shift-F11, shift-F12
  156.        Left,Right Jump to next/previous pattern        ctrl-F11, ctrl-F12
  157.        Up,Down    Scroll module list window
  158.        1,2,..     Turn track on/off
  159.  
  160.  
  161.  
  162.                          Contacting the authors
  163.                          ----------------------
  164.  
  165.        If you have questions or comments about the PMP or the Pascal version
  166.     of the DSMI, contact Jussi Lahdenniemi:
  167.  
  168.        ┌─────────────────────────────────────────────────────────────────────┐
  169.        │                                                                     │
  170.        │   By mail:                                                          │
  171.        │   ────────                                                          │
  172.        │                                                                     │
  173.        │            Jussi Lahdenniemi                                        │
  174.        │            Rautia                                                   │
  175.        │            SF-36420 Sahalahti                                       │
  176.        │            FINLAND                                                  │
  177.        │                                                                     │
  178.        │   Fidonet:                                                          │
  179.        │   ─────────                                                         │
  180.        │            2:222/352.20                                             │
  181.        │   SBC-net:                                                          │
  182.        │   ─────────                                                         │
  183.        │            14:1510/510.20                                           │
  184.        │                                                                     │
  185.        │   InterNet:                                                         │
  186.        │   ──────────                                                        │
  187.        │            jussi.lahdenniemi@p20.f352.n222.z2.fidonet.org           │
  188.        │                                                                     │
  189.        └─────────────────────────────────────────────────────────────────────┘
  190.  
  191.  
  192.  
  193.        To comment about the DMP or the C or ASM versions of the DSMI, contact
  194.     Otto Chrons :
  195.  
  196.        ┌─────────────────────────────────────────────────────────────────────┐
  197.        │                                                                     │
  198.        │   By mail:                                                          │
  199.        │   ────────                                                          │
  200.        │                                                                     │
  201.        │            Otto Chrons                                              │
  202.        │            Pyydyspolku 5                                            │
  203.        │            SF-36200 Kangasala                                       │
  204.        │            FINLAND                                                  │
  205.        │                                                                     │
  206.        │   Fidonet:                                                          │
  207.        │   ─────────                                                         │
  208.        │        2:222/348.10                         │
  209.        │   SBC-net:                                                          │
  210.        │   ─────────                                                         │
  211.        │        14:1510/500.10                         │
  212.        │                                                                     │
  213.        │   InterNet:                                                         │
  214.        │   ──────────                                                        │
  215.        │            c142092@cc.tut.fi (fastest method to contact)            │
  216.        │                                                                     │
  217.        └─────────────────────────────────────────────────────────────────────┘
  218.  
  219.  
  220.  
  221.  
  222.                              For programmers only
  223.                              --------------------
  224.  
  225.  
  226.            PMP was  created with  Borland Pascal 7.0 and  it is  based on
  227.  DSMI routines, so by ordering DSMI interface you could write programs
  228.  with similar capabilities. DSMI is a collection of  routines (for C and
  229.  Turbo/Borland Pascal) that allows programmers to play  modules in the
  230.  background, but unlike any other module player it also allows
  231.  simultaneous sound effects!! Up to 32 channels can be used which means
  232.  that you can have a module and sound effects playing in full stereo (on
  233.  cards which support stereo sound)! DSMI will  be available in March
  234.  1993 and the price should be around 270FMK (about $70). Packet includes
  235.  full documentation (printed), OBJ files & libraries for C version, TPUs
  236.  for Pascal and also some of the source code so you can modify the
  237.  behaviour of DSMI. A demonstration packet will be released when DSMI
  238.  becomes available which will contain more specific information about
  239.  DSMI and its price. It will also have few demos using DSMI. Stay tuned!
  240.