ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º A M P 3 . 0 º º The module player for Sound Blaster AWE32 and compatibles º º Copyright (c) 1995-2000 Lada Kopecky º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 1. CONTENTS ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ 2. INTRODUCTION 3. FEATURES IN DETAIL 4. REQUIREMENTS 5. FILES IN THIS PACKAGE 6. INSTALLATION 7. UNINSTALLING 8. USING THE PLAYER 9. FILE SELECTOR PLUGINS 10. COMMAND LINE SWITCHES 11. KEYBOARD 12. UNSUPPORTED MODULE EVENTS 13. MIXER AND EQUALIZER SETTINGS 14. DISCLAIMER 15. THE LICENCE AGREEMENT AND COPYRIGHT 16. REGISTRATION 17. FUTURE PLANS 18. COMMON QUESTIONS AND ANSWERS 19. COMMENTS AND SUGGESTIONS 20. CONTACTING THE AUTHOR ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 2. INTRODUCTION ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Welcome to AWE Module Player - a module player that takes advantage of the wavetable synthesizer found on Sound Blaster AWE32 compatible sound cards. The hardware pitch-shifting and mixing performed by the EMU8000 synthesizer offers these two major advantages: a) superb sound quality, unreachable in today's software-mixing players -> the output is absolutely clean (without usual ugly artifacts) and can be directly enhanced by customizable reverb and chorus effects b) music is generated without big demands on the computer's power and memory -> you get the same sound quality on all 386 or better computers and without the risk of system hang-ups or crashes The player engine has been developed and updated for many years and it provides many excellent features such as the most correct module playback, protection of highest notes by high quality resampling, sophisticated dynamic channel allocation, event reporting, SBK protection, the attack control, reliable loop removal, and others. So, if you are interested in top quality playback of musical modules on Sound Blaster AWE32/64 or Sound Blaster 32, AMP is your choice. << NOTE: I'm not saying that AMP is the best for everyone - perhaps there are many users who don't care about the true sound too much. Just try this player and then make your decision.... and of course, let me know, please. >> Before you start using the player, please do read through this manual. It will help you to get the maximum out of every function provided by AMP. What is the tracker module? ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ In case you are totally unfamiliar with modules and tracked music, you can visit some of the many Web pages on the subject of the demo scene and tracked music (see the FAQ section below). For a quick orientation, here is a comparison between a MP3-encoded song and a song stored in a module format (e.g. an IT file): File content: - A tracker module is a native format in which computer music is created. The file contains a high-level musical data such as notes, instruments and sound samples. While listening to the song you can watch how the music is written (the tracks, notes, effects etc.). You can even modify the tune easily (using a tracker program). - In contrast, a MP3 file contains just a single resulting waveform - just like a CD disc or a magnetic tape. File size: - An average size of a module is about 0.5 MB - MP3 files are considerably bigger (about 1 MB per minute of playback) Sound quality: - The sound in MP3 file is compressed by a lossy algorithm -> it means that the sound quality is always degraded by some degree. - The sound samples in a module are stored without compression or they are compressed by a lossless algorithm, therefore the sound quality is not compromised (provided you're using a high quality hardware and/or software to render the sound). ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 3. FEATURES IN DETAIL ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ This player does not offer twenty screen modes nor a spectrum analyzer. It was developed to do a single thing perfectly - to play all modules as correctly as possible and to deliver a maximum sound quality. AMP is very compact, stable, and easy to use. Modules are loaded as fast as possible. If you don't like players that can't work on all machines, have problems with memory managers and protected mode extenders, players that need 5 seconds or more to load and initialize themselves, then AMP may be what you are looking for. Why does AMP sound so smooth and clean? ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The major advantage of AMP is the direct use of the EMU8000 synthesizer that performs the following tasks in hardware (that means with no CPU load): 1. high quality pitch-shifting using a patented dynamic four-point interpolating filter This allows the removal of signal distortion that is so typical for all software-mixing players. Their interpolators (if any) are mostly two-point linear or rarely three-point quadratic (or they are unknown - hidden behind magic and meaningless names like FFT, FOI, IDO, 32-bit, spline etc.). But those basic mathematical algorithms are not suitable for signal processing, therefore such interpolators can't remove the unwanted artifacts while preserving the high frequencies contained in the original waveform. << NOTE: For those of you being unfamiliar with digital signal processing, here is a brief explanation: Let's take an example. You have an instrument sampled at 20kHz when playing the C4 note. But you need to play e.g. the C3 note at 40kHz output rate. To do it, you must increase the number of sample points (i.e. decrease the pitch) by factor of four _without_ changing the information content. If you obtain the three new points by repeating the old sample value, then the resulting frequency spectrum will include new high-frequency replicas (mirrors) of the original signal's spectrum. In our example, the original spectrum 0..10kHz would be shifted to 0..5kHz and also mirrored to ranges 5..10kHz, 10..15kHz and 15..20kHz. These replicas would add an ugly ringing distortion to the output sound. To remove them, you need a sharp-cutoff low-pass filter that won't damage the signal that is passed through. The result will be the "right" new samples smoothly inserted between old. This kind of digital filter is often unfortunately called an "interpolator" even if it does not perform "interpolation" in a common mathematical sense (such as linear or polynomial interpolation between known points). It is important to realize that a well-designed filter response is more crucial then just a number of input sample points used for interpolation. >> 2. mixing at 44.1 kHz frequency allows output frequencies up to 22 kHz You would need a very fast Pentium machine to get just a simply interpolated sound in 30 channels at the 44kHz mixing rate with a software-mixing player. And it would eat most of the CPU processing power. With AMP, all you need is a Sound Blaster AWE32 compatible sound card with sufficient sample RAM and any 386 or better computer. 3. starting/terminating the notes and changing the volume without any clicks (using the EMU8000's envelope engine) The software-mixing players usually can't afford such smooth volume ramping. 4. customizable reverb and chorus effects Without effects, the sound is dry and flat. Any good effect processing requires many additional complex computations. 5. smooth panning in 256 steps << NOTE: I've heard a few people saying that software mixing performed by their interpolating routines sounds better than hardware mixing on the AWE card. That's a big nonsense from both theory and experience. High quality pitch shifting and mixing equivalent to that performed by EMU8000 (four-point resampling in 30 voices at 44.1 kHz) requires about 12 million multiplications per second! << (4+4+1) * 30 * 44100 = 11,907,000 >> This means that the sole multiplication would consume all cycles on a P120 machine. But just multiplying is not enough. We have to do other things as well. And what's even worse, we still don't have any reverb and chorus. The MMX technology can be 3-10 times faster, though - that may be a real chance for software-mixing players. Time will show. (If anyone wants to see the details on how the EMU8000 works and how complex the computations are, I recommend checking the US patent # 5,111,727 - available also for free on Internet, e.g. from the Patent Server operated by IBM). >> Additionally, to get most of the hardware and to eliminate its limitations, AMP performs following tasks in software: 1. A sophisticated dynamic allocation of hardware voices This allows to handle modules with more than 30 channels without losing notes. The dynamic allocation is also necessary to avoid all clicks when notes are being replaced in each master channel. If anyone wants to verify the importance of this feature, he can replay e.g. the following tunes in Impulse Tracker (through either SB16 or AWE32 driver): BLUPEARL.IT - "blue pearl" by Basehead K_FIELD.IT - "fieldtrip" by ChuckB (*) Ugly clicks will be heard in the beginning of these songs. 2. Downsampling the samples that are to be played at rates above 176kHz (i.e. 2 octaves above 44.1kHz - this is a hardware limit of EMU8000) Without resampling (reducing the length and the final rate), some notes or sounds could be lost. To avoid aliasing distortion and to preserve high-frequency parts of sound, AMP uses a digital filter of very high quality (equivalent to a 13-point optimized interpolation). Special care must be taken in order to preserve the exact pitch of looped samples. << NOTE: The "aliasing" distortion appears when a signal containing frequencies above the Nyquist frequency (equal to 1/2 of the sampling rate) is sampled. These high frequencies are then aliased (mirrored) under the Nyquist frequency in the form of distortion. The same thing happens when you downsample a signal without removing all frequencies above 1/2 of the target sampling rate. >> If anyone wants to verify the importance of downsampling, he can replay e.g. the following modules in any other player or tracker using EMU8000: LIQUIDAT.XM - "Liquidation" by Vogue K_HUMAN.IT - "Humanalogue" by ChuckB (*) Unless you have a small sample memory on your card (then samples could have been crunched to fit there), some notes or sound effects will be missing. 3. Avoiding clicks caused by sample loops If sample loops are present, special care must be taken to avoid clicks. The situation gets much more complicated if bi-directional loops are present and/or if downsampling is involved. 4. Special handling of duplicate voices Duplicate voices (i.e. doubled channels) are sometimes used by module composers to amplify some instruments. If such doubled samples are not being replayed perfectly in sync, unwanted interference effects appear. These can be heard as a loss of high frequencies or a flanger-like effect. The duplicate voices make a lot of trouble with all hardware-mixing devices, where starting multiple notes at once is very difficult (if not impossible at all). AMP has got a unique feature to eliminate the interference effects if duplicate voices are used in a module. << NOTE: The elimination may not be 100% perfect on very slow computers (such as 386) or if more than two equal voices are used >> 5. Panning noise suppression The EMU8000 does not interpolate panning changes. Without panning noise suppression, clicks or noise would be heard in some modules. (*) All mentioned sample songs can be downloaded from 'www.hornet.org' The complete list of features: ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ - plays XM modules (FT2.0x, format version $0104) - plays IT modules (IT1.01+, incl. compressed samples and resonant filters!) - plays S3M modules (ST3.0+, IT1.01+) - plays MOD/NST modules (M.K. M!K! FLT4 nCHN nnCH OCTA SoundTracker) - plays the Ultimate SoundTracker modules (an old MOD clone) correctly - plays MTM modules - plays PTM modules (max. 128 instruments) - up to 64 channels and 30 active voices - sophisticated dynamic voice allocation in all modes Therefore the sound is without clicks and there are no problems with channels above 30. AMP is also able to handle (without any notable sound degradation) even those IT songs that claim 50 or more voices in Impulse Tracker! - professional quality downsampling of highest samples to avoid the EMU8000 pitch overflow. A very high quality anti-aliasing filter is used and numerous secondary complications involved by downsampling are properly handled. So, you won't lose *any* note and the quality of playback is not compromised. - special handling of duplicate voices (i.e. doubled channels) to eliminate interference effects - panning noise suppression - high compatibility with the FT2.08 / ST3.21 / IT2.14 playback routines, including emulation of many undocumented bugs. You've probably seen some songs with attached instructions like "Don't play with ***** player because it will **** up". With AMP, you can hear exactly what you are supposed to. - can play under Windows, even in background For background playback, you have to ensure that AMP window is allowed to run in background. To change this, use the PIF editor in Windows 3.x or the Properties dialog for the AMP icon in Windows 95/98. << NOTE: To allow a smooth background playback in all conditions, I've developed a native Windows version (AMP for Windows) which is available separately. >> - 100% accurate timing (the true BPM value is guaranteed) The timing is correct even for longest songs. The only exception is when AMP is running under Windows and another CPU intensive tasks are active. All timing is derived from a crystal clock generator on the sound card. - under Windows, loaded SBKs are protected by allocating the sample memory from the end. (Windows drivers allocate the memory from the top) << NOTE: This protection works only if there is enough free sample memory. >> - thorough error checking to avoid crashes and to assure correct playback (other module players behave mostly unpredictably when a corrupted module is loaded) Even so, AMP can load and correctly handle slightly corrupted songs. - can report all suspicious or unsupported events during the module load and playback, e.g.: - invalid, unknown, unsupported, or improperly used pattern effects - the synthesizer hardware limits exceeded - AdLib instruments and channels in S3M modules - invalid notes / instruments / samples / envelopes etc. - bad sample/envelope loop points - and many more It also informs about another interesting facts, such as: - data found in disabled S3M/IT channels - unused patterns - stereo disabled - and more This is a unique feature, not available in any other player or tracker. - can play multiple modules in batch (using wildcards and/or listfiles) - the listfiles (playlists) are pure text files so that they can be created manually or by third-party software - can play multiple modules in a random order - support for file selector plugins - all kinds of song loops can be reliably disabled - a 'must have' option for unattended playback of multiple songs - offers a fast forward mode, pattern skip in both directions, a module restart command, and a forced tempo mode - supports animated messages using sample names (sometimes found in S3Ms) - can take all (!) settings from AMP.INI and/or from the command line So, you can create different batches/icons for starting AMP with predefined configurations or playlists - direct (!) support for custom reverb/chorus types created by AWE32FXWorkShop (no importing or conversion needed) - an easy to use song message viewer (you don't have to press Shift-F9 or other extra keys to check whether a message is present) - 3 modes of the sample attack control - 2 screen modes - the number of used EMU8000 voices is shown in the bottom of the Log window. NOTE: This number also includes running samples with volume=0 and all active background IT channels. - can play even if not enough AWE memory (but with some instruments lost) - no problems with memory or extenders (85-230 kB of DOS memory is enough) ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 4. REQUIREMENTS ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ - PC 386 or better (CPU speed is not important) - Sound Blaster AWE32 or a compatible sound card with the EMU8000 synthesizer (at least 2 MB of on-board sample RAM is *strongly* recommended; 4-8 MB is needed to play all today's huge modules without limitations) - if your card is a plug-and-play type, the EMU ports have to be configured into compatible locations (400h apart). There should be no problem here as this is the default setting. - 90..250 kB of free DOS conventional (low) memory - HIMEM.SYS must be loaded as the player may need some Extended memory (NOTE: if you're using Windows 9x, you don't have to care about this) - no Expanded memory needed - no sound card drivers needed - the BLASTER environment variable is used, though it is not necessary ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 5. FILES IN THIS PACKAGE ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Here is a list of the files enclosed in this package. AMP.EXE - the player itself AMP.INI - a sample configuration file AMP.TXT - this file HISTORY.TXT - revision history NEWCTRLS.TXT - description of the new XM effect controls REGFORM.TXT - a registration form AMP.PIF - Program Information File for MS Windows FILE_ID.DIZ - short program description AMPFS.AFS - a simple file selector by X-Brain AMPFS.TXT - file selector documentation ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 6. INSTALLATION ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Just unzip the archive into a destination directory of your choice. Make sure that both AMP.EXE and AMP.INI are stored in the same directory. If you also have "AMP for Windows" installed on your computer, then it's best to have both players in the same directory. Then you can directly use the play command that has been registered during the automated installation of AMPW into Windows 95/98. For more information about associating AMP player with your modules, please go to section #8. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 7. UNINSTALLING ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Delete the whole directory and shortcuts/icons you created. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 8. USING THE PLAYER ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ AMP player can be started in three different ways: 1. Since version 3.0 AMP includes a support for third-party file selector plugins. If a plugin is present you can start LMP without any arguments and use the plugin to select modules for playback. For details about using the file selector plugins, see the next section. 2. Setup AMP as a default application for module files in your favorite disk or file manager (e.g. Norton Commander or Windows Explorer). For information how to setup associations between modules and the player, see the documentation of your file/disk manager. For example, in case of Xtree Gold, just create files MOD.BAT, S3M.BAT ... in a directory where XTG resides. These files should contain just a single line like this: @C:\SOUND\AMP\AMP.EXE %4.%5 After that, AMP is invoked automatically when you 'Open' or 'Start' the module (also a mouse double-click does it in most cases). In a similar way, it's also possible to establish an association of listfiles with AMP. 3. Start the player manually and specify modules on the command line Using the command line arguments ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ You can specify one or more modules and/or listfiles on the command line. For module names, you can use wildcards and omit extensions. The listfiles are pure text files containing a list of modules to play, one filename per line. Lines starting with ';' or '#' will be ignored. The listfiles are distinguished by a leading '@'. You can omit the '@' for files with extension 'AML' or 'LST'. You can also use listfiles (playlists) created with AMP for Windows. Examples of use (the default AMP.INI is assumed): a) To play all modules from a directory (MOD/MTM/S3M/XM/PTM/IT extensions): AMP E:\MODULES\* b) To play your favorite songs in random order without pausing between them: AMP E:\MODULES\MY-BEST.AML -N -P- c) To play specified modules with looping enabled: AMP E:\MODULES\DOPE C:\*.XM -S d) To play all modules from a directory sub-tree: (hint by Roger Dahl) DIR /B /S /A-D E:\MODULES >ALL.AML (this makes a playlist) AMP ALL.AML ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 9. FILE SELECTOR PLUGINS ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ The file selector is invoked when you start AMP without any modules specified on the command line or when you press the 'Insert' key. The distribution package contains a simple selector written by Jakub Svozil / X-Brain. For detailed instructions how to use it, see the separate documentation file (AMPFS.TXT). ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 10. COMMAND LINE SWITCHES ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ The list of command line switches (they must be preceded by '/' or '-'): ? Show a help on command line arguments V Verbose mode - all available information goes into the Log window - message colors: INFORMATION - white, WARNING - yellow, ERROR - red W Wait on errors - if this mode is off, you won't see any error messages (AMP just skips the song or terminates) S Repeat each song (loop mode) - this mode enables song and playlist looping - the song loop detection works at a pattern level -> it may trigger prematurely if some patterns are divided into non-continuous parts P Pause mode - if this mode is enabled, then AMP waits until you press spacebar, Enter, or Esc in these circumstances: a) at the end of each module (this can happen only if the single mode is enabled as well) b) in case of a module loading error While waiting, you can continue switching and scrolling the screens. N Random mode (shuffle) - modules are replayed in a random order - you can combine this mode with the single and/or pause mode - some additional DOS memory is needed to store the filenames << This mode replaces the Jukebox mode from older player versions >> F Forced module loading (if not enough sample memory) - all modules will be loaded but with some samples left out Z Extended screen mode - 50 lines on the screen (or 43 lines with an EGA card) Today's tracked songs often use more than 16 channels. In extended screen mode, you can watch them all at once. I Show numeric pan values 0 to F (instead of just L/R/M/S) Gn Default panning separation 0..100 [%] (default 57) - this is the initial panning separation of the left/right MOD/S3M channels (similar to the 'n' switch in DMP player) Mn Initial volume level 0..-70 [dB] (without a minus sign, default is 'automode') - in automode the initial volume depends on the number of channels - for 4 or less channels it's -12 dB (equal to linear volume = 16) If you are not familiar with decibels, here are a few tips: - decreasing the level by 3 dB means 1/2 of the power (i.e. acoustic pressure) - decreasing the level by 6 dB means 1/2 of the linear volume (i.e. the output voltage) - decreasing the level by 10 dB means 1/10 of the power - decreasing the level by 20 dB means 1/10 of the linear volume Bn initial bass level -12..+12 [dB] (default 0) Tn initial treble level -12..+12 [dB] (default 0) - valid values are: -12, -8, -6, -4, -2, 0, 2, 4, 6, 8, 10, 12 Rn initial reverb depth 0..100 [%] (default 14) Cn initial chorus depth 0..100 [%] (default 2) En reverb type 0..7 (default 4) On chorus type 0..7 (default 0) n Reverb Type Chorus Type ÄÄÄ ÄÄÄÄÄÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄÄÄÄ 0 Room 1 Chorus 1 (*) 1 Room 2 Chorus 2 2 Room 3 Chorus 3 3 Hall 1 Chorus 4 4 Hall 2 (*) Feedback Delay 5 Plate Flanger 6 Delay Short Delay 7 Panning Delay Short Delay Feedback (*) are default values Kn,filename (n=0..7) A request to overload the n-th reverb/chorus preset from a FXR/FXC file (created in AWE32FXWorkShop by Vincent Vu) Xn Force the EMU8000 base port (in hex, e.g. 620 or 640) - if you include this switch, AMP won't use the 'BLASTER' variable nor the autodetect routine Dn Downsampling control (0..24, default 12) Use it to set the EMU8000 pitch safety value in semitones (1 to 24). Zero has a special meaning - it disables downsampling at all. The default value of one octave (12 semitones) means that samples will be downsampled so that the highest note won't exceed the virtual sample rate of 88.2 kHz. Very small values are not recommended as there must be some range left for vibratos and slides. Another reason is that EMU8000 doesn't avoid an aliasing distortion when doing a pitch up-shifting, therefore it's better to avoid virtual sample rates above 44.1 kHz. An Smooth attacks 0..2 (default 1) There are 3 modes of the attack control: 0. Never - the attacks are always fast (zero attack time) 1. Looped samples - the attacks are smooth for looped samples only 2. Always - the attacks are always smooth (6 ms attack time) If you prefer a perfect reproduction of percussion instruments, you should use mode 0. On the other hand, if you prefer to hide all clicks produced by poorly sampled instruments, you should use mode 2. Mode 1 is meant as a compromise because the percussion samples are mostly not looped. << NOTE: Fortunately, songs having clicks are very rare. Such clicks show up also in other MOD players, obviously. You have to complain to the one who created those bad samples. >> All switches above can be used in AMP.INI, one option per line. Lines starting with ';' or '#' will be ignored. The command line switches take precedence over the INI file settings. The mode switches (V,W,S,P,N,F,Z,I) can be reset from the command line by appending the minus sign (e.g. -S-). Remember that AMP.INI must be placed in the same directory as AMP.EXE ! ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 11. KEYBOARD ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ F1 Help screen F2 Log screen - available only in verbose mode F3 Channel Info screen - instrument names, channel volumes and panning are shown - the signal meters reflect the final volume (-32 to 0 dB) (incl. envelope, tremolo, tremor, volume swing, and the global volumes) F4 Song Message / Instrument Info screen - this key toggles the song message (only if it's present) and instrument information - note that you don't have to use Shift-F9 or other extra key to show the song message - 16-bit sample points are displayed in sample units - looped samples are truncated to the end of loop and invalid loop points are fixed - envelopes, bi-directional loops and instrument vibratos are indicated by proper symbols. Filter and pitch envelopes are distinguished by color. - the downsampling factor for each sample (1 to 4 octaves) is in the last column - if all IT instrument names are blank, then sample names are shown (but in such case, the names might not correspond with remaining columns). PgDn PgUp for scrolling channels or instruments Ctrl-PgUp/PgDn Home End for a faster move Up Fast Forward (4-times faster, no pattern data is skipped) <- -> Pattern Back/Forward - remaining pattern data is ignored - active notes are terminated (so that they wouldn't hang) Ctrl <- Module Restart (without reloading the module from a file) Esc Without a file selector plugin: - stop the playback and exit With file selector: - stop the playback and enter the file selector - if you press Esc twice in a short period during playback, the player will exit immediately Enter skip to the next module in playlist Spacebar Pause/Resume playback Insert switch to the file selector window (only if a plugin is available) Backspace fadeout and skip to a previous module in playlist NOTE: This can work only if a file selector plugin supports this feature. Ctrl Up/Down enables and controls the Forced Tempo mode (once enabled, all tempo-related commands are ignored) '-' '+' Main Volume down/up F5 F6 Bass Level down/up (EMU8000 equalizer) F7 F8 Treble Level down/up (EMU8000 equalizer) F9 F10 Reverb Depth down/up F11 F12 Chorus Depth down/up Alt display the active effect types Alt-F9 Alt-F10 Reverb Type down/up Alt-F11 Alt-F12 Chorus Type down/up '1' to '9' channels 1 to 9 off/on 'a' to 'z' channels 10 to 35 off/on 'A' to 'Z' channels 36 to 61 off/on '(' ')' '0' channels 61 to 64 off/on '/' '*' all channels off/on Mouse is not supported. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 12. UNSUPPORTED MODULE EVENTS ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Unsupported pattern effects (commands): - Set Filter (unsupported by ST3/FT2/IT; Amiga HW specific effect) - Funk Repeat (unsupported by ST3/FT2; I've never seen it) - MOD/PTM/MTM Set Finetune (an obsolete effect with no proven standard) - PTM effects J,K,L,M (does anybody know their function?) - IT MIDI Macro Select (SFx - I've never seen it) ALL OTHER pattern effects are supported. The S3M AdLib instruments and channels are ignored. Up to 128 instruments are used in PTM modules. The surround panning is not supported because then modules would eat twice the sample memory and time to load. Remaining IT limitations: - IT sample sustain loops are emulated by normal loops. I've never seen a sample with a real sustain loop. Impulse Tracker itself also does not support sustain loops with AWE32. All other IT features are fully supported (NNAs, DCTs, background channels, envelopes, new pattern effects, sample vibrato, volume and panning swing, resonant filters incl. envelopes, carry envelopes etc.). ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 13. MIXER AND EQUALIZER SETTINGS ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ When replaying a song, there are 2 or 3 equalizers in chain: 1. the digital EQ inside EMU8000 2. the analog EQ in AWE mixer (controlled by SB16SET or a Windows mixer) 3. and possibly an equalizer on your external amplifier I believe that only one EQ in the chain should be used. For that reason, AMP resets the analog equalizer to the middle positions. To maximize the signal to noise ratio, the analog mixer MIDI level is set to maximum. The master output level is not changed. When AMP is terminated, all mixer settings are restored to the previous state. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 14. DISCLAIMER ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ This software program is spread "as is", without express or implied warranty of any kind. In no event will author of this software program be liable for any special, incidental or consequential damages resulting from possession, use or malfunction of this software product. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 15. THE LICENCE AGREEMENT AND COPYRIGHT ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ This program is distributed as freeware, but only for NON-COMMERCIAL use. No payment of any kind may be charged for this product or any combination of products or services including this product without my authorization and official written license. The software can be made available on Internet and BBS sites, as well as included on CD-ROMs containing other shareware/freeware programs provided that all files are distributed in their original unaltered form, preferably in the original archive. The software is owned by its author and is protected by copyright laws. You may not remove the copyright notice from any copy of the software. Reverse engineering or patching of this program are a violation of the copyright and are strictly prohibited. Any violation against this rule may be subject to prosecution under copyright law. By installing and/or using the AMP software, you are hereby agreeing to all these license conditions. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 16. REGISTRATION ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ If you are using AMP for more than 4 weeks, you should register. You don't have to pay anything - I just need to know who is using my product. I've been working on this free software for many years - it's my tribute to the world of free music. But my effort can't continue forever, especially without massive response from users. Therefore I decided to gather some information from users and then use it to see whether to keep updating this freeware player. To register, just complete the form (REGFORM.TXT) and send it to the address specified at the end of this file. E-mail is preferred. And of course, if you like the player very much, you can add a small donation. It will be greatly appreciated. (In such a case I recommend dropping me a message by e-mail first) By registering, you vote for future development of AMP. By being silent, you vote against it. Once registered you'll also be informed about new versions by e-mail if you asked for it. << You need not worry about your e-mail address privacy - it won't be passed on to third parties. >> ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 17. FUTURE PLANS ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ To tell the truth, there are no real plans left. It is quite possible that this is a final PUBLIC release. The future depends on you - users, on your comments and registrations. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 18. COMMON QUESTIONS AND ANSWERS ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Q. Where to get some nice songs (modules)? A. There are numerous Internet sites with gigabytes of tracked music. You can start e.g. with one of these: 1. "Kosmic Free Music Foundation" http://www.kosmic.org 2. "scene.org" http://www.scene.org/ ftp://ftp.scene.org/ 3. "Hornet Archive" http://www.hornet.org Q. Where can I find the latest AMP version? A. It is likely to be found at these locations: "Slovak Antivirus Center FTP" ftp://ftp.elf.stuba.sk/pub/pc/sound ftp://ftp.vse.cz/pub/mirror/ftp.elf.stuba.sk/pc/sound (A great archive with lots of interesting stuff of all kinds, and always up to date) "MAZ Sound Tools" http://www.maz-sound.com/awe.html (This is a place where you may find also patches and beta releases) http://www.maz-sound.com/ (Here you'll find everything concerning sound and certainly also something what you haven't seen yet :) Q. Why isn't Windows NT / Windows 2000 supported? A. NT has a different device driver architecture. It does not support VxD drivers and the direct access to hardware is not allowed. There is no standard way how to use hardware mixing in a module player under Windows NT - at least without rewriting the AWE32 driver. If you want to do something for this to change, then ask Creative Labs to incorporate a low-level EMU8000 API into their drivers. But I'm very skeptical about the result. Q. I've got only 512kB sample memory. Why doesn't AMP shrink samples in order to push them into my sound card? A. After many experiments with the resampling feature I've decided not to support sound cards with a very small amount of sample RAM. The reason is that I prefer sound quality and fidelity (these are still and forever the main goals of AMP player). Let's take an example: If 1MB of 8-bit samples has to fit into 512kB sample RAM (== 256k samples), most samples would be reduced by factor of 4. Every such downsampling involves a big loss of high frequency parts. HINT: To hear the difference, just set the Downsampling control to maximum (24 semitones) and try listening to a couple of today's huge modules. Q. Why not use the normal SB16 DAC to play those instruments that don't fit into sample memory? Is there any method to use computer RAM (I have 16 MB) to load samples for playing mods larger than 300kB? A. Unfortunately, it is not possible. The EMU8000 synthesizer has got no access to the system RAM (and I do not plan to make AMP a software-mixing player). Anyway, I think that it shouldn't be a problem for anybody to add some sample memory to his/her card now, when old SIMMs are as cheap as never before. But if your sound card is a Value Edition one, with no SIMM sockets on it, then you're out of luck - you'll either have to get a better one, or switch to one of the many software-mixing players for SB16. Q. Can I use AWE Control Panel to play sounds or to load SBKs while AMP is playing? A. Although it's very strange, drivers allow to control the EMU8000 hardware through AWEMAN API even if it is owned by other application (e.g. by AMP or a MIDI sequencer). But this is very dangerous and you can expect a lot of trouble, including a total crash of your system when you try to do it. So, you can have AWECP running simultaneously, but do not make any changes while AMP is replaying a song. The same limitation applies to AweToy or similar utilities. Q. Are you planning to implement a DOS shell? A. No. A native Windows version of AMP is available for background playback. Q. I've got two AWE32 compatible cards installed. How can I specify which one to use? A. Use '-Xn' option on the command line (or add it into your AMP.INI). Q. There is one more feature I would appreciate: Writing the output as WAV files. A. The EMU8000's output is not available as digital data directly. Simply, there is no data path. The only way how to record the sound without quality loss is by using a sampler, DAT or a minidisk recorder connected to the sound card's digital output (SPDIF interface). You can also use the digital input of the new Sound Blaster Live for such a conversion. Anyway, you can obtain good recordings by sampling the output with the internal A/D converter on the SB AWE card. No external cabling is required for this analog path. If you sample at full rate (44.1 kHz) with all other inputs (except the MIDI synth) muted, you should get quite good quality. Note that you need to use AMP for Windows, as it retains the ADC part of your sound card and enough free CPU power available to another applications. Q. I'd like to know how to pronounce your name correctly. A. If you have the Creative Text Assist software installed, launch Text Assist Dictionary, type "laadya kopetzki" (without the quotes) into the Sound Like box, and then push Say It. What you get is not too far from reality. :-) Q. Are you planning to make a version of AMP for Linux? A. Currently I have no such plans. Reasons are: - the source code is not portable (due to many 16-bit specific constructions and optimizations) - lack of time for coding Q. Does AMP work with the new Sound Blaster Live? A. No, as the new chip EMU10K1 is not backwards compatible with EMU8000. For SB Live you need to get the new AMP clone, called LMP. To download it, check the official AMP distribution sites. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 19. COMMENTS AND SUGGESTIONS ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ In case you find any major or minor problem with the player, don't hesitate to contact me. But first, please, try to find the circumstances in which the problem appears. I would also appreciate your comments (both positive and negative) on the software itself. A preferred way how to send your very first comments is to go through the process of registration, as described in section #16. << NOTE FOR PROGRAMMERS: If you want to contribute by writing another file selector plugin, you're welcome. Just drop me a message. >> But enough words! Now it's time to launch AMP and enjoy the music... ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 20. CONTACTING THE AUTHOR ÆÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ If you wish to contact the author for any reason, send e-mail to: kopecky@tsoft.cz