DMPS.DOC  Documentation for the Dual Module Player Shell v2.60b Copyright (C) 1993 Toni Nikkanen DMP,DSMI Copyright (C) 1992,1993 Otto Chrons PMP Copyright (C) 1993 Jussi Lahdenniemi and Otto Chrons DS.EXE is a front-end program for the Dual Module Player (DMP.EXE) by Otto Chrons and the Protected Module Player by Jussi Lahdenniemi and Otto Chrons. It supports all of the current features of DMP & PMP, and will be updated whenever new features are added to DMP. It also understands all the modfile formats DMP 2.60b understands (MOD,NST,STM,AMF,S3M,669) and some formats DMP 2.60b does not understand (OKT,WOW). It even works with old revisions of DMP like DMP 1.41 (the last one which works on a 286) or even DMP 1.0 or DMP 1.30 (all have been tested :) It handles all kinds of archive types gracefully, making it a must for every sysop. DMPS is cardware so you can freely distribute it and I hope you did, as long as you include this help file with the executable. If you use DMPS on a regular basis, you are required to send the author a nice postcard from your homeland. When you send your postcard, you will become a registered user, and your name will be added into the REGGED.TXT file. Become famous by registering DMPS! (Use easy-to-read handwriting, if I can't read your name right, I'll use a random generator to guess your name. You can also specify to be Anonymous if you don't want to be that famous) Requirements: A 286 or higher processor Some memory (having about 40-50kb of free XMS/EMS is great) A keyboard OR a mouse A display capable of 80x25 mode with colors. Hercules/MDA support is available, but I don't know if it works. Here is the command line syntax: DS [-b] [-?] [-h] Where the optional -b (Bare) switch specifies that DMPS should NOT read the song names from the modfiles. Very recommendable if you have a slow disk and lots of mods in the same directory. -? and -h give a helpscreen. Note that DMPS has an inner limit of 525 modfiles; the rest will be ignored. Maybe I change this in the future, if somebody with more than 525 modules in one directory shows up. Hercules user(s): Write the following line into your autoexec.bat: SET DMP_SHELL=HERCULES How to use DMPS After DMPS has loaded, it will display a screen with a statusline, 2 lines of data, a list of modfiles, with the song names and file sizes and the currently active switches for the players at the bottom. You can move around the list with the arrow keys or the mouse . Space or mouse button #3 will tag files, Enter or mouse button #1 will play the tagged files with DMP and P or mouse button #2 will play the tagged files with PMP , if no files are tagged then the file under the cursor will be played. When the shift+numberkeys parameters are used, Enter, P, mouse #1 and mouse #2 will play the CURRENT module with the selected player. Info about the other keys (Ins,Del,Home ,End,PageUp,PageDown ,c,r,d,h, F1-F10) can be seen by pressing h. You can toggle a VGA mode by pressing V. This VGA 80x50 mode will be put on when the player is spawned and put off when returning from the player. You can jump to DOS Shell by pressing Alt-J. There's a stupid screen saver which activates after about 1 minutes of idle time; press any key to exit it. Configuration file DMPS features a configuration file. During startup DMPS searches the path for DMPSHELL.CFG. An example configfile comes with the distribution package, and it can be edited with any normal ASCII editor, like The Bingo Editor or MS-Dos EDIT. It contains the extra parameters which will be sent to DMP & PMP when playing modules, and lines 11-20 are meant for other players. You can add any name, and parameters from char 20 to char 100. There are some players installed in the example config file. Line 21 contain just one number at the start; the rest of the file will be totally ignored. This number is the default line which will be used at startup. Archive files DMPS supports all known archive types. During startup the archive files will be shown like modfiles. When you move to an archive file and press Enter,Mouse#1,Mouse#2 or P, DMPS will make a temp directory, unarchive the archive there, and display the modules inside. You can then play the modules like you do with normal modules. Pressing cursor left or moving to the ".." directory name will exit the archive. DMPS expects the unarchiving programs to be in path, with these filenames: ARJ.EXE, PKUNZIP.EXE, LHA.EXE, HA.EXE, HPACK.EXE, LIMIT.EXE, WAU.EXE, ZOO.EXE, SQZ.EXE, PAH.EXE, ARC.EXE ÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜ Contacting the author ßßßßßßßßßßßßßßßßßßßßßßß ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ ³ ³ By mail: ³ ³ ÄÄÄÄÄÄÄÄ ³ ³ ³ ³ Toni Nikkanen ³ ³ Kymenlaaksonkatu 9 D 47 ³ ³ SF-48100 Kotka ³ ³ FINLAND ³ ³ ³ ³ Fidonet: ³ ³ ÄÄÄÄÄÄÄÄÄ ³ ³ 2:227/18.2 ³ ³ ³ ³ InterNet: ³ ³ ÄÄÄÄÄÄÄÄÄÄ ³ ³ tnikkane@clinet.fi (fastest method to contact) ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Newest version is always available at: Finland: Hangar BBBS +358-51-3758236 24h, V.32bis, CD-rom, many nets, AFN Heaven's Gate +358-24-347743 24h, V.32bis/HST, AFN host, UseNet Chaotic Vision +358-42-14528 24h, V.32bis, Sound-related software USA: Digital Oxygene +1-214-414-5041 24H, V.32bis FTP: ftp.uwp.edu:/pub/msdos/modplayers *FOF= Finnish Os/2 File-echo, newest OS/2 files **AFN=Another FileNetwork, specializes in NEW Dos & Windows files. See DMPS.REV for revision history. Thanks to Michael Nithammer and Olli M„nnist” for enhancement ideas and bugreports. ÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜ For programmers only ßßßßßßßßßßßßßßßßßßßßßß DMPS was created with Borland C++ 3.1. The editor used was for this version the Perfect Editor, to try it out, and was finally changed back to Qedit 2.15. My conclusion after the big experiment is that Qedit is still unbeatable. stuff which is not made by me but which I'm using in DMPS: Spawno 4.13 XMS/EMS/Disk swapping routines by Ralf Brown (spwno413.*) The code for switching to 80x50 was taken from NNANSI source code. The pictures were made with TheDraw 4.61 OK, OK, I admit, I HAVE copied the outlook of DMP.EXE, DMP.DOC and DMP.REV, just to integrate DMPS better with DMP :)