home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / sounds / dpp101.zip / DPP.DOC next >
Text File  |  1993-10-08  |  8KB  |  206 lines
  1.  
  2.  
  3.  
  4.                                 DPP.DOC
  5.  
  6.              Documentation for the Digital Player Pro v1.00
  7.  
  8.                   Copyright (C) 1993 Riku Aakkula
  9.  
  10.  
  11.  Digital Player Pro is cardware so you can freely distribute
  12.  it and I hope you do, as long as you include this help file
  13.  with the executable. If you like the product, please send me
  14.  a postcard to the address shown on the endscreen of DPP !
  15.  
  16.  This player uses DSMI playing routines to play music.
  17.  
  18.  
  19.            Here is the command line syntax:
  20.  
  21.            DPP [options] [modulename] [@modlist] [options]
  22.  
  23.        Where:
  24.        ------
  25.        modulename : name of a module (wildcards *,? allowed)
  26.            modlist    : name of a file containing list of module names
  27.  
  28.        options  : -Sxxxx          set sampling rate 4000-44100
  29.                       alternatively 4-44
  30.               -H or -?          show help screen
  31.                       -Ix             IRQ number
  32.                       -Pxxx           port address
  33.               -Dx          DMA channel
  34.               -O          Scramble module order
  35.               -L          Inhibit looping
  36.               -M          Mono mode (SB16 & PAS)
  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.                     7 for Aria cards
  44.  
  45.  If you use some options all the time, you can put them into an
  46.  environment variable dpp:
  47.  
  48.     Example:
  49.  
  50.  You always want to use sampling rate of 22kHz and
  51.  mono mode, put following line into your AUTOEXEC.BAT
  52.  
  53.         SET dpp=-s22 -m
  54.  
  55.  NOTE!  You cannot override single letter options (-l,-o,-m,) with
  56.  command line parameters. All other options can be overridden.
  57.  
  58.  You may have to  give your soundcard's IRQ  number and/or port address
  59.  if dpp fails to find them. If you don't provide both values then dpp
  60.  will assume 220h for port address, and 7 for interrupt number. Giving
  61.  wrong address    will hang  your machine,  but wrong interrupt number
  62.  only stops the playing after a second. The "/C" option is useful if you
  63.  want to use some other card, than the one dpp automatically detects.
  64.  
  65.  You don't  have  to add  any extension  to  the name,  because the
  66.  program will try  extensions AMF, STM, 669, S3M, MOD and  NST if it
  67.  doesn't find the file. Note that you can supply many modulenames and
  68.  list files, up to the internal limit of 1024 modulenames.
  69.  
  70.        Example:
  71.  
  72.            dpp @modlist
  73.  
  74.            modlist is a text file containing following lines:
  75.            harmonic.mod
  76.            cant.s3m
  77.            2unlimit.mod
  78.  
  79.  dpp  will use  the  sampling  rate  of  20KHz  and  play following
  80.  modules: HARMONIC.MOD, CANT.S3M, 2UNLIMIT.MOD.
  81.  
  82.  
  83.                                 How to use dpp
  84.  
  85.  After dpp has  loaded the first  module, it starts  to play it and
  86.  shows some information about it. dpp displays module's  name, its file
  87.  size, the amount of free memory and sampling rate.
  88.  While playing, dpp updates fields showing current
  89.  pattern, row, elapsed time, volume and sampling rate. Under these
  90.  fields are four lines showing the current status of the corresponding
  91.  tracks. Here is an example:
  92.  
  93.  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  94.    Solo_string         ▐▐ F#2  64              ▐▐1.. ■■■■■■■■■■■■■■■■■■■■■
  95.    -----------         ▐▐ D-3  20  ARPEGGIO    ▐▐2.. ■■■■■■■■■■■■■■■
  96.    Greetz_to           ▐▐ E-2  12  PORT.NOTE   ▐▐3.. ■■■■■■
  97.    Matrix_and_Jammer   ▐▐ G-2  57  FINE VOL    ▐▐4.. ■■■■■■■■■■■■■■■■■■
  98.    hello_there         ▐▐ F#2  64              ▐▐5.. ■■■■■■■■■■■■■■■■■■■■■
  99.    by                  ▐▐ D-3  20  VOLUME SLIDE▐▐6.. ■■■■■■■■■■■■
  100.    Nixon /             ▐▐ E-2  12  PORTA TO NOT▐▐7.. ■■■■■■■■■
  101.    Hardware Damage     ▐▐ G-2  57  FINE VOL    ▐▐8.. ■■■
  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.  Under that comes some info about samples. Sample's name, size and
  111.  sampling rate, with which the sample has been sampled.
  112.  
  113.  There are also two little red bars in borders. They indicate the raster time
  114.  taken from the CPU by the playing routine. The shorter they are the faster
  115.  your computer is !
  116.  
  117.  Pressing 'H'  brings up a  quick-help showing  command line options and
  118.  keys used to control the program.
  119.  
  120.            Keys :
  121.           ────────
  122.  
  123.        P        pause module, any key resumes
  124.            1,2,3,...    turn track xx on/off (ascii characters 49-64)
  125.        N        load next module (if you have supplied more than one)
  126.        S        stereo mode on/off (SB Pro), default is on
  127.        left/right    Jump to next/previous pattern
  128.        F1-F10,+,-    set volume
  129.            (,)          Set new speed
  130.            ,,.          Set new tempo
  131.        H        Help screen
  132.            C            Clear information screen
  133.            ESC          exit
  134.  
  135.  
  136.  ---------------- ■■■!!!!! A  T  T  E  N  T  I  O  N !!!!!■■■ ----------------
  137.  
  138.  
  139.  This player doesn't support EMS-memory yet, which means that you can't load
  140.  modules over approx. 480kb. (like PANIC.S3M, RHYTHM.MOD...)
  141.  
  142.  
  143.  -----------------------------------------------------------------------------
  144.  
  145.                            ╔══════════════════════╗
  146.                            ║ Contacting the author║
  147.                            ╚══════════════════════╝
  148.  
  149.        ┌─────────────────────────────────────────────────────────────────────┐
  150.        │                                                                     │
  151.        │   By mail:                                                          │
  152.        │   ────────                                                          │
  153.        │                                                                     │
  154.        │            Riku Aakkula                                             │
  155.        │            Katajakuja 4                                             │
  156.        │            SF-35600 Halli                                           │
  157.        │            FINLAND                                                  │
  158.        │                                                                     │
  159.        │                                                                     │
  160.        │   InterNet:                                                         │
  161.        │   ──────────                                                        │
  162.        │            ra@jybox.jyu.fi (fastest method to contact)              │
  163.        │                                                                     │
  164.        └─────────────────────────────────────────────────────────────────────┘
  165.  
  166.  
  167.  To SYSOPS :
  168.  
  169.  I am looking for a distribution site for DPP. If you are interested in
  170.  having to be a dist. site for DPP contact me !
  171.  
  172.  And finally some greetings :
  173.  
  174.  Jussi Moisio, Riku Pulkkinen, Esa Hyytiä, Jussi Lahdenniemi,
  175.  Otto Chrons, Marko Suovula, Pirkka Palosaari, Kari Sorsimo, Juha Perälä,
  176.  Tero Reunanen, Janne Tuominen, Jukka Sjöstedt, Mikko Valle, Jarkko Finni,
  177.  Sebastian Siukonen, Marko Rautala, Juha Jalas
  178.  and everybody who likes this product !
  179.  
  180. --------------------------------------------------------------------------------
  181.  
  182.  
  183.  TO PROGRAMMERS, GFX ARTISTS and MUSIC MAKERS :
  184.  
  185.  A new group called Hardware Damage has been founded in 5.6.1993. So, we have
  186.  three members and we are looking for some more. If you have superior talents in
  187.  coding, gfx or music contact us !
  188.  
  189.  The address is above !!!!!
  190.  
  191. --------------------------------------------------------------------------------
  192.  
  193.  
  194. ---------------------------- N  O  T  E  ! ! ! ---------------------------------
  195.  
  196.  Due to some financial problems it hasn't been possible to test this product
  197.  with all the soundcards it is supposed to support. If you encounter some
  198.  hardware related problems (or problems of any kind) please send me a detailed
  199.  description of them. I do NOT take any responsibility of any permanent damage
  200.  possibly caused by this program. Don't worry, I haven't encountered any
  201.  problems that serious so far, but still...
  202.  
  203.  The fastest way to contact me is via Internet !
  204.  
  205. --------------------------------------------------------------------------------
  206.