home *** CD-ROM | disk | FTP | other *** search
/ Groovy Bytes: Behind the Moon / groovybytes.iso / GROOVY / SND_TOOL / DMPC230.ZIP / DMPC.DOC < prev    next >
Encoding:
Text File  |  1994-07-06  |  17.6 KB  |  400 lines
  1. ╔╤╤╤╤╤╤╤╤╤══════════════════════════════════════════════════════════╤╤╤╤╤╤╤╤╤╗
  2. ╟┼┼┼┼┼┴┴┴┘░░░░▒▒▒▒▓▓▓▓██████████████████████████████████▓▓▓▓▒▒▒▒░░░░└┴┴┴┼┼┼┼┼╢
  3. ╟┴┴┴┴┘░░░░▒▒▒▒▓▓▓▓████┌────────────────────────────────┐████▓▓▓▓▒▒▒▒░░░░└┴┴┴┴╢
  4. ║░░░░▒▒▒▒▓▓▓▓████ ·∙──┤  Dual Module Player Companion  ├──∙· ████▓▓▓▓▒▒▒▒░░░░║
  5. ╟┬┬┬┬┐░░░░▒▒▒▒▓▓▓▓████└────────────────────────────────┘████▓▓▓▓▒▒▒▒░░░░┌┬┬┬┬╢
  6. ╟┼┼┼┼┼┬┬┬┐░░░░▒▒▒▒▓▓▓▓██████████████████████████████████▓▓▓▓▒▒▒▒░░░░┌┬┬┬┼┼┼┼┼╢
  7. ╚╧╧╧╧╧╧╧╧╧═════════════════╤══════════════════════╤═════════════════╧╧╧╧╧╧╧╧╧╝
  8.                            │  ⌐  Version 2.30  ¬  │
  9.                         ┌──┴──────────────────────┴──┐
  10.                         │ (C) 1994 Psychic Psoftware │
  11.                         └────────────────────────────┘
  12.  
  13.   Contents  ■ ┌─────────────────────────────────────────────────-─--∙∙··· ·
  14. ─────────────────┘
  15.  
  16.   ■ Introduction
  17.   ■ Features
  18.   ■ Where to find new versions
  19.   ■ Mailing lists
  20.   ■ List of keys
  21.   ■ Sample Ripper
  22.   ■ Configuration
  23.   ■ Limitations
  24.   ■ Thanks
  25.   ■ To do
  26.   ■ Where to contact me
  27.  
  28.  
  29.   Introduction  ■ ┌─────────────────────────────────────────────-─--∙∙··· ·
  30. ─────────────────────┘
  31.  
  32. ■ This program is CARDWARE/SMILEWARE, that is, you may distribute it freely as
  33.   long as you don't charge any fee for it and if you want to continue using it,
  34.   please send me a postcard of your hometown (or a letter with a picture of your
  35.   hometown included).
  36.  
  37. ■ DMPC was written as a front end for the Dual Module Player ((C) 1992, 1993,
  38.   1994 Otto Chrons).  DMPC was originally coded just before I had to write an
  39.   examination, so don't expect miracles (not big ones anyway).  It was designed
  40.   to be small and fast rather than big and flashy... and with all the additions
  41.   over the last year or so it's getting more flashy (and fast!).  Hopefully this
  42.   will make using the command-line driven DMP (an excellent product) easier to
  43.   use.  In fact it should make using any command-line driven program absolute
  44.   heaven (NB. I'm the author, I like my program *8).
  45.  
  46. ■ You might like to know that DMPC is over one year old now with an estimated
  47.   user-base of thousands.  What I can't figure out is: If everyone loves my
  48.   program and wants me to add new stuff where are all my postcards?  Maybe
  49.   they can't afford (approx) $2 to buy a postcard and some stamps?  I know it's
  50.   a rather petulant thing to do, but I'm not adding/changing anything in DMPC
  51.   until I get some postcards.  I've been keeping up my end of the bargain by
  52.   providing you with one of the best (if not the best) front-ends that is
  53.   tailored to your needs, now you do something to keep up your end.
  54.  
  55.  
  56. ■ Legal stuff: If this program does anything that is antisocial to your 
  57.                computer, hey, shit happens.... and I'm not responsible.
  58.  
  59.  
  60.   Features  ■ ┌─────────────────────────────────────────────────-─--∙∙··· ·
  61. ─────────────────┘
  62.  
  63.   ■  Supports: ANY FORMAT YOU WANT!!
  64.  
  65.   ■  You can use virtually any player you want!
  66.  
  67.   ■  Reads multiple directories at startup.
  68.  
  69.   ■  Sample preview & ripper for MOD, S3M, 669, MTM, ULT, FAR, STM & AMF files.
  70.  
  71.   ■  Piano-style layout for the preview functions.
  72.  
  73.   ■  Rip samples to signed SMP, unsigned SAM, Windows WAVE, Creative Voice,
  74.       Sounder/SoundTool, Scream Tracker 3, Farandole Composer and Tetra Music
  75.       Editor formats.
  76.  
  77.   ■  Preview sample on GUS, PAS, SoundBlaster, Tandy, LPT DAC or Speaker.
  78.  
  79.   ■  Support for ARJ, LHA, ZIP, LIMIT, HA, HYPER, HPACK, SQZ, ZOO, PAK, ARC and
  80.       UltraCompressor II (rel 2) archives.
  81.  
  82.   ■  Description file for archived files.
  83.  
  84.   ■  Configure up to 30 players.
  85.  
  86.   ■  Built in screen saver.
  87.  
  88.   ■  Mouse support.
  89.  
  90.   ■  Reads the directory much faster than ModPlay v2.19b ((C) Mark Cox).
  91.  
  92.   ■  Logfile that makes DMPC startup approx. 85% faster than usual.
  93.  
  94.   ■  Reads up to 2000 music files.
  95.  
  96.   ■  Listfile support (@DMPC.LST)
  97.  
  98.   ■  Play a list of files sequentially or in random order.
  99.  
  100.   ■  Switch between 25 and 43/50 line modes.
  101.  
  102.   ■  Load/Save tagged selection.
  103.  
  104.   ■  Change drive/directory.
  105.  
  106.   ■  Fast file find with partial matching.
  107.  
  108.   ■  Extract to temp directory.
  109.  
  110.   ■  Delete files/all tagged files.
  111.  
  112.   ■  Tag/untag by file extension.
  113.   
  114.  
  115.   New Versions  ■ ┌─────────────────────────────────────────────-─--∙∙··· ·
  116. ─────────────────────┘
  117.  
  118.   Can always be found at:
  119.  
  120.   » ftp.sun.ac.za             /pub/msdos/audio/local
  121.   » ftp.wustl.edu             /pub/msdos_uploads/modplayers
  122.   » archive.epas.utoronto.ca  /pub/pc/ultrasound/submit
  123.   » ftp.uwp.edu               /pub/incoming/modplayers OR pub/msdos/modplayers
  124.  
  125.  
  126.  -=> Read DMPC.BBS for a list of official DMPC distribution/support sites <=-
  127.  
  128.  
  129.   Mailing Lists ■ ┌─────────────────────────────────────────────-─--∙∙··· ·
  130. ─────────────────────┘
  131.  
  132. Thanks to Pieter Immelman, I now have two mailing lists for DMPC.
  133.  
  134. » The first list is DMPC-LIST which is a list aimed at distributing the latest
  135.   version of DMPC to people who don't have FTP access (and to Sysops of BBSes
  136.   that are DMPC support sites and need DMPC as fast as possible).  To subscribe
  137.   to DMPC-LIST, send a mail message to listserver@oliver.sun.ac.za with the body
  138.   of the message being: SUBSCRIBE DMPC-LIST <YOUR-NAME>
  139.  
  140.   Please fill your name in where I've put <YOUR-NAME> and don't include the <>
  141.   on either side (yes folks, it does happen!).
  142.  
  143.   Conditions for DMPC-LIST
  144.   ------------------------
  145.   DO NOT subscribe to this list if a) you mailer can't handle incoming messages
  146.   larger than 64Kb or b) you have access to any FTP sites that carry DMPC (see
  147.   the list above).
  148.  
  149.  
  150. » The second list is DMPC-TALK which is a talk list, anybody is free to join.
  151.   This list is for discussion about future additions, bug reports etc in/on the
  152.   DMPC music player shell/sample ripper.  To subscribe to the DMPC talk list,
  153.   send a mail message to listserver@oliver.sun.ac.za with a the body of the
  154.   message being: SUBSCRIBE DMPC-TALK <YOUR-NAME>
  155.  
  156.  
  157.   Keys  ■ ┌─────────────────────────────────────────────────────-─--∙∙··· ·
  158. ─────────────┘
  159.      
  160.      Up and down scroll through the list of music files.
  161.      PG UP Move one page up
  162.      PG DN Move one page down
  163.       HOME Go to start of list
  164.        END Go to end of list
  165.      ENTER play the file OR changes to the directory.
  166.      SPACE will tag/untag a file.
  167.          T tags all.
  168.          U untags all.
  169.          D delete current file.
  170.          P plays all tagged files in order or if there are no tagged files, it
  171.            will act like ENTER.
  172.          R does the same as P except that it specifies random selection.
  173.          O plays one of the tagged files randomly and untags it.
  174.          S Save current tagged selection to file.
  175.          L Load a tag selection from file (clears previous tagged selection).
  176.          . Re-read current directory.
  177.          , Toggle scanning of directories in DMPC.DIR on/off.
  178.          / Toggle between manual directory reading and reading DMPC.LOG
  179.          V Toggle screen mode between 25 and 43/50 (if possible).
  180.          C Change drive.
  181.          F Find a music file by name.
  182.          X Export descriptions to DMPC.DSC
  183.          I Edit a description from the file selection menu.
  184.         F1 Display help page.
  185.       1..0 Select config  1-10
  186.   ALT-1..0 Select config 11-20
  187. SHIFT-1..0 Select config 21-30
  188.   ALT-A..Z Jump to music files beginning with that letter.
  189.        F10 Shell to DOS
  190.     CTRL-L Write all information about files to DMPC.LOG
  191.     CTRL-C Change to directory on current drive.
  192.     CTRL-D Delete all tagged files.
  193.     CTRL-R Go into the sample ripper/previewer
  194.     CTRL-T Tag all files with certain file extension.
  195.     CTRL-U Untag all files with certain file extension.
  196.  
  197.  
  198. ■ When writing DMPC.LOG, only the current information will be saved, ie. files
  199.    not in the file selection list will not be in the logfile. If DMPC.LOG isn't
  200.    found at startup with USE_LOGFILE=TRUE, DMPC will read the directories in the
  201.    normal manner.  If you change to a drive/directory that isn't represented in
  202.    the logfile, DMPC will read it manually.
  203.  
  204. ■ For players without a listfile capability: When your tagged selection includes
  205.    archived files, DMPC will de-archive and play them one at a time (for disk
  206.    space reasons) randomly or sequentially.  If DMPC is controlling the
  207.    selection play then pressing N in DMP will not take you to the next file
  208.    in the selection (for obvious reasons) but if you press ESC it will play the
  209.    next file.  Press ESC twice in fast succession if you want to quit a DMPC
  210.    controlled selection (and I mean fast!).
  211.  
  212. ■ For players with listfile capability: When your tagged selection includes
  213.    archived files, DMPC will de-archive all the archived files in the list and
  214.    then pass control to the player (make sure you have the space!).  After the
  215.    player finishes playing the selection DMPC will remove all the de-archived
  216.    archive files from your temp diretory.
  217.  
  218. ■ If you have a mouse, moving the mouse up and down will do the same as the up
  219.    and down arrow keys.  The left button emulates P and the right button
  220.    emulates SPACE.
  221.  
  222.  
  223.   Sample Ripper  ■ ┌────────────────────────────────────────────-─--∙∙··· ·
  224. ──────────────────────┘
  225.  
  226. In the sample ripper you have a new set of functions mapped to the keys.  You
  227. can use the cursor keys to move to the different samples.  If you want to
  228. preview the samples, try and use a DAC, SoundBlaster,  PAS or GUS because the
  229. samples sound really lousy through the PC Speaker.  You can only preview up to
  230. 64k, therefore if a sample is bigger than 64k, you'll only hear up to the 64k
  231. mark.  The ripper, however, can rip the samples even if they're bigger than 64k.
  232. MTM, FAR and ULT support now includes pseudo support for 16 bit samples.  I cut
  233. the sample to 8 bits to play it, 16 bit samples can (for now) only be saved in
  234. SAM, SMP, FSM or Windows WAVE format.  The unsigned raw sample is saved in a
  235. FastTracker v1.x compatible format.
  236.  
  237. Config options:  RIPPER_DIR is the directory where you want DMPC to save your
  238.                    samples to.
  239.                  RIPPER_DEVICE tells DMPC what device it will be using, valid
  240.                    options are GUS, PAS, SoundBlaster, DAC and Speaker.
  241.                  RIPPER_PORT is the port that DMPC will play the sample through.
  242.                  RIPPER_DMA specifies what DMA channel to use for the
  243.                    SoundBlaster.
  244.  
  245. DMPC finally has a proper keyboard-style layout for the frequencies and is using
  246. the 110 x 2^(n / 12) formula for the frequency scale.  The new layout (which is
  247. exactly the same as Scream Tracker 3's) can be seen below. 'Z' starts at C3 and
  248. 'P' ends on an E5.  All of these keys will change the frequency and then play
  249. the sample.  Samples are only loaded if you want to play a different sample to
  250. the last used one.  People using a DAC or the PC Speaker will have to wait for
  251. the complete sample to play before they can select the next note etc.  All other
  252. (supported) soundcards should allow you to stop a sample at any time.
  253.  
  254.  
  255.  
  256. Actual note:       C# D#    F# G# A#    C# D#    F# G# A#    C# D#
  257.                 │ │ ││ │ │ │ ││ ││ │ │ │ ││ │ │ │ ││ ││ │ │ │ ││ │ │
  258.                 │ │ ││ │ │ │ ││ ││ │ │ │ ││ │ │ │ ││ ││ │ │ │ ││ │ │
  259.                 │ │S││D│ │ │G││H││J│ │ │2││3│ │ │5││6││7│ │ │9││0│ │
  260.                 │ └┬┘└┬┘ │ └┬┘└┬┘└┬┘ │ └┬┘└┬┘ │ └┬┘└┬┘└┬┘ │ └┬┘└┬┘ │
  261.                 │ Z│ X│ C│ V│ B│ N│ M│ Q│ W│ E│ R│ T│ Y│ U│ I│ O│ P│
  262.                 └──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┘
  263. Actual note:      C  D  E  F  G  A  B  C  D  E  F  G  A  B  C  D  E
  264.  
  265.  
  266.  
  267.   ENTER  Play a sample (8 bit or pseudo 16 bit) at current frequency.
  268.  CTRL-R  8 or 16 bit signed format (SMP)
  269.  CTRL-U  8 or 16 bit unsigned format (SAM)
  270.  CTRL-S  SoundTool format (SND)
  271.  CTRL-W  Windows WAVE format (WAV)
  272.  CTRL-V  Creative Voice format (VOC)
  273.  CTRL-C  Scream Tracker 3 sample format (8 or 16 bit SMP)
  274.  CTRL-F  Farandole Composer sample format (8 or 16 bit FSM)
  275.  CTRL-T  Tetra Module Editor sample format (SPL)
  276.    HOME  Move to first sample
  277.     END  Move to last sample
  278.     ESC  Go back to DMPC menu.
  279.  
  280.  
  281. PLEASE NOTE: The ripper supports MOD, S3M, 669, STM, MTM, ULT, AMF and FAR files
  282.              FAR & ULT ripping should now work properly.  Trying to rip unknown
  283.              formats will produce garbage & maybe crash DMPC!  I'm working on
  284.              the other formats (what other formats are there now?), but don't
  285.              hold your breath... I need format specs!!  Please send me the specs
  286.              for whatever formats you can get your hands on!!
  287.  
  288. Can anyone with information on how to play digital samples through the Adlib
  289. range of cards please send it to me?  Same goes for any other card you would
  290. like supported, send me the info I need and I'll try add it for you.
  291.  
  292.  
  293.   Configuration  ■ ┌────────────────────────────────────────────-─--∙∙··· ·
  294. ──────────────────────┘
  295.  
  296. ■ DMPC has a config file (DMPC.CFG) for the command-line switches that you would
  297. use when loading your modplayer.  It can have multiple devices and players and
  298. follows the MS Windows (TM) (yech!) INI type format.  Many of the options are
  299. defaulted for ease of use.  See DMPC.CFG for an illustration of the format.  The
  300. device name can be up to 30 characters long, options 40 characters and the
  301. player definitions can be up to 60 characters long.  The file inclusion mask is
  302. a list of characters that represent the different formats that a player can
  303. play (see DMPC.FMT for more info).
  304.  
  305. ■ DMPC will search the path for ARJ.EXE, LHA.EXE, etc. and DMPC.CFG, if it can't
  306. find DMPC.CFG in the path, current directory or the directory where DMPC.EXE was
  307. executed from it will take -p42 -c6 (PC SPEAKER!! <--- Yech!) and DMP as the
  308. default.  If ARJ.EXE cannot be found (using the same search technique as for
  309. DMPC.CFG), DMPC will not search ARJ files for music files (similarly for the
  310. other archivers).  When a file occurs uncompressed and in an archive, only the
  311. uncompressed file is shown in the list of available music.
  312.  
  313.  
  314.   Limitations ■ ┌────────────────────────────────────────────────-─--∙∙··· ·
  315. ───────────────────┘
  316.  
  317.   ■ If you don't have EMS on your machine, DMPC will crawl when you try to play
  318.     anything 'cause it will be swapping to disk.  A RAM disk as the swap dir
  319.     will improve things.
  320.   ■ You can only use up to 2000 music files.
  321.   ■ Samples on DAC/Speaker can't be cut short like on SB/GUS/PAS.
  322.   ■ DMPC will not work on Hercules displays.
  323.   ■ Sub-directories in archives are not supported.
  324.   ■ The sample preview on PC Speaker sounds lousy, but it always does...
  325.  
  326.    »»  Now stop reading this dumb DOC and go and play some music! *8)  ««
  327.  
  328.  
  329.   Thanks to  ■ ┌────────────────────────────────────────────────-─--∙∙··· ·
  330. ──────────────────┘
  331.  
  332.  ∙ Otto Chrons for writing DMP/PMP and sending me information about his AMF
  333.     format.  Ask him about DSMI (what DMP was written with).
  334.  ∙ Robert Jung for the tech info about ARJ files in UNARJ230.EXE
  335.  ∙ Thomas Wagner for his PD swapout routine.
  336.  ∙ Thayne Breetzke for his advice and positive criticism (and an email address).
  337.  ∙ Bryan Kilian for helping me get DMPC from just an idea into such a popular
  338.     program (not to mention helping with the code some of the time!).
  339.  ∙ Rory Freeman for various helpful routines.
  340.  ∙ Sand (K. Sunley) for designing a really cool ANSI screen for DMPC.
  341.  ∙ Mark Adler for sending me the ZIP header format.
  342.  ∙ Toni Nikkanen for becoming a registered DMPC user... *8)
  343.  ∙ All the people who have responded so positively (and negatively?) to DMPC!
  344.  ∙ My friends on IRC for suggesting new features & functions.
  345.  ∙ Ashton Mills for making this doc more readable.
  346.  ∙ Daniel Nicholson for giving me ideas on how to implement the ripper.
  347.  ∙ VangelisTeam's Tracker source... I learnt some things in there!
  348.  ∙ Jeff Bird & the SoundBlaster Freedom Project (even though I had to do some
  349.     really weird corrections to the code to get it to work!).
  350.  ∙ Necros of The Psychic Monks for forcing me to put S3M ripping routines into
  351.     DMPC and for No Memories II.
  352.  ∙ Worx (Roger Moe) for helping me fix the bugs in the timer polling routine of
  353.     the DAC/Speaker sample previewer.
  354.  ∙ Nocturnus for finding the format specs for MTM, FAR & ULT for me.
  355.  ∙ Stephen Retzlaff for making me add the listfile code & the fast find.
  356.  ∙ Sunny Woo for helping me debug, test & improve DMPC.
  357.  ∙ Advanced Gravis Technology for their SDK.
  358.  ∙ AIP-NL for providing information about UltraCompressor II.
  359.  ∙ Thomas Varsamidis for helping me make the sample previewer better.
  360.  ∙ Jeffrey L Hayes for producing the Tandy DAC guide.
  361.  
  362.  
  363.   To do  ■ ┌────────────────────────────────────────────────────-─--∙∙··· ·
  364. ──────────────┘
  365.   
  366.  - Any other archivers you want supported?  Are there any other archivers?
  367.  
  368.  - Support other soundcards?  (ARIA, WSS, Adlib?)
  369.  
  370.  - Add support for more formats in the ripper... all I need now are the format
  371.     specs and I'll add them!
  372.  
  373.  - I need a swapper that supports EMS/XMS/Disk, can anybody help?
  374.  
  375.  » If you can think of anything else you want to see in future releases, just
  376.    pop me some email at the address mentioned below.
  377.  
  378.  
  379.   Contact moi at  ■ ┌───────────────────────────────────────────-─--∙∙··· ·
  380. ───────────────────────┘
  381.  
  382.   ∞ email :
  383.        9216189@ml.petech.ac.za
  384.     OR wmeier@lark.ru.ac.za
  385.     OR brad@canopus.ru.ac.za (During June/July 94 only)
  386.  
  387.        These are not my own accounts so please mark the messages clearly with
  388.        DMPC in the title (for the mail filter).
  389.  
  390.   ∞ snail-mail:
  391.        -> DMPC <-
  392.        Brad Meier
  393.        8 Jasmay PLace
  394.        Nahoon Valley
  395.        East London
  396.        5241
  397.        Sunny South Africa
  398.  
  399. ──────────────────────────────────────────────────────────────────────────────
  400.