· : ¦ . _________ ________ _____________ ._____¦ | · __ / : ___________/ _ \ \ __ _ / | \ |____: : \_/ -A : \______ \ | \_ _: \_/ \_/ | \ ¦ | ¦ \_ ··D_ / / _/ | / |___/ \_ | : : | |_______/ `N· _/ \ \_________/ | \________/ ¦ |_____¦ ¦ | : \__________/ \ ¦ \_ : : \__________| \___________/ . · CRaZY GaNG . +--------------------------------+ Eagleplayer 1.51 Documentation ============================== TYPED BY SHARD - N&B 1993 Defect Software Productions ================================ Table of contents: 1. Copyright 2. Introduction 2.1 What is the EaglePlayer (able to do)? 2.2 Formation of the EaglePlayer 2.3 What is not yet implemented in this Version? 2.4 When will the next EaglePlayer come up? 2.5 How to become a registered User 2.6 Orderform 2.7 Update-Service 2.8 Bug reports 2.9 Using the Keyfile 3. Installation and starting 3.1 System requirements 3.2 Additionally needed files 3.3 Installation on Disk,HardDisk 3.4 Starting the EaglePlayers from CLI/SHELL 3.5 Starting from the Workbench 3.6 The Config-file 4. Controlling the Program 4.1 The main window 4.1.1 Controlling the program using the Gadgets 4.1.2 Control via Pulldown Menus 4.1.3 Shortcuts 4.1.4 The Appwindow-function 4.1.5 Pubscreens 4.1.6 Font-support 4.1.7 internal (Un)Packer 4.1.8 The LHA-Extractor 4.2 The Player-window 4.2.1 Opening and Functions of the Player-Window 4.2.2 Controlling using the buttons and description of it`s functions 4.2.3 Shortcuts in the Playerwindow 4.2.4 Internal Players 4.2.5 External Players 4.2.5 Bugs within the players 4.3 The User-Programs 4.3.1 Introduction 4.3.2 Controlling the User-Programs 4.3.3 to the Userprograms currently available 4.3.4 No coding guides for User-Programs! 4.3.5 Binding the Eagleplayer into other programs 4.4 The Batch-files 4.4.1 The Player Batch-file 4.4.2 The User program Batch-file 5. Bugs 5.1 Error Warnings 5.2 Errors of this Program 5.3 Problem-sheet 6. EXTERNAL PLAYER PROGRAMMING INTERFACE 6.1 Introduction to the external players 6.1.1 The external Player concept 6.1.2 The structure of external players 6.1.3 The structure of custom modules 6.2 How to build external players 6.2.1 Playerheader 6.2.2 Module recognition 6.2.3 Interrupts 6.3 Meanings of the Tags 6.4 DeliTracker support functions 6.5 Hints and Tips 6.6 The special informations and news for the Eagleplayer 6.6.1 The new tags 6.6.2 Module info 6.6.3 Analyzer control 6.6.4 The new Eagleplayer Globals 7. The Arexx-Interface 7.1 Introduction and description of the Arexx-Port 7.2 The commands 7.3 Arexx-Adaption to DOPUS 4 8. History 9. Acknowledgements 1.1 Copyrights and distribuiton-conditions ------------------------------------------ The EaglePlayer is to be seen as Shareware in the current Version. That means,that we expect a ShareWare-fee of 30 US$ outward of Germany (else 20 DM), that has to be given CASH or as Eurocheque (other currencies or Cheques can NOT be accepted). In return for that you will get the latest version of the EaglePlayer, which contains features,that are disabled in the Shareware version (e.g. Save, Tooltypes-Support). Besides that you will get the improved version including new Userprograms for free, so that the Shareware-fee is quite justified considering the mailing costs. Please send the supplied Orderform to: Eagleeye Buggs -------- ----- Jan Blumenthal Henryk Richter Erich Mühsam Straße 33 or Stephan-Jantzen-Ring 47 18069 Rostock 18106 Rostock Germany Germany Phone/FAX: +49 / 0381 / 83979 Phone: +49 / 0381 / 1208867 In case you have any remarks,suggestions, Bug reports,new Soundformats, threatening letters, Amigas to give away... for us or problems at using, you can contact the addresses above. NO DISK, NO ANSWER !!! We just can't send away (nearly) thousands of Disks. Send us a Disk and you will get the latest Demo or the according registered version back. The EaglePlayer may be distributed on Public-Domain-Series, Shareware-Series and Networks under the following conditions: - The EaglePlayer-Package must remain complete,the files belonging to that package are listed in the Distribution chapter. The EaglePlayer is going to be delivered on 2 Disks (uncrunched). - Neither the program, nor the documentation may be changed, except for packing them, as long as the original state will be 100% recoverable (e.g.LHA, ZOO, ARC, ZIP, PowerPacker). - The distribution price for the EaglePlayer itself or for the Disks containing the EaglePlayer may not exceed the total of 5 DM or the corresponding amount in other currencies. The same applies to transferring fees in Networks. - The firm "Mallander Software" may NOT distribute this software !!! - The EaglePlayer may not be distributed in Software-Packages, excepted PD or Shareware-Series (e.g. Fish, Time), without any WRITTEN permission of the authors. This permission has to be gathered BEFORE DISTRIBUTING it !!!!!!!!! - That applies for commercial use or distribution as well,what is explicitly prohibited form the authors without having a WRITTEN permission. We, the authors of this program, will not take any liability for damages on hard and software that were eventually caused by the program. The use of this program is at your own risk. WE, THE AUTHORS, PRESERVE TO THE RIGHT OF PROHIBITING THE DISTIBUTION OF THE EAGLEPLAYER TO SINGLE VOLUNTEERS, IN CASE THEY DO NOT FOLLOW OUR COPYRIGHT- CONDITIONS. The EaglePlayer was not written for people, who want to earn money with it. It shall expand the Amiga-World with a senseful music playing program that only requires little money to get. 1.2 Distribution ---------------- The Eagleplayer is a program package which is distributed on 2 disks. The further distribution of this package is only allowed when the following files and directories (with their contents) are supplied in unmodified form. Eagleplayer-MainDisk: fonts/Eagleplayer.font Eagleplayers/ EP-Userprograms/ Prefs/Env-Archive/Eagleplayer/ Eagleplayer Eagleplayer.Help Liesmich.Dok Readme.Doc Eagleplayer-Disk 2: Bonus-Programs/ Developer/ Docs/ Include/ InstallEagle InstallEagle.script InstallLibs.script Liesmich.Dok Readme.Doc 2.1 What is EaglePlayer (able to do) ? -------------------------------------- The Eagleplayer is a program-package to comfortably play music of different sound-formats. It is NOT usable to create music-modules or songs, and should therefore not be mixed up with a music-editor, sequencer,tracker etc. It actually includes the play-routines for Sound/ Noise/ Protracker, Startrekker (AM) & AudioSculpture (AM) as well as the internal custom play-port as already known from DeliTracker and is able to load furthermore needed players after. The advantage of this method is as follows: You do only have to load the actualy needed players, which saves loading time and memory. Besides that, the length of the main program will not increase to infinite length. All internal SoundTracker RePlayers support Song-Loading. The Songs and Samples may be packed. The Instrument-Path may be adjusted via Config (chap. 4.2.2). The Samples may be packed. They are all loaded as RAW data. Here are some features that the EaglePlayer, the prototype of DeliTracker, does support: - the number of loadable players is only limited by the amount of free memory (chap. 3.4) - alphabetical order of players in the Player window - an AddPlayer Dir function - a Delete All function - players can be enabled / disabled - possibility of loading up to 32 external e.g. Analyzer programs - own graphical interfaces can be programed and used as Userprograms - the choice of modules to be played can be done directly via Pulldown-Menus (chap. 4.1.2) - comprehensive possibility of configuration (FadeIn, LoadNext ...) - speed-regulation via Proportional Gadgets (chap 4.1.1) - all voices can be separately enabled / disabled - status report via scroller - carefully and extensively adapted playing-routines, nearly all operate on an A4000 (see Player.Doc) - 7 intern Depacker - is able to use the DeliTracker-Players, if the corresponding player adapted to the EaglePlayer is not present - extensive Module Infos, if the Replayer has been adapted apropriately - ONE version for all Kickstarts (from Kick1.2 upward) - gadgets automatically accomodate to the color-palette when opening a window (3D-lock) - modern styling - supports AppWindow in all its windows (Kick2.0+) - has an Iconify-Mode (AppItem, AppIcon, LittleWin) - internal SoundTracker Players are able to load songs - a PlayFaster-Gadget - more Arexx-commands (above all,status-commands) - a Randomsong / AutoSubSong-function - "load on demand system" for external replayers - "load on demand system" for userprograms - LHA-Extractor - different file requesters (ASL,Req,ReqTools,None) A special advantage of the EaglePlayer in contrast to many rivals is, that it works with most of the playing-routines (those not working, see Problems) and plays the modules always at same speed, independent to the picture-rate, thus under PAL as fast as under NTSC and Productivity modes. 2.2 Formation the EaglePlayer ----------------------------- It began with the Phenomena Demo "Enigma". There we found a module converted with the Noisepacker. We ripped the music but hadn`t got any player for this format. A tool for playing this module was written. Some time later some other formats were included (Noisetracker...). This program was called "Megaplayer" and was released in April 1992. It was able to play 16 different formats. This program grew up to about 25 and got more and more confused. About one year ago Jan decided to write a new and competent Soundplayer- Program, because people were quite unhappy with his Noiseplayer-like Mega- player. He industrially worked on it, created an attractive graphical inter- face, tried to fetch as many playing-routines as possible and to integrate them in the program. (we also developed a concept for external replayers) But then the unconcieveable happened: I (Buggs) got the version 1.15 of DeliTracker from a mate. Worlds were crushing down, but we still kept on developing the EaglePlayer up to that day, when we got Fish Disk no.748. On this disk there we found version 1.3 of DeliTracker, with changed and a flexibly expandable concept for the external Players. We had only two opportunities: either to give up programming the EaglePlayer or to adapt ourselves (and the program) to the new conditions. So we choose the last one --> A DeliTracker Port had been implememented and our own ideas were being included into the - I just have to say it again - really flexible player- principle of the DeliTrackers. The current program represents the topical state of the result. Although we included some expansions we let the program DeliPlayer-compatible, our mostly enhanced playing-routines can also be used by the DeliTracker (some functions will then be disabled, of course). So you see why this doc is much similar to the Delitracker doc. But, of course we did all functions ourselves, everything is 100% self coded !! Only some external replayers we taken from the Delitracker (we hadn`t got the sources for them) and expanded and bettered them. (The copyright in these players was left of course) 2.3 What is still missing in this version? ------------------------------------------ A lot, till today the following functions are planned for the near future * Module info as own window * Sample info (with saving the samples, playing them and so on) * UserPrg Manager * new Surfaces as Userprograms (NoiseEagle / HiFi) Comment: The functions marked with a "*" will probably only be implemented in the registered version! Note that you will get the topic version of the EaglePlayer, if registered. That may mean under circumstances, that some features could be missing, but were planned to be implementet and could not get finished because of time problems. These parts of the program may then be used with a KeyFile in later versions. 2.4 When will new versions come up? ----------------------------------- That's hard to say. It may take a little longer getting the new versions ready because we, Eagleeye and Buggs, are recently only at home on weekends. Users who want to be registered are here with asked to be patient in getting an answer from us. 2.7 Update-Service ------------------ Every registered user may order the latest version without any fee. Just send 2 Disks with back post to us. (Don`t forget to send your keyfile on one of these disks) Please send also your Configuration file and the Eagleplayer/ Userprogram Batchfiles. Furthermore we expect the Update Form from you. Don`t forget to PUT IN YOUR USERNUMBER - you find it when you select the "About" Item in the Project Menu and then click on "Key". Please answer the following questions: - Are you satisfied with the delivery of your copy ? - Did you got problems with specific Machine configurations ? - Did you expect more or less from your registered Version ? - Is the Documentation sufficient ? - Which functions do you wanna to be included ? - Does the Eagleplayer work together with all of your programs ? - Do the playroutines work correctly ? - Are your friends using the Eagleplayer as well as you? Why not, why? - Do you think the Eagleplayer needs to much memory ? When you describe Bugs of this program, please look first into the chapter Bug reports We will put the actual Eagleplayer onto these disks and send them back. If no new Version is available at this time you`ll have to wait for your disks until the next version will be released. 2.8 Bug reports --------------- If you want to describe an Error of the Eagleplayer you should try to report it as detailed as possible. A message "The Eagleplayer crashes whilst loading" doesn`t help us at all. It can happen that the module is corrupt or the depacker doesn`t work or the current replayer destroyed the memory. There are lots of opportunities. Following we listed some things you should answer: * Are you a registered User ? * Which Eagleplayer version are you using ? * Hardware configuration! (Amiga Model, Memory, OS etc.) * Which Patches did you install ? * Free Memory when crashing ? * Which Players / Userprograms were loaded? Is it obviously unimportant that players/user programs were loaded ? * Does this Error happen using other Computer configuratuions ? * Your Config file we need as well ! * Which Module makes problems happen ? SEND IT US PLEASE !!! * Does this Error happen only on Machines with cache ? * How were the current internal settings of the Eagleplayer ? Are them unim- portant for this Error ? * Was the module recognized correctly ? * Was the Mainwindow opened ? * Is the Error Kickstart (OS) dependend ? * Which Userprograms were active ? 2.9 Using the Keyfile --------------------- Registered Users get a Keyfile from us which has to be copied to "Devs:". This keyfile allows the Access to the functions disabled until this time. The Keyfile is person dependant. It countains the full Address of this User his User number and other datas. If we should get to know that a keyfile was given away to other persons we take him to court!! (JUDGEMENT DAY!!) In the next version of the Eagleplayer this keyfile won`t be accepted. All Keyfiles may be used in upcoming new versions of the Eagleplayer. It is possible that further DEFECT-productions work with this keyfile (more won`t be said) 3.1 System requirements ----------------------- The EaglePlayer needs at least Kick 1.2 and 512 KB of Ram. But I have to mention that some functions of the EaglePlayer, like Appwindow (see there) will not run under 1.2/1.3. The same matters for a big part of User-Programs written by us. On machines that work with pseudo 2.0-versions (all 36-er Kickstart versions), we do not guarantee anything, because these Kickstart-versions were not finished at this time. When we talk about "2.0" from now on, we think of the Kickstart-versions from V37.175 (OS2.04), which are regularly in ROM in A500+/A2000E. Included are the following versions 3.0 etc., which are used in A1200/A4000. Tests on this machines have been successful :)-=-= There is also often the mark (r.v.). That means just that these functions will only be usable in the registered versions. The Amiga should of course be connected to a monitor with speakers or to a stereo-tower/ "ghetto-blaster", because otherwise you just won't hear anything (I think so). You have to be patient that no other sound-program is running already, which uses the audio-channels. In this case the player will reply a message after loading a module (see "Errormessages"). Attention: Although we are saying that the EaglePlayer runs with 512KB MEM, it may be that still 1MB is not enough when you have loaded all of our User-Programs and all of our External Players that are available now. So if you do not have such amounts of memory you should think about which players you need and which not! MAKE USE OF THE EAGLEPLAYER-BATCH ABILITIES !! 3.2 Additionsal files needed ---------------------------- The Eagleplayer doesn`t depend on any library anomore !! The EaglePlayer tries to open XPKMaster.Library, Crm.library, PowerPacker.Library such as LH.Library to load files packed with these packers. These Libraries are NOT NEEDED for starting, but are recommended, anyway if you want to load such packed modules. To Use filerequesters you will need at least one of req.library, asl.library and retools.library. The Eagleplayer tries to load a Configuration file 3.3 Installation on Disk,HardDisk,... ---------------------------------- To install the EaglePlayer by hand, the following steps are neccessary: - at first you have to copy the Libraries mentioned above to "Libs:" ("Libs"-directory on your Boot-Disk/Partition) - the second step is to copy the file "EaglePlayer" in your favourite directory (e.g. "DH0:Music/Players/" or "DF0:" ...) - then you have to define the players that should be immediately loaded on program-startup and to copy them into one of the following directory- variants. (The EaglePlayer searches in the order listed below and then loads only that External Players that have been found in the first directory) "EaglePlayers/" \ in your current "Deliplayers/" / directory each "Sys:EaglePlayers/" "Sys:Deliplayers/" - at last the User-Programs have to be installed, just by creating either a directory called "EP-Userprograms" or "Sys:EP-Userprograms" and copying the wanted User-Programs into it. Example: copy EaglePlayer to dh0:Music/Players/ makedir dh0:Music/Players/EaglePlayers makedir dh0:Music/Players/EP-Userprograms copy EaglePlayers/ to dh0:Music/Players/EaglePlayers/ all copy EP-Userprograms/ to dh0:Music/Players/EP-Userprograms/ all People who are too lazy doing that all by hand may simply do it with the included Installation-Script (using the commodore installer !) 3.4 Starting the EaglePlayer from CLI/SHELL ------------------------------------------- To start the EaglePlayer from Cli/Shell you only have to run the Main Program. Before that please change the current directory to that one, where you have put the Player with its Players and User-Programs (DOS-Command 'CD'). This is important in case if the Player-Directory (Deli- or EaglePlayers) as well as the User-Programs are in the same directory as the EaglePlayer itself. If the EaglePlayers and Userprograms are located in "SYS:", The 'CD'- Command will not be necessary and you only have to run the Program. The 'Run'- Command is not necessary to detach the EaglePlayer from Cli/Shell, because it will link off after starting from Cli/Shell, so it will be further usable and may be closed, too. In the unregistered version you cannot deliver any arguments, neither from CLI/SHELL nor from Workbench. 3.5 Starting from Workbench --------------------------- To start the EaglePlayer from Workbench you simply have to double-click on its Icon, which will load it then. Attention: Up to now there is NO Tool-Type support. 3.6 Das Konfigurationsfile -------------------------- From version 1.10 upward, the Eagleplayer will load a Config-File, which consists of a couple of commands that are entered as strings. In the Config. you can, for example, specify the current Player-Directory or if Fade in shall be switched on or off etc. The file normally will be located in the "ENV:EaglePlayer/" directory. When running the Player it will at first try to load it from the current directory and then from the S: -directory. The Config-File is not actually needed for starting the Player. Please note that when you save a configuration the current settings are saved, such as Module name, the User-Programs' settings as well as all paths and preferences- setttings. The commands for the Config-File can be found in the configuration on the Main-Disk or in other saved configurations. You don`t have to use all commands in your configuration. The commands of the config file are partially used in the Arexx-Commands 4.1 The Main Window --------------------- After having started the Eagleplayer successfully you`ll see the following window: I n f o S a w b i o t u c t h I M F c o i o Q d l n u u t i i l e f t e r y | | | | | | | | v v v | ________________________________________________________________ |*| Eagleplayer V1.51 Generic/Registered | | | |--------------------------------------------------------------| | |1| | | Volume | | | |---| | | |_| ? | F |----------------------------------------------|| || <- |_|2| | | Balance| | | |---| | |_|----------------------------------------------------------| |_|3| |< | < |<<| |[]> | |> | >> | |>>| > | >| | [] | ^ | 00| | |_| | | | | | | | | | | - | 00| | |4|----------------------------------------------------------| | |_| Welcome to Eagleplayer | |--------------------------------------------------------------| ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ | | | | | | | | | | | | | | S V p p p r P F n n n S e L p o r r r e l a e e e t j o e i e e e p a s x x x o e a e c v v v l y t t t t p c d d e i i i a t s o o o y / P P S M a u u u l a u o M s s s S P a t b d o M o a y t s u d o M S P n u e o l u d o u a g s r n e l u d b t e n g e l u s t e l o e e n r g n 4.1.1 Controlling the program using the Gadgets ----------------------------------------------- After starting most the Gadgets of the Main Window should by disabled (they`re "ghosted"). To load a music-file you simply have to click on the disk-symbol. After this a filerequester will appear where you choose the music-file(s) you wish to play. After clicking on "OK!" the Eagleplayer attempts to load and play the first music-file. While playing these following buttons may be enabled. Speed Easy way to change the speed of the played song. If the knob is in the middle, the normal speed is chosen. For faster playing, move it upward, moving the knob downwards decreases the speed. - or Plus - and Minus Gadgets To stay Delitracker-compatible we included the possibility to control speed by clicking on the [+] or [-] buttons. Voices To switch the 4 Voices of the standard-Amigas on/off, you have to "press down" the appropriate switch (off), else the voice is on. Previous Module Makes the player load the previous module of the actual list. If the current module is already the first one, the player will load the last one. If "Load Dir" was disabled, the function will also not be available. Attention: If you switched "Random Module" on, this player will not load the previous songfile and the song will replay forever. Previous (Sub)song For soundsystems, where one module countains not only one song. This function plays the previois subsong. If the actual song is already the first one, nothing will happen. If the module countains only one song the gadget will be disabled ("ghosted"). Previous Pattern Plays the previous pattern, if the current one was already the first, the last one will be played. Note for beginners: A pattern is comparable with a note- sheet. Some soundsystems use this method by buliding up a list of instructions executed after another. These lists, called "patterns" can be combined in any way you like. Replay Song The loaded songfile will be re-played up from the beginning Play / Pause Switch between play and pause, if the module plays when you select this button, it will stop and when you click this button again, it will continue Fast Play Fast forward, gives you an easier possibility to search after a certain passage in the songfile. Next Pattern Plays the next pattern (see at "prev. pattern"). If the last one is reached, the first one will be played. Next (Sub)song Plays the next subsong of a music-file with more than one song within it. If the module countains only one song this function will be disabled. Next Module Loads the next musicfile of a list (see also at "prev. module"). Stop Stops the current song, sets the actual pointer where to play to the beginning of the song. Eject Module Stops the actual module (if this is playing or not) and throws it out of the memory. Load Module Opens a filerequester for choosing a musicfile to be played. You may choose more than one by holding down the "SHIFT"-key and clicking the files. In this case the chosen files will be overtaken and you can choose these modules by selecting "prev. Module" or "next module" or you use the possibility selecting the modules directly via the pulldown-menu (Modules-Directory). If you choose only one songfile the whole directory will be loaded. (some files e.g. these ones ending with '.nt','.nt.pp','.txt' or '.s' will be hidden automatically). Iconify Changes the size of the main window to a minimum, closes it (when set) and puts in this case a so called "Appicon" onto the Workbench or adds a Menu-item to the tools-menu of the Workbench. (both functions require OS2.0) To open the main window of the Eagleplayer again, doubleclick on the Appicon or select the Menuitem (See also chapter 4.1.2 "Iconify Modes") Switch Filter Switches the state of the Low-Pass-Filter of the Amiga (no effect when you use the Amiga 1000 or a 2000A - better buy a 1200/4000) Info About Module Scrolls an information-text through the main window telling something about the current song in memory and the replayer for this music. The size of this text depends on the player. If the player doesn`t support moduleinfo, only modulename and size are given. If no module was loaded, an information- text about the player will be given out. Quit The Close-Gadget quits the Eagleplayer (Oh No!). Notice: Under 2.04 the player won`t be quitted by default but the windows and the Userprograms will be closed. To quit select the menu item "Quit" or set "Quit Eagle" within the preferences (also Chapter 4.1.2 and then press on the "close-gadget". Volume Changes the volume Balance Changes balance 4.1.2 Control via Pulldown Menus -------------------------------- The Eagleplayer offers the following pulldown-menus: Project Commands Special Modules-Directory The functions in the "Commands"-menu are exactly the same as the gadgets in the main window, so please look there chapter 4.1.1 Gadgets for explanations. The Project Menu ---------------- Load Module Loads a module (look into (Chapter 4.1.1 Gadgets)) Save Module Only in the registered version. Opens the file requester to select a file where the actual module should be saved to. About Module Scrolls an information-text through the main window telling something about the current song in memory and the replayer for this music. The size of this text depends on the player. If the player doesn`t support moduleinfo, only modulename and size are given. If no module was loaded, an information- text about the player will be given out. Add Player Opens the filerequester for selecting an external player to be added. AddPlayerDir Let`s you select a whole directory of external players to be added. Show Players Opens the Player info window (see Chapter 4.2.1) Load Config Load a settings file by selecting it via the filerequester. Save Config Save the current settings by selecting via file requester (usually to "ENVARC:Eagleplayer/Eagleplayer.config") Delete File Lets you delete a file Help Online Help, only for registered users Iconify Changes the size of the main window to a minimum, closes it (when set) and puts in this case a so called "Appicon" onto the Workbench or adds a Menu-item to the tools-menu of the Workbench. (both functions require OS2.0) To open the main window of the Eagleplayer again, doubleclick on the Appicon or select the Menuitem (See also chapter 4.1.2 "Iconify Modes") About Opens the text requester containing infos about the Eagleplayer and their creators (that's us !) Hide OS2.0+, closes the windows and the Userprograms. To get the Eagleplayer "back" there are 4 possibilities: First and easiest, use the "hotkey" (default: CTRL+ALT+E), second use "commodities exchange"(supplied with your workbench release 2.0 and above) to activate the Eagleplayer, third call the program via ARexx back and the fourth method is to start it again. The second Eagleplayer quits suddenly after starting but signals the first one to appear. Hope you like it. Quit Quits the Eagleplayer The Special Menu ---------------- Preferences: ------------ Scroll Infos The Informations like Filter on/off will be scrolled into the main window if enabled FlashPointer Whilst depacking a module the mouse- pointer will flash if enabled Fadein When start playing a module the volume will increase from 0 to the normal value FadeOut When stopping playing a module the volume will decrease to zero before the replay stops Filter Should the filter be set at the start of the module or not... MasterVolume If this option is enabled, the Analyzing" Userprograms like Analyzer", "Levelmeter", "Levelgraph" react on the current volume by changing their output depending on the current volume settings, what means that on a small volume the output won`t be high exact in the same way. (r.v.) Auto Password If you are using XPK-crypted modules you this option makes the eagleplayer use always the same password instead of asking every time you attempt to load a module Use Songname Display the modulename instead of the filename in the titlebar of the parent screen (if supported by the replayer) Use Prefix When saving a module a prefix will auto- matically be added in front of the module, if available (useful in connection with "Use Songname) (r.V) Quit Surface If set, the Eagleplayer will quit if a Surface Userprogram like "HIFI" or Noiseeagle" is closed. Quit Eagle (OS2.0) If this option is set, the Eagleplayer quits on clickin on the "Quit" button of the main window, else only close all windows. (See also "HIDE" in this chapter and chapter 4.1.1 (Gadgets) Save t: This function offers you the possibility to load packed modules also in when the replayer doesn`t support packed ones by depacking the module to "t:" and loading it again Eject Players All unused external replayers will be deleted. When removing a module from memory. Only useful in connection with "Use PlBatch". Lets you save lots of memory. Eject UserPrg If a userprogram is closed it will be removed from memory. Only useful in connection with "Use UPrgBatch". Let`s you save memory as well as the "Eject Players" function Use PlBatch The Batch-Loading is switched on/off Use UPrgBatch The Batch-Loading is switched on/off Load PlBatch A EPBatch-File for players will be loaded Load UPrgBatch A UPrgBatch-File will be loaded Modules-Prefs ------------- Rescan Dir - The Directory will be reloaded ---------- Loaddir The Directory will be loaded and shown in the pulldown menu. If this option is disabled, "Nextmodule" and "Prevmodule" are disabled as well. The Loadnext, Load Previous and Random functions are not able to work. (should be clear, why) Use EPDir This is a kind of ".fastdir" offering the possibility to load a complete directory within a very short time. It works by saving the directory into a small file within it and reading it instead the whole dir. (r.V.) Autodir On changes within the actual directory or disk the directory will be read again Notify (OS 2.0) The notify function is the same like "Autodir" but much safer and future compatible, should be used always instead of "Autodir" Scan Always Should the directory be loaded at any time a new module is selected (using the filerequester) or sent from an external source (Noiseconverter, M.E.L.G.U) Show DirNames Shall the directories be taken over into the pulldown menu ? (r.V.) Using this function you may switch into subdirs or go to parent directories without using the filerequester. Very powerful and user-friendly function HideAll Using this option all as "non Module" known files ending e.g. with *.asm or *.nt will be hidden. CheckDifference Disabled, not ready yet DirMemsize Enter the size (in Bytes) of the internal directory buffer. One file or directory needs 100 Bytes. Entries Per Menu Enter the number of max. entries for each modules menu. You may enter a value between 0 and 63 (limited by the operating system) Entering 0 the Eagleplayer will calculate the maximal value possible for every screen itself. User-Programs ------------- Add UserProgram A Userprogram may be added via File-requester Add UserDir Add a whole directory of Userprograms. (example) Analyzer _/ enable/disable the Userprograms Save-Mode: ---------- Uncrunched The Module will be saved unpacked. PPcrunched The Module wiill be packed before saving with the Powerpacker algorithms. You may between choose Normal, Protected and Samplemode or combine them. The Powerpacker Samplemode is a creation of DEFECT. Powerpacker Nico Francois. !! LHCrunched The Module will be packed using the "lh.library" when saving. You may choose between "normal" and "Samplemode". XPKCrunched Save the module using one of the XPK modes. (see below). For using a "Crypter" (see XPK documentation) select "protected" mode. CRMCrunched The module is packed with crunchmania modes. You may choose between Normal, Protected and Samplemode or combine them. Automatic Save If this option is set the Eagleplayer saves the current module into the dir set using "SetSaveDir" when selecting "save module" without opening the filerequester. Useful for getting lots or new modules and checking whether you wanna get them or not. Overwrite If this option is not set a warning will appear if you attempt to over- write a file whilst saving. (r.v.) Safe Save Not implemented yet SSdir Try to save the module into the directory named as the soundsystemname (e.g. The Chiptrackermodule "Anarchy" would be saved into the dir "Chiptracker" under the name "Anarchy") SampleMode Pack via "Samplemode" for better crunching results when available Save As PT The actual Module will be saved as Protracker by the internal Players (except Customplay,Startrekker,Audio- sculpture and Oldsoundtracker) Protect For packed savemodes offering the ability saving the modules in a "crypted" way, see above Protection bits Sets the module to "read" only after saving to prevent from deleting,writing or even attempts to execute it Set Save Dir Set the directory for the autosave function Change XPKname Changes the XPK-Packer or Crypter for saving the module and packing via XPK Change Password Lets you set the default password Program-Mode: ------------- No new Module When a Songend is found no new module is loaded and playing stops LoadPrev If Songend or Playtime is set the previous module of the list or directory is loaded on Songend Loadnext If Songend or Playtime is set the next module of the list or directory is loaded on Songend RandomPlay If Songend or Playtime is set a random chosen module of the list or directory is loaded on Songend of the current module. This routine is written in a way that no module will be played twice before every module was played. But it is possible to select a module using the pulldown menu. In this case the module will not be remarked and possibly played twice. If you select the "Nextmodule" and "Prevmodule" gadgets, the randomplay will be performed as well. (like CD-Players do) Songend If enabled the playing will stop if the end of song was reached Load Before The next module will suddently loaded after loading a new module so that 2 modules are at the same time in memory and the player can change to the second one megafast (very useful for megamixes like "RAF Mega Mix" or "LSD - Total Kaos") Must be used together with "Load next", "Quickstart" and "Songend" recommended! Auto Subsong Before Loading the next module the Eagleplayer will play all available Subsongs ("Songend"/"Set Playtime" !) Random Song Choose the subsongs in a random order Load Always Load one module after another until the player finds a known one (useful if you didn`t load all replays but wanna hear music without a break) Quickstart When module was loaded, it starts automatically playing or (if disabled) waits until you press the "Play-Pause" button Set Playtime Asks you for entering the playing time in seconds until the module will stop (and the Player loads the next if preferred) Warning: -------- Small Module Let a warning requester appear if module too short Big Module Let a warning requester appear if module too long Module fault Let a warning requester appear if errors in the module (not used currently !!!) File-Requester: --------------- No Filerequester No filerequester used, all inputs are done using a stringgadget in the main window (Situated where the Scrolltexts appear) Req.Library The req.library will be used Reqtools.Library The Reqtools.Library will be used ASL.Library (OS2.0) the ASL.Library will be used Iconify: -------- Little Window On command "Iconify" (see above) change the window size to a minimum App Icon (OS2.0) Iconify to an APP Icon placed onto the Workbench you may also "drag and drop" icons of modulefiles onto this appicon to play these music-files App Item (OS2.0) Iconify to an App Item added to the "Tools" menu of your Workbench Set Voices Lets you change the state of the 4 Voices provided by the standard Amiga Hardware between on/off Set Volume Default Volume - set volume to max. Higher Volume - make it louder Lower Volume - silence is golden Set Balance Default Balance - set balance to "middle" Balance to left - a little more music from the left side Balance to right- a little more music from the right Set Speed Default Speed - Set speed back to 0=standard Higher Speed - in a hurry eh ? Slower Speed - got much time or what ? Change Pubscreen You`re asked then for entering the name of the public screen the Eagle- player should appear on, see chapter 4.1.5 Toggle Filter Toggles the current state of the audio Filter on/off END OF PART ONE -=- -=- -=- -=-