DMPMT.DOC Documentation for the 'Dual Module Player for Multitaskers v1.3' Copyright (C) 1992 Otto Chrons DMPMT.EXE is a program demonstrating the capabilities of the AMP programming interface (AMP stands for Advanced Module Player). It's a stand alone module player with which you can play STM-files as well as Amiga modules (MOD or NST). Only 31 instrument modules are supported. If you have older 15 instrument MODs you have to convert them. DMPMT is public domain so you can freely distribute it and I hope you did, as long as you include this help file with the executable. DMPMT is especially designed for multitasking environments like DesqView. It runs nicely in the background and gives up the time slices it doesn't need (only applicable for DesqView). There is not much sense running it on its own, because DMP is much better suited for that kind of playing. DMPMT is solely designed for background playing. Here is the command line syntax: DMPMT [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-22050 alternatively 4-22 DON'T USE HIGHER THAN 21KHz ON SB /O Scramble module order /H or /? show help screen /Ix SB's interrupt number /Pxxx SB's port address You may have to give your SB's IRQ number and/or port address if DMPMT fails to find them. If you don't provide both values then DMPMT 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 4 seconds. You don't have to add any extension to the name, because the program will try extensions AMF, STM, MOD and NST if it doesn't find the file. Note that you can supply many modulenames and list files, up to the internal limit of 50 modulenames. Example: DMPMT klisje /S20000 *.NST @goodmods goodmods is a text file containing following lines: occ-san stars intro3 DMPMT will use the sampling rate of 20KHz and play following modules: KLISJE.STM, OCC-SAN.STM, STARS.MOD, INTRO3.MOD and all .NST-files in the current directory. ������������������ How to use DMPMT ������������������ After writing the copyright text, DMPMT tries to detect DesqView and displays a message if succesful. Then DMPMT loads the first module. Or in case you didn't give any valid modules, displays an error message. When module is loaded into memory DMPMT starts to play it and displays module's name. While playing you can press various keys to effect the playing. The keys are listed below. Pressing 'H' bring up a quick-help showing command line options and keys used to control the program. Keys : �������� SCRL-LOCK pause/resume module (NOTE: This works also from other tasks in DesqView) N load next module (if you have supplied more than one) S stereo mode on/off (SB Pro), default is on ESC exit �������������Ŀ � N E W ! � ��������������� DMP now supports new module format called AMF (Advanced Module Format), which is actually the same format DMP uses internally. Therefore modules using this format tend to be a lot smaller than with normal STM or MOD format. Remember, that you cannot convert modules from AMF back to STM or MOD! Use M2AMF.EXE to convert STMs or MODs. 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 � � Pyydyspolku 5 � � SF-36200 Kangasala � � FINLAND � � � � Fidonet: � � ��������� � � 2:222/352.7 � � SBC-net: � � ��������� � � 14:1510/500.7 � � (this is not a good way to contact me, use Internet or � � Fidonet if possible) � � � � InterNet: � � ���������� � � email@example.com (fastest method to contact) � � � ����������������������������������������������������������������������� Newest version is always available at: �����������������������������������������������Ŀ � NCS +358-31-420034 24h v.32bis � � R.A. LAW +358-37-49007 24h v.32bis � ������������������������������������������������� See DMPMT.REV for revision history. ���������������������� For programmers only ���������������������� DMPMT was created with Borland C++ 3.0 and it is based on AMP's routines, so by ordering AMP interface you could write programs with similar capabilities. AMP is a collection of routines (for C and Turbo Pascal) that allows programmers to play modules in the background, but unlike any other module player it also allows simultaneous sound effects!! Up to 8 channels can be used which means that you can have a module and four sound effects playing in full stereo (stereo is supported only on SB Pro)! AMP will be available in the 4th quarter of 1992 and the price should be around 100-200FMK (about $30-$50). Packet includes full documentation (on disk), OBJ files for C version, TPUs for Turbo Pascal and also some of the source code so you can modify the behaviour of AMP. I will release a demonstration packet when AMP becomes available which will contain more specific information about AMP and its price. It will also have few demos using AMP. Stay tuned!