DMP32.DOC Documentation for the Dual Module Player/32 v2.90 Copyright (C) 1994 Otto Chrons DMP32.EXE is a program demonstrating the capabilities of the DSMI/32 programming interface (DSMI stands for Digital Sound & Music Interface). It's a standalone module player running in 32-bit protected mode with which you can play STM, S3M, 669, FAR and MTM files as well as Amiga modules (MOD or NST). DMP32 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 like the product, please send me a postcard to the address shown on the endscreen of DMP32!! Here is the command line syntax: DMP32 [options] [modulename] [@listfile] [options] Where: ------ modulename : name of a module (wildcards *,? allowed) listfile : name of a file containing list of module names options : -Sxxxx set sampling rate 4000-44100 alternatively 4-44 -H or -? show help screen -Ix interrupt number -Pxxx port address (use 42 for PC speaker) -Dx DMA channel -O Scramble module order -L Inhibit looping -M Mono mode (SB16 & PAS) -Q Quality mode (on 8-bit cards only) -Cx Desired card where x is: 1 for Sound Blaster 2 for Sound Blaster Pro 3 for PAS+ 4 for PAS16 5 for SB16 8 for Windows Sound System & compat. (like AudioTrix Pro) 9 for Gravis Ultrasound -Txxx Buffer size xxx (0-32000) -E Disable extended tempos (MOD only) -Axxx Amplify by xxx, 31 is normal volume -B Disable EMS usage -8 Force an 16-bit card into 8-bit mode (works with Aria, PAS16 and WSS) -Nxx Set default panning to xx (0-63,100) 100 = Surround sound -W[command] Automatic DOS shell, executes optional 'command'. -Zxx Use 25/50 row display -X Quiet screen mode. DMP32 writes nothing on the screen -G Use non-DMA download mode for GUS If you use some options all the time, you can put them into an environment variable DMP32: Example: You always want to use quality mode and sampleing rate of 22kHz and mono mode, put following line into your AUTOEXEC.BAT SET DMP32=-q -s22 -m NOTE! You cannot override single letter options (-l,-o,-m,-q) with command line parameters. All other options can be overriden. Alternatively you can use the CmdLine parameter in DMP32.INI for same purpose. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³You may have to give your soundcard's IRQ number and/or port address ³ ³if DMP32 fails to find them. If you don't provide both values then DMP32 ³ ³will assume 220h for port address, and 7 for interrupt number. Giving ³ ³wrong address will hang your machine, but wrong interrupt number ³ ³only stops the playing after a second. The "/C" option is useful if you ³ ³want to use some other card, than the one DMP32 automatically detects. ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ You don't have to add any extension to the name, because the program will try extensions MTM, AMF, STM, 669, S3M, FAR, MOD and NST if it doesn't find the file. Note that you can supply many modulenames and list files. Example: DMP32 beyond -s20 *.NST @goodmods goodmods is a text file containing following lines: occ-san stars intro3 DMP32 will use the sampling rate of 20KHz and play following modules: BEYOND.MOD, OCC-SAN.STM, STARS.MOD, INTRO3.MOD and all .NST-files in the current directory. DMP32 has also a config file called DMP32.INI. It should be placed in the same directory with DMP32.EXE but DMP32 will also find it if it's somewhere in the PATH. See the file itself for explanations on config switches and strings. You can also play modules inside archives by specifying in DMP32.INI how to extract files from the archive. How to use DMP32 After DMP32 has loaded the first module, it starts to play it and shows some information about it. DMP32 displays module's name, its file size, the amount of memory used for module and sampling rate. Because of the AMP's Intelligent Module Loader (IML) modules usually take 10-30% less space. I've seen a 244Kb module shrink into 151Kb when I loaded it with DMP32. While playing, DMP32 updates fields showing current pattern, row, elapsed time, volume and sampling rate. Under these fields are four lines showing the current status of the corresponding tracks. Here is an example: ÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜ bassdrum ³ F#2 ³ 64 ³ ³ þþþþþþþþþþþþþþþþþþþþþ strings7 ³ D-3 ³ 20 ³ ARPEGGIO ³ þþþþþþþþþþþþþþþ guitar42 ³ E-2 ³ 12 ³ PORT.NOTE ³ þþþþþþþþþþþ guitar44 ³ G-2 ³ 57 ³ FINE VOL ³ þþþþþþþþþþþþþþþþþþ ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß The first field shows the instrument currently playing on that track. Second is the note value, third its volume and fourth indicates what special command is running. The bar simulates a VU meter on music equipment, but you shouldn't take it as an exact representation of the music level, it's there because it looks nice! The rest of the screen is filled with instrument names. The numbers before an instrument name indicate the channels that instrument is playing on. Pressing 'H' brings up a quick-help showing command line options and keys used to control the program. Keys : ÄÄÄÄÄÄÄÄ P pause module, any key resumes 1-9 turn track xx on/off 0 turn selected track on/off D DOS shell (write EXIT to get back) N load next module (if you have supplied more than one) S stereo mode on/off (SB Pro), default is on F filter on/off (SB Pro), default is off left/right Jump to next/previous pattern up/down select track F1-F10,+,- set volume [,] Set new speed {,} Set new tempo V Real/fake volume bars L,M,R,U Panning full left/mid/right/surround , . Panning left/right Z Switch between 25- and 50-row display H Help screen ESC exit Try this module player with all the modules you have, and if you encounter problems with any modules, inform the author. Have fun. ÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜ Contacting the author ßßßßßßßßßßßßßßßßßßßßßßß ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ ³ ³ By mail: ³ ³ ÄÄÄÄÄÄÄÄ ³ ³ ³ ³ Otto Chrons ³ ³ Vaajakatu 5 K 199 ³ ³ FIN-33720 Tampere ³ ³ FINLAND ³ ³ ³ ³ InterNet: ³ ³ ÄÄÄÄÄÄÄÄÄÄ ³ ³ otto.chrons@cc.tut.fi ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Newest version is always available at: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ R.A. LAW +358-37-5849007 24h ³ ³ ftp.wustl.edu /pub/MSDOS_UPLOADS/modplayers ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ See CABINET.DMP for a list of DMP/DMP32 support sites in Finland. See DMP32.REV for revision history.