home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / r / rmp230.zip / DMP.DOC < prev    next >
Text File  |  1993-03-06  |  9KB  |  200 lines
  1.  
  2.  
  3.                                    DMP.DOC
  4.  
  5.         Documentation for the Dual Module Player v2.10
  6.  
  7.             Copyright (C) 1992,1993 Otto Chrons
  8.  
  9.  
  10.  DMP.EXE is  a program    demonstrating the  capabilities of the DSMI
  11.  programming interface (DSMI stands for Digital Sound & Music
  12.  Interface). It's a standalone module  player with  which  you can play
  13.  STM-files  as well  as Amiga modules (MOD or NST). DMP is freeware so
  14.  you  can freely distribute  it and I hope you did, as long as you
  15.  include this help file with the executable.
  16.  
  17.            Here is the command line syntax:
  18.  
  19.            DMP [options] [modulename] [@listfile] [options]
  20.  
  21.            Where:
  22.            ------
  23.        modulename : name of a module (wildcards *,? allowed)
  24.        listfile   : name of a file containing list of module names
  25.  
  26.        options  : -Sxxxx          set sampling rate 4000-44100
  27.                       alternatively 4-44
  28.                       DON'T USE HIGHER THAN 21kHz ON A SB
  29.               -H or -?          show help screen
  30.               -Ix          interrupt number
  31.               -Pxxx          port address
  32.               -Dx          DMA channel
  33.               -O          Scramble module order
  34.               -L          Inhibit looping
  35.               -M          Mono mode (SB16 & PAS)
  36.               -Q          Quality mode (on 8-bit cards only)
  37.                       -Cx             Desired card where x is:
  38.                     1 for Sound Blaster
  39.                     2 for Sound Blaster Pro
  40.                     3 for PAS+
  41.                     4 for PAS16
  42.                     5 for SB16
  43.                     6 for general DAC (Covox)
  44.               -T[xxx]          Buffer size xxx (0-32000)
  45.  
  46.  If you use some options all the time, you can put them into an
  47.  environment variable DMP:
  48.  
  49.     Example:
  50.  
  51.  You always want to use quality mode and sampleing rate of 22kHz and
  52.  mono mode, put following line into your AUTOEXEC.BAT
  53.  
  54.     SET DMP=-q -s22 -m
  55.  
  56.  NOTE!    You cannot override single letter options (-l,-o,-m,-q) with
  57.  command line parameters. All other options can be overriden.
  58.  
  59.  You may have to  give your soundcard's IRQ  number and/or port address
  60.  if DMP fails to find them. If you don't provide both values then DMP
  61.  will assume 220h for port address, and 7 for interrupt number. Giving
  62.  wrong address    will hang  your machine,  but wrong interrupt number
  63.  only stops the playing after a second. The "/C" option is useful if you
  64.  want to use some other card, than the one DMP automatically detects.
  65.  
  66.  You don't  have  to add  any extension  to  the name,  because the
  67.  program will try  extensions AMF, STM, MOD and  NST if it  doesn't find
  68.  the file. Note that you can supply many modulenames and list files, up
  69.  to the internal limit of 50 modulenames.
  70.  
  71.            Example:
  72.  
  73.        DMP beyond -s20 *.NST @goodmods
  74.  
  75.            goodmods is a text file containing following lines:
  76.            occ-san
  77.            stars
  78.            intro3
  79.  
  80.  DMP  will use    the  sampling  rate  of  20KHz    and  play following
  81.  modules: BEYOND.MOD,  OCC-SAN.STM, STARS.MOD, INTRO3.MOD  and all
  82.  .NST-files in the current directory.
  83.  
  84.  
  85.                                 How to use DMP
  86.  
  87.  After DMP has    loaded the first  module, it starts  to play it and
  88.  shows some information about  it. DMP displays module's  name, its file
  89.  size, the amount of  memory used for module and sampling rate.  Because
  90.  of the AMP's Intelligent Module Loader  (IML) modules  usually take
  91.  10-30% less  space. I've  seen a 244Kb module shrink into 151Kb when I
  92.  loaded it with DMP. While playing, DMP updates fields showing current
  93.  pattern, row, elapsed time, volume and sampling rate. Under these
  94.  fields are four lines showing the current status of the corresponding
  95.  tracks. Here is an example:
  96.  
  97.  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  98.    bassdrum            │ F#2 │ 64 │               │ ■■■■■■■■■■■■■■■■■■■■■
  99.    strings7            │ D-3 │ 20 │ ARPEGGIO      │ ■■■■■■■■■■■■■■■
  100.    guitar42            │ E-2 │ 12 │ PORT.NOTE     │ ■■■■■■■■■■■
  101.    guitar44            │ G-2 │ 57 │ FINE VOL      │ ■■■■■■■■■■■■■■■■■■
  102.  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  103.  
  104.  The first  field shows  the instrument  currently playing  on that
  105.  track. Second is the note value, third its volume and fourth indicates
  106.  what special command is running. The bar simulates a VU  meter on music
  107.  equipment, but you shouldn't take it  as  an exact  representation of
  108.  the music  level, it's there because it looks nice!
  109.  
  110.  The rest of the screen is filled with instrument names. The numbers before an
  111.  instrument name indicate the channels that instrument is playing on.
  112.  
  113.  Pressing 'H'  bring up a  quick-help showing  command line options and
  114.  keys used to control the program.
  115.  
  116.            Keys :
  117.           ────────
  118.  
  119.        P        pause/resume module
  120.        1-8        turn track on/off
  121.        D        DOS shell (write EXIT to get back)
  122.        N        load next module (if you have supplied more than one)
  123.        S        stereo mode on/off (SB Pro), default is on
  124.        arrrows    Jump to next/previous pattern
  125.        F1-F10,+,-    set volume
  126.        ESC        exit
  127.  
  128.                             ┌─────────────┐
  129.                             │  N  E  W  ! │
  130.                             └─────────────┘
  131.  
  132.  DMP now supports new module format called AMF (Advanced Module Format),
  133.  which is actually the same format DMP uses internally. Therefore
  134.  modules using this format tend to be a lot smaller than with normal STM
  135.  or MOD format. Remember, that you cannot convert modules from AMF back
  136.  to STM or MOD! Use M2AMF.EXE to convert STMs or MODs.
  137.  
  138.  Try this module player  with all the modules  you have, and if you
  139.  encounter problems with any modules, inform the author. Have fun.
  140.  
  141.  
  142.                            ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  143.                             Contacting the author
  144.                            ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  145.  
  146.        ┌─────────────────────────────────────────────────────────────────────┐
  147.        │                                                                     │
  148.        │   By mail:                                                          │
  149.        │   ────────                                                          │
  150.        │                                                                     │
  151.        │            Otto Chrons                                              │
  152.        │            Pyydyspolku 5                                            │
  153.        │            SF-36200 Kangasala                                       │
  154.        │            FINLAND                                                  │
  155.        │                                                                     │
  156.        │   Fidonet:                                                          │
  157.        │   ─────────                                                         │
  158.        │        2:222/348.10                         │
  159.        │   SBC-net:                                                          │
  160.        │   ─────────                                                         │
  161.        │        14:1510/500.10                         │
  162.        │                                                                     │
  163.        │   InterNet:                                                         │
  164.        │   ──────────                                                        │
  165.        │            c142092@cc.tut.fi (fastest method to contact)            │
  166.        │                                                                     │
  167.        └─────────────────────────────────────────────────────────────────────┘
  168.  
  169.         Newest version is always available at:
  170.  
  171.        ┌─────────────────────────────────────────┐
  172.        │ R.A. LAW      +358-37-49007    24h     │
  173.        │ Express      +358-31-236069   24h     │
  174.        │ Moonlight shadow +358-0-3882575   24h     │
  175.        └─────────────────────────────────────────┘
  176.  
  177.     See CABINET.DMP for a list of DMP support sites in Finland.
  178.  
  179.         See DMP.REV for revision history.
  180.  
  181.                             ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  182.                              For programmers only
  183.                             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  184.  
  185.  
  186.  DMP was  created with    Borland C++  3.1 and  it is  based on DSMI's
  187.  routines, so by ordering DSMI interface you could write programs with
  188.  similar capabilities. DSMI is a collection of    routines (for C and
  189.  Turbo Pascal) that allows programmers to play    modules in the
  190.  background, but unlike any other module player it also allows
  191.  simultaneous sound effects!! Up to 32 channels can be used which means
  192.  that you can have a module and sound effects playing in full stereo (on
  193.  cards which support stereo sound)! DSMI will  be available in March
  194.  1993 and the price should be around 270FMK (about $70). Packet includes
  195.  full documentation (printed), OBJ files & libraries for C version, TPUs
  196.  for Turbo Pascal and also some of the source code so you can modify the
  197.  behaviour of DSMI. I will release a demonstration packet when DSMI
  198.  becomes available which will contain more specific information about
  199.  DSMI and its price. It will also have few demos using DSMI. Stay tuned!
  200.