********************************************************************** * DeliTracker V1.15 * ********************************************************************** © 1991 by Delirium Date 27.12.1991 =============================== DISCLAIMER =========================== This demoversion of DeliTracker is freely distributable but copyrighted by Delirium Softdesign (Frank Riffel and Peter Kunath). We have NOTHING to do with a Crackergroup that uses the same name !!! Program, document and other files must be distributed in their original UNMODIFIED form. Of course you can use an archiver like LHarc to make it available on mailboxes and FTP sites. This program cannot be used for commercial purposes without written permission from the authors. The authors can not be made responsible for any damage which is caused by using this program. If you like to have the full version send DM20 if you are inside Germany $US20 if you are not in Germany along with the registration form to the following address: Frank Riffel Merkstr. 27 8129 Wessobrunn Germany The full version will come with the documentation of the external player interface, so you may create your own players. Also the sources of some players are included. The Requester and the 3 min limit is of course removed. ========================== What is DeliTracker ? ===================== DeliTracker is a soundplayer, which supports several soundformats. SoundTracker and NoiseTracker and CustomPlay are internal players. Additional Players are loaded from disk. That means you can very easy add/update players by placing them into the DeliPlayers directory. DeliTracker is NOT a Songeditor, MIDIsequencer or Digitizer. It is only thought to play music modules in a comfortable way. ========================== Why use DeliTracker ? ===================== ° runs fine in multitasking ° allocates the soundchannels ° correct playspeed in PAL/NTSC (uses timerinterrupts) ° supports PowerPacked soundfiles ° supports up to 48 external players ° runs fine with 680x0 and Kick2.0 ° uses & requires req.library ° Arexx support ° has a configfile ° enforcer and mungwall proof ° supports full CLI or Workbench (ToolTypes) environment ° easy to use & looks good ° has Volume/Balance - slider ° resident cli startup ° supports mulitselect ° written 100% in Assembler ° ... and is programed by Delirium Softdesign ================================ Defaults ============================ DeliTracker tries to open 'S:DeliTracker.config' at startup time as standard configfile. In directory 'DeliPlayers' (on the current path) the external players are searched. A configfile contains the path of the external player directory, the path/filename of the soundfile that was played when the config file was saved and some other things (windowpositions,flags, ...). If a configuration is loaded the parameters are set. Tooltypes and CLI options have higher predency than the parameters in a configfile. When starting DeliTracker you may change these defaults: In the CLI by using the following sytnax: -c load -m load and play -d set path for external players -w/ startpositionen of the controllwindow -p/ startpositionen of the prefs-window -v preset volume (Range [0..63]) -b preset balance (Range [-64..63]) -r lines in the filerequestor (height) -n don't open mainwinow (only if ARexx is up) -l toggle led on -f disable colordecrunch -? help By using the 'Info'-item of the Workbench menu and adding the following in DeliTracker's Tool-Types: 'config=' initial configfile 'module=' set startup sound 'deliplayerpath=' path for external players 'windowxy=' startpositionen mainwindow 'prefwinxy=' startpositionen setupwindow 'volume=' initial volume (Range [0..63]) 'balance=' initial balance (Range [-64..63]) 'reqlines=' filerequestor height in lines 'ledon' toggle led on 'flashpointer' disable color decrunch 'nowindow' don't open mainwindow at startup (only if ARexx is running) Example: CONFIG=DT.conf PREFWINXY=0/11 VOLUME=43 NOWINDOW Invalid Tooltypes are ignored. DeliTracker can be used as 'Default Tool'. Tooltypes and CLI options are not case sensitive. Are the specified windowpositions invalid 0/0 for the mainwindow and/or 0/1 for the prefswindow is used. CLI options and WB Tooltypes are not case sensitive. NOTE: Do not pack Modules if the player doesn't support packing ! If eneugh memory is availabe DeliTracker will use DoubleBuffering (that means a song will played until the next song is loaded). ================================= Menu =============================== Project Prefs - Preferences-window comes up Load Song - pops loadrequestor up use SHIFT for selecting more files Play/Pause - should be clear ... Stop Song - patternpointer is set to begin Quit - ... leave this one :) Play Faster - increases playspeed Slower - decreases playspeed Forward - set patternpointer to next pattern Backward - set patternpointer one pattern back Next Song - play next song (if more files selected) Prev Song - play previous Song "" Next SubSong - play next Subsong Prev SubSong - play previous Subsong Kill Song - stop playing, remove sound from memory ================================= Gadgets ============================ +----------+--+-------------------------------------------------------+--+ | | | [] | | [15] [1] | ? + +-------------------------------------------------------+ + | | | [] | | [14] +---+------+--+--+------+------+------+-----+------+------+-----+-----+--+ [2] | + | | | | | | | | | | |¯¯\ | +---+ |< | < | << | |> | >> | > | >| | [] | ^ | | | | [3] | - | | | | | | | | | ¯ | +--+ | +---+------+-----+------+------+------+-----+------+------+-----+--------+ [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [1] Prefs-Window comes up [2] plays song a little faster [3] plays song a little slower [4] previous song (only if more than one file is selected) [5] previous pattern / sub song [6] previous sub-song (if available) [7] play/plause song [8] next pattern / sub song [9] next song (only if more than one file is selected) [10] next sub-song (if available) [11] stop song, reset patterncounter, reset speed [12] remove song from memory [13] filerequester [14] balance control [15] volume control ============================== Preferences =========================== If you press the '?'-Gadget a preferences-window pops up. ADD - load external player / set playerpath DEL - delete selected player (free mem) Filter - switch filter on/off Quickstart - if enabled a loaded mod begins to play imediately else DeliTracker will wait for a start event (usefull with Arexx) Load Config - load a saved configutation Save Config - save current song/path in a configfile Config Player - configure the selected player (currently no player uses this feature; is is used to provide a player private configuration i.e a SMUS player could ask you in which dirs to search for the instruments). OK - close this window You can set the playerdirectory by typing the path into the stringgad (on the lefthand of the ADD gadget) or using the filerequester (ADD). If you select a Player some information about this player is in the 'playerinfo' box. When 'Packable....NO' is shown for a particular Player the modules of this player can't be crunched! Other informations about external Players can be found in the 'Programing.doc', the Player docs and in 'misc/DeliPlayers.i'. ============================== Kickstart 2.0 ========================= The Version for Kickstart 2.0 has some differences to the 1.3 Version: ° the colors are modified for 2.0 ° the mainwindow has a Zip-Gadget ° menuhandling is done with ROM-routinens ° you can select/play a module by simply draging the module icon over the mainwindow from DeliTracker. ============================ REXXCOMMANDS ============================ quit - quit DeliTracker filter - if BOOL = 0 then set filter off else on quick - if BOOL = 0 then set quickstart off else on flashpointer - if BOOL = 0 then disable colordecrunch else enable it volume - Set volume to (VOL: 0 to 63) if possible balance - Set balance auf , 0 is default, -64 left only 63 right only (BAL: -64 to 63) if possible loadconfig [FILE] - Load configfile [FILE] if [FILE] was specified else pop filerequestor up saveconfig [FILE] - Save configfile [FILE] if [FILE] was specified else pop filerequestor up playmod [MODUL] - play [MODUL] if [MODUL] was specified else pop requester up forward - play next pattern backward - play previous pattern nextsong - play next song prevsong - play previous song nextsubsong - play next subsong prevsubsong - play previous subsong faster - increase playspeed slower - decrease playspeed playpause - play/pause song stop - stop song openmainwin - open mainwindow closemainwin - close mainwindow openprefswin - open prefs-window closeprefswin - close prefs-window status - group may be p, m, g p : player = returnvalue nam name string cre creator string ver player version number vol volume 0/1 bal balance 0/1 jmp patternjump 0/1 spd playspeed 0/1 sub subsong 0/1 cfg config 0/1 pck packable 0/1 g : global = returnvalue ver version number dir playdir string num players number led filter 0/1 qst quickstart 0/1 ptr flashpointer 0/1 mwi Main 0/1 pwi Prefs 0/1 vol current volume number bal current balance number ply song is playing or paused m : Module = returnvalue dir moduledir string fil filename string pnr actual PlayerNr number max selected modules number num actual position in list number [..] optional argument <..> argument required See also the REXX examples. =============================== PLAYERS ============================== Supported players: ° NoiseTracker/SoundTracker(15 inst./31 inst.) plays almost all known SoundTracker/NoisTracker formats correct. INTERNAL. ° CustomPlay for special modules which contain their player (these cant be crunched, they are loaded via LoadSeg() for relocation). INTERNAL ° all EXTERNAL players are listet in the Players.doc file ========================= Problems/Hints/Tricks ====================== Symptom: Prefernences window cant be opened. Check the Screenheight. It must be at least 190 Pixel + Barheight. The Barheigth depends on the Screenfontheight. NOTE: Some external players have trouble with >68010 or SuperHires these problems often can't be fixed. The cause of this lies in the programmingstyle (e.g the player is part of the module and contains modulespecific code/data). Although many players are hitting the basic principles of programming on the amiga. Such things as poking directly into processorvectors or working with nullpointers are used often. So don't be astonished if enforcer hits occour. These hits are only from external players and not from DeliTracker itself !!! Usualy the playspeed of the players are the same on PAL/NTSC machienes cause a CIA rather than a VBlank IRQ is used. But some Players esentially need a VBlank interrupt, those players have different playspeeds depending on the selected video mode (PAL/NTSC/Productivity). For Modem users: Under 2.0 CIA-A is ocupied by the System. Most players from DeliTracker use the CIA-B interrupt. The Hardwarepriority from CIA-B is greater than from CIA-A. This facts are leading to this clue: Doing serial transfers at high BAUD rates and runnig DeliTracker (or any other Application that uses CIA-B) at the same time could result in transfer errors (data loss). ================================= NOTICE ============================= Future Plans: - load and save of the complete modulelist (not only the currently active module) - more 2.0 features (PubScreens,...) - more (external) Players ° StarTrekker AM/8 Voices ° NoisePacker ° OctaMED ° Sonic Arranger ° Face the Music ° Soundfactory ° Beethoven ° Wizard of Sound ° IFF 8SVX ° Sonix ================================= CREDITS ============================ We thank our betatesters Stefan, Daniel, Börnie and Manfred for their bugreports and some good ideas. Thanx to Armin Sander for creating a Player for Oktalyzer. Special thanks go to Colin Fox and Bruce Dawson for their incredible req.library! Testconfigurations: - A500 KS1.3, 512k - A500 KS1.2, 1MB - A500 KS1.3, 1MB (Chip) - A500 KS1.2, 2.3MB - A500 KS1.2, 2.5MB & Harddisk - A2000 KS1.2, 1MB - A2000 KS1.3, 1MB & Harddisk - A2000 KS1.3, 3MB (1MB Chip) & Harddisk - A2500 KS1.3, 5MB (1MB Chip) & Harddisk - A3000 KS1.3, 10MB & Harddisk - A3000 KS2.04, 10MB & Harddisk ====================================================================== I am searching for this replay routines if they are freely distributable ° StarTrekker 1.3 AM/8 Voices ° NoisePacker ° OctaMED ° Music Maker ° Sonic Arranger ° Music Master ° B2-MIDI ° Soundfactory ° Beethoven ° Wizard of Sound ° Sonix If you send me the routines please include some modules for testing.Any other routines are welcome too. If you find any BUGS, have SUGGESTIONS or REMARKS about this program, or have a new player please LET ME KNOW. Frank Riffel Merkstr. 27 8129 Wessobrunn Germany