home *** CD-ROM | disk | FTP | other *** search
/ Audio Version 4.94 / audioversion4.94knowledgemediaresourcelibraryoctober1994.iso / msdos / modplay / dmps261b / dmps.doc next >
Text File  |  1993-08-17  |  9KB  |  172 lines
  1.                                 DMPS.DOC                                        
  2.  
  3.              Documentation for the Dual Module Player Shell v2.61b
  4.  
  5.                   Copyright (C) 1993 Toni Nikkanen
  6.                   DMP,DSMI Copyright (C) 1992,1993 Otto Chrons
  7.                   PMP Copyright (C) 1993 Jussi Lahdenniemi and Otto Chrons
  8.  
  9. DS.EXE is a front-end program for the Dual Module Player (DMP.EXE) by
  10. Otto Chrons and the Protected Module Player by Jussi Lahdenniemi and
  11. Otto Chrons. It supports all of the current features of DMP & PMP, and
  12. will be updated whenever new features are added to DMP. It also
  13. understands all the modfile formats DMP 2.61b understands
  14. (MOD,NST,STM,AMF,S3M,669) and some formats DMP 2.61b does not understand
  15. (OKT,WOW). It even works with old revisions of DMP like DMP 1.41 (the
  16. last one which works on a 286) or even DMP 1.0 or DMP 1.30 (all have
  17. been tested :) It handles all kinds of archive types gracefully, making
  18. it a must for every sysop.
  19. DMPS is cardware so you can freely distribute it and I hope you did, as
  20. long as you include this help file with the executable. If you use DMPS
  21. on a regular basis, you are required to send the author a nice postcard
  22. from your homeland.  When you send your postcard, you will become a
  23. registered user, and your name will be added into the REGGED.TXT file.
  24. Also registrations to DMPS will be considered as registrations for my
  25. new module player, which COULD be available at the end of August, but it
  26. might take more time. Become famous by registering DMPS!  (Use
  27. easy-to-read handwriting, if I can't read your name right, I'll use a
  28. random name generator to guess your name. You can also specify to be
  29. Anonymous if you don't want to be that famous)
  30.  
  31.            Requirements:
  32.  
  33.             A 286 or higher processor
  34.             Some memory (having about 40-50kb of free XMS/EMS is
  35.             great)
  36.             A keyboard OR a mouse
  37.             A display capable of 80x25 mode with colors. Hercules/MDA
  38.             support is available, but I don't know if it works. Please
  39.             let me know if it works.
  40.  
  41.            Updates:
  42.  
  43.             You can find the places where you can download latest DMPS
  44.             later in this document. If you don't have access to a modem/
  45.             Internet, send me two diskettes. I will mail the other
  46.             one back to you with the latest DMPS and some modules. The
  47.             other one is for myself to keep, and must be a 3,5" HD
  48.             diskette.
  49.  
  50.  
  51.            Here is the command line syntax:
  52.  
  53.  
  54.            DS [-b] [-?] [-h]
  55.  
  56. Where the optional -b (Bare) switch specifies that DMPS should NOT read
  57. the song names from the modfiles. Very recommendable if you have a slow
  58. disk and lots of mods in the same directory. -? and -h give a
  59. helpscreen. Note that DMPS has an inner limit of 525 modfiles; the rest
  60. will be ignored. Maybe I change this in the future, if somebody with
  61. more than 525 modules in one directory shows up.
  62.  
  63.      Hercules/MDA user(s): Write the following line into your autoexec.bat:
  64.      SET DMP_SHELL=HERCULES
  65.  
  66.  
  67.                                 How to use DMPS
  68.  
  69.  After DMPS has  loaded, it will display a screen with a statusline, 2
  70.  lines of data, a list of modfiles, with the song names and file sizes
  71.  and the currently active switches for the players at the bottom. You
  72.  can move around the list with the arrow keys or the mouse . Space or
  73.  mouse button #3 will tag files, Enter or mouse button #1 will play the
  74.  tagged files with DMP and P or mouse button #2 will play the tagged
  75.  files with PMP , if no files are tagged then the file under the cursor
  76.  will be played. When the shift+numberkeys parameters are used, Enter,
  77.  P, mouse #1 and mouse #2 will play the CURRENT module with the selected
  78.  player. Info about the other keys (Ins,Del,Home ,End,PageUp,PageDown
  79.  ,c,r,d,h, F1-F10) can be seen by pressing h.  You can toggle a VGA mode
  80.  by pressing V. This VGA 80x50 mode will be put on when the player is
  81.  spawned and put off when returning from the player. You can jump to DOS
  82.  Shell by pressing Alt-J. There's a stupid screen saver which activates
  83.  after about 1 minutes of idle time; press any key to exit it. It even
  84.  saves itself, as I noticed later :)
  85.  
  86.                         Configuration file
  87.  
  88.  DMPS features a configuration file. During startup DMPS searches the
  89.  path for DMPSHELL.CFG. An example configfile comes with the
  90.  distribution package, and it can be edited with any normal ASCII
  91.  editor, like The Bingo Editor or MS-Dos EDIT. It contains the extra
  92.  parameters which will be sent to DMP & PMP when playing modules, and
  93.  lines 11-20 are meant for other players. You can add any name, and
  94.  parameters from char 20 to char 100. There are some players installed
  95.  in the example config file. Line 21 contain just one number at the
  96.  start; the rest of the file will be totally ignored. This number is the
  97.  default configuration line which will be used at startup.
  98.  
  99.                         Archive files
  100.  
  101. DMPS supports all known archive types. During startup the archive
  102. files will be shown like modfiles. When you move to an archive file
  103. and press Enter,Mouse#1,Mouse#2 or P, DMPS will make a temp directory,
  104. unarchive the archive there, and display the modules inside. You can
  105. then play the modules like you do with normal modules. Pressing cursor
  106. left or moving to the ".." directory name will exit the archive. DMPS
  107. expects the unarchiving programs to be in path, with these filenames:
  108. ARJ.EXE, PKUNZIP.EXE, LHA.EXE, HA.EXE, HPACK.EXE, LIMIT.EXE, WAU.EXE,
  109. ZOO.EXE, SQZ.EXE, PAH.EXE, ARC.EXE
  110.  
  111.  
  112.  
  113.                            ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  114.                             Contacting the author
  115.                            ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  116.  
  117.        ┌─────────────────────────────────────────────────────────────────────┐
  118.        │                                                                     │
  119.        │   By mail:                                                          │
  120.        │   ────────                                                          │
  121.        │                                                                     │
  122.        │            Toni Nikkanen                                            │
  123.        │            Kymenlaaksonkatu 9 D 47                                  │
  124.        │            SF-48100 Kotka                                           │
  125.        │            FINLAND                                                  │
  126.        │                                                                     │
  127.        │   Fidonet:                                                          │
  128.        │   ─────────                                                         │
  129.        │            2:227/18.2                                               │
  130.        │                                                                     │
  131.        │   InterNet:                                                         │
  132.        │   ──────────                                                        │
  133.        │            tnikkane@clinet.fi (fastest method to contact)           │
  134.        │                                                                     │
  135.        └─────────────────────────────────────────────────────────────────────┘
  136.  
  137.         Newest version is always available at:
  138.  
  139.          Finland:
  140.          Hangar BBBS       +358-51-3758236 24h, V.32bis, CD-rom, many nets, AFN
  141.          Heaven's Gate     +358-24-347743  24h, V.32bis/HST, AFN host, UseNet
  142.          Chaotic Vision    +358-42-14528   24h, V.32bis, Sound-related software
  143.          USA:
  144.          Digital Oxygene   +1-214-414-5041 24H, V.32bis
  145.          ISRAEL:
  146.          The Twilight Zone +972 4 320 556 24h,  v32bis
  147.          FTP:
  148.          ftp.uwp.edu:/pub/msdos/modplayers
  149.          All CABiNET BBS'es (read the CABiNET documents which came with DMP)
  150.  
  151.         **AFN=Another FileNetwork, specializes in NEW Dos & Windows files.
  152.  
  153.         See DMPS.REV for revision history. Thanks to Michael Nithammer
  154.         for enhancement ideas and bugreports, and Olli Männistö for
  155.         continuous harassment.
  156.  
  157.                             ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  158.                              For programmers only
  159.                             ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  160.  
  161.  
  162. DMPS was  created with  Borland C++  3.1. The editor used was  for this
  163. version was SemWare's Qedit 2.15.
  164.  
  165.  
  166. stuff which is not made by me but which I'm using in DMPS:
  167.  
  168. Spawno 4.13 XMS/EMS/Disk swapping routines by Ralf Brown (spwno413.*)
  169. The code for switching to 80x50 was taken from NNANSI source code.
  170.  
  171. The pictures were made with TheDraw 4.61
  172.