Groovy Bytes: Behind the Moon

home *** CD-ROM | disk | FTP | other *** search

/ Groovy Bytes: Behind the Moon / groovybytes.iso / GROOVY / SND_TOOL / MORGL110.ZIP / MORGUL.DOC < prev next >

Wrap

Text File | 1994-11-27 | 39.7 KB | 692 lines

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ @F9 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒┌──────────────────────────────────────────────────────┐▒▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ The Morgul Player 1.10 Online Help Documentation │░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ │░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│Keep this file in your path or in the directory where │░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│you start Morgul from. In Morgul you can access this │░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│file by pressing Alt-H. If this file is not found, │░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│you will only get the quick help screen. If you are │░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│not reading this document with Morgul, you should use │░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│the included README.EXE program to read this file. │░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│If you read this document with an external ascii │░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│viewer or editor, please set line wrapping off so that│░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│the control codes outside the screen will not become │░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│visible. That way this document looks much cleaner. │░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒└──────────────────────────────────────────────────────┘░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▒▒▒▒▒▒▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ @A0 Introduction @Z1Introduction ------------ @A0 The Morgul Player is a music file player, which plays most music file formats on all popular sound devices. The sound output system is DSMI, which allows for lots of features and flexibility. Morgul is free software, which means you can copy it to your friends, upload it to BBS's and FTP sites, and distribute in other similar ways as long as no money is involved and all the files are included. If you find yourself using this program, you are asked to send me a postcard or a CD(-Rom). My mail address and more specific info about terms of distribution can be found at the end of this file. If a company which publishes PD/SW software on CD-Rom or floppies, wishes to include Morgul in their publication, they must send me one copy of the Cd-Rom/floppy they are publishing so I can get a look at how Morgul is being distributed. I am also willing to make special editions for special purposes, contact me for more information. Currently the following popular sound cards and their compatibles are supported: 1 Sound Blaster @F0 2 Sound Blaster Pro 3 PAS+ 4 PAS16 5 SB16 and SB AWE 32 6 general DAC (Covox) 7 Aria cards, like Audiobahn 8 Windows Sound System & compatibles, like AudioTrix Pro and Compaq BusinessAudio 9 Gravis Ultrasound and Gus MAX 10 PC Speaker 11 Stereo DAC (LPT1 & 2) 12 Stereo-on-1 DAC @A0 The following file formats are currently supported: MOD,NST Sound/Noise/Pro/Fast/TakeTracker,PT4Gus and so on, also @F0 reverse file names (MOD.* NST.*) are supported. STM Scream Tracker 2.x 4 channel files S3M Scream Tracker 3 1-16 channel files (AdLib channels not supported) MTM MultiTracker 1-32 channel files FAR Farandole Tracker 16-channel files 669 669 Composer 8-channel files AMF Special module format which only DSMI players can play. Other modules converted to this format will be smaller than the originals. @A0 What separates Morgul from other players is the advanced file manager where you can choose files using the arrow keys or tag several files into play queues. You can also COPY and DELETE wanted/unwanted files! The file manager is active always, not only before the actual module playing. All common archive formats are supported, and the archives are searched for module files which can then be played like any other modules. Morgul takes care of calling the unarchiver. Archive formats currently supported are ARJ,ZIP,LZH/LHA,SQZ,RAR,UC2 and HA. For playing the larger modules, Morgul can take advantage of EMS memory, loading the instruments into EMS. Digital, user-definable effects makes modules sound even better than they used to! For example, Hall Reverb can make modules sound like they were played in a big hall. Currently available effect types are reverb and filter. The Reverb effects can be edited real-time. Some or all of the channels can be Surround-Panned. Because of advanced mixing techniques, the sound quality is generally better on 8-bit cards than with other players, and Morgul is one of the few players to take advantage of the extra sound quality offered by the 16-bit sound cards. Sound quality can be further enhanced by using the 2 available filters. Because Morgul is very feature-rich, there is a quick help screen, a command menu, and online documentation (which is actually this file). These can help you take full advantage of Morgul's capabilities. Morgul can be configured to your tastes by using the configuration file Morgul.cfg. All command line switches can be put to the MORGUL environment variable so you don't have to type them over and over again. You can try out and play the samples in the modules and then save them in unsigned or signed (Amiga) raw, Microsoft WAVE or Scream Tracker 3 formats. Support for GUS patches is coming. In the DOS Shell, you can change the master volume and position of the module which is currently playing using the shell hotkeys + and - on the numeric keypad, accompanied with Alt or Control. An option to use the keyboard LEDs as VU meters! Special support for the OS/2+GUS-combo, uses some OS/2 features. Requirements @Z2Requirements ------------ @A0 386 compatible processor. If you have a 486, Morgul will use some 486-specific optimizations for more speed. VGA-compatible display adapter. EGA adapters work partially. Mouse and soundcard optional (although a soundcard is highly recommended, the internal speaker doesn't sound too good. If you can't afford a soundcard, build a "Covox" device which is a simple DAC in the printer port.) If you want real sound quality, get a Gravis Ultrasound board. @C0 (This little advertisement is not funded by Advanced Gravis, @A0 although it certainly would not hurt me if it was :) Possible bugs @F0 @A0 All comments and bug reports are very welcome! See the contact methods near the end of this document. Some of the bug reports I receive are just about as useful as "Hi! Your program crashes on me!", so if you find a problem for which there is no solution in this document or in Morgul.Faq, please give me at least this information: Operating system and version (type ver /r and give all the info it gives), What memory manager and what version of it you were running, if any, your config.sys and autoexec.bat contents, what machine you have (processor, chipset, bios, video adapter), the sound board you are using, including version numbers and everything, specific instructions for reproducing the error situation: Telling "Well I started it and soon it crashed." won't help me to find the bug, but if you tell the directory and path you were in, how and with what parameters Morgul was started with, the contents of the Set Morgul environment variable, the contents of the morgul.cfg file (you can leave out the comment lines to reduce bug report size ;) and what you did inside Morgul, and if you shelled, what software and commands you ran, I could be able to something about the problem. All error messages are important! Instructions @Z4Instructions ------------ @A0 Note: If you find it hard to learn all the keys, just remember this one: Alt-M. It will bring up a menu of functions and also shows the keys for each function. The file system and startup @F0 @A0 When the Morgul starts up, it loads the current directory, searching for module files. When that's done, the file selection screen shows up. Here you can move up and down in the file list with the cursor keys and tag files for playing with space or enter. If the reading of the directory seems to take forever, like if you have lots of modules on a slow CD-Rom, you can press a key during the directory load to abort the loading of the songnames from the modules. This speeds up dir loading considerably. There are two ways to work with files in Morgul. The default one is called the Easy mode, where everything works like in normal programs: If you press enter or space on a file, it will start playing right away. However, if you need more flexibility, you can switch off the Easy mode (press Alt-E or use the -e switch, or the configfile Easymode option.) Without the Easy mode, Morgul acts as follows: When you tag your first file, Morgul loads it immediately and starts playing it. When you tag more files, they will be added in the playing list, so that when you press N or the currently playing module ends, it will go automatically for the next file and play that. When all files are played, it will go back to the beginning. If you have Random mode on (achieved by pressing ALT-R or using cmdline/environment parameter -o, or the config file), Morgul will play the tagged files in random order. Because of it's features, Morgul is a good "demo" program for people who run soundcard demostrations on their machines. They can tag several good module files and let it play through them all over and over again, without having to worry about either the player repeating the same thing all the time or changing the module themselves. If you use Morgul for this kind of purposes, you must send me a postcard from your company, in which you tell me exactly how you use the program, and what kind of company you run, and possibly other information. (You're also welcome to send me any samples of the hardware you sell, I'm always open for bribes :) Archive support @F0 @A0 Morgul needs the correct unpackers if you wish to play modules from archives. The unpackers are searched from the path, with these filenames: ARJ.EXE, PKUNZIP.EXE, LHA.EXE, SQZ.EXE, RAR.EXE, UC.EXE and HA.EXE. If these are not found, you will receive a "File error" message when playing archived modules. The modules are extracted to a temp directory pointed to by the SET TEMP environment variable. If TEMP is not found, TMP is used, and if that is not found, C:\$ARCTMP$ will be used. It is recommended you point TEMP to a fast hard drive or a ramdisk. Note: Even for READING UC2 files, you will need UC.EXE in your path, because the only possible way for third-party developers supporting UC2 to read the file contents is to execute UC.EXE with a special parameter and then read it's output. This is because even the directory structure of an UC2 archive is compressed! Also, to play UC2'ed files, you will probably run out of memory because UC2 needs lots of memory. If you experience this, you can use UltraStealth. Install UltraStealth into your autoexec.bat file (add C:\UC\US.EXE to the end of autoexec.bat) and enable UltraStealth from the Morgul config file by setting UltraStealth=On. The multiple screens @F0 @A0 The Morgul consists of 3 different screens (somebody calls them "virtual screens".) The middle one is the default one which you see at the startup: It has the file selector system. The other two ones are the top and bottom screen. You can scroll between them with Page Up and Page Down keys, or by pressing Alt-1, Alt-2, Alt-3 or Alt-4. You can also change the default startup screen with the cmdline/ environment parameter -r[1,2,3,4] or in the config file. The topmost screen is the most interesting one. Here you can see the instrument names, volume bars, and other information about the currently playing module file. It is also possible to do different operations from here. You can play the instruments of the module YOURSELF on the keyboard! Open extra channels for yourself with the Ctrl-left and Ctrl-Right keys, then press TAB and you can move around in the instrument list with the cursor keys. 2 3 5 6 7 9 0 @F0 q w e r t y u i o p @A0 These are the keys you can use for playing the instruments. If you don't want the module to disturb your fine music, press Alt-p to pause the module. If you open several extra channels, you can play several voices simultaneously. Pressing TAB again gets you back to the normal "file" mode. Please note that even if you're not in the file screen or in the instrument screen, you can still use all the keys. So you can press Enter anywhere to go to the next module, or play the instruments while looking at the files or the helpscreen. Drum Machine Mode @F0 @A0 Pressing CTRL-D brings you into the drum machine mode. In this mode, if a module is loaded, you can play different samples without first selecting them by pressing the keys from 1 to 0 and from a to z. The instrument will play at it's base frequency. This mode is especially meant for trying out drum instruments in a module. Remember that you need to have opened extra channels for Drum Machine Mode, just like you would have to in the Instrument playing mode. Instrument saving @F0 @A0 When you have activated the instrument playing mode with TAB, you have the red selector bar which you can also use to save the instruments to disk. Move the selector bar to the instrument you want to save ( you can of course test it first!), then press Alt-S. You will be asked for the instrument type. Press S for ScreamTracker 3, W for WAV, U for 8-bit mono unsigned raw, or A for 8-bit mono signed raw (Amiga). Then you will be asked for a file name. In the file name asker, you can also see the speed and size of the instrument. The track screen @F0 @A0 Pressing Alt-T will activate the track screen which shows the notes, their octaves and samples go by on the channels as they are played. The track screen will replace the volume bar screen. The tracks are made of 6-character fields, looking like this: E-3-01 @F0 │ │ ││ │ │ │└──────────── The number of the instrument │ │ └───────────── which is currently being played. │ │ │ └─────────────── The octave of the note └───────────────── The note, and whether or not it is #'ed. @A0 Press Alt-T to deactivate the track screen and get the volume bars back. Note that if you hit alt-t twice, the whole screen will be redrawn. Use it if the screen gets messed up by something. The graphics mode @F0 @A0 This is the standard starfield thing with volume bars/scope and swelling stars and a logo. While you're in the graphics mode, all the keys will still work, although you can't see much of anything. You can choose between volume bars and a crappy graphical scope by pressing Alt-1 or Alt-2. The color of the scope can be changed with ctrl-r,ctrl-g and ctrl-b, like in text mode. With F4 you can cycle the colors one step at a time. Try pressing it when the stars do a Warp 3! This feature is not implemented seriously. The Help Screen @F0 @A0 Screen number 3 (the bottom one) is the help screen, accessible via either Page Down or H. There's nothing to do here except look at the instructions. It is very recommended to do so! There are many things that you would miss otherwise. Pressing Alt-H will give you this documentation if it's in the current directory or in the path. If not, it will simply give you the quick help screen. Pressing Alt-M will give you a menu where you can choose commands. Dos Shell @F0 @A0 While in Dos Shell you can change the volume of the music with Alt- and Alt+ (on the numeric keypad) and skip patterns with Ctrl+/Ctrl- on the numeric keypad. File copying @F0 @A0 If you have no tagged files, pressing Alt-C will copy the file under the cursor to the specified location. If you have tagged files, all tagged files will be copied to the location. If you specify a drive or a directory or drive+directory, the file(s) will be copied there, if you specify [drive+][directory+]filename, the file(s) will be copied to that filename. If you have no tagged files and you are on the "." directory, all files in the directory will be copied. To allow flexible pathname handling, your command processor is executed to do the actual copying. Morgul uses the COMSPEC environment variable so users of 4Dos and other command.com replacements will have no trouble at all. Configuration file @F0 @A0 You can change the default settings by putting the appropriate switches into a SET MORGUL=switches statement in your autoexec.bat, but you can also use the Morgul.cfg configuration file. Use any ascii editor to change the values in there, and keep the file either in your path or in the directory you start Morgul from. The configuration file options are explained in detail in the config file itself. Look at the config file before you start demanding me for new features, they might already be there! Config file parameters are overriden by the SET MORGUL= environment variable, and these both are overriden by the command line. Digital Effects @F0 @A0 By pressing Alt-F, you can choose a Digital Effect to enhance your sound enjoyment! The effects are defined in morgul.cfg and you need the file if you want to have the predefined digital effects. You can make your own digital effects either by editing the morgul.cfg file directly, or using the Effect Setup feature of Morgul, activated by selecting Realtime Effect Setup in the Alt-F menu or by pressing Ctrl-F. Keyboard Lights @F0 @A0 With the -l parameter or with the KeyboardLights config file option, you can enable the use of the keyboard LEDs as VU meters. This mode should be on by default but it is not, as it messes up with the keyboard so that not all keys work, and you'll have to press both shift keys every now and then. I'm working on this.. Directory Saving @F0 @A0 You can save the current directory to a file "taglist.mrg" by pressing F2. The next time Morgul starts up in this directory (or you change to this directory in Morgul), this file will be loaded instead of loading the directory and scanning all modules and archives. Saving the directory is HIGHLY recommended if you have many archives and/or modules in the same directory. You can also save your taggings this way, and when Morgul starts in this directory the next time, it will start playing right away. The Overlay System @F0 @A0 To allow for extra doodads like graphic logos without loss of memory, an overlay system called MOVERLAY was developed. You can unpack the MO.EXE file with any quality EXE unpacker like UNP v4.00 from Ben Castricum, or with PKLITE, if you like. The exe will still run, so you can check for embedded viruses (There are none, of course.) List of all available keys and commands @Z5Commands @A0 ░░░┌───The─Morgul─Help─Screen───────────────────────────────────────────────┐░░░ @F9 ░░░│ Available keys: │░░░ ░░░│ Alt-M Menu Alt-F Digital Effects │░░░ ░░░│ Alt-P Pause module Ctrl-F Setup Digital Eff │░░░ ░░░│ Alt-J Shell to Dos CTRL-P Panning setup screen│░░░ ░░░│ Alt-V Toggle 80x56 mode PgUp/Pgdn Scroll the files │░░░ ░░░│ Alt-D Delete current file CTRL-PgUp/Dn Scroll the screen │░░░ ░░░│ Alt-H,F1 ONLINE DOCS CTRL-V Change Master Volume│░░░ ░░░│ Alt-T Track screen ^R,^G,^B Change box color │░░░ ░░░│ Alt-S Instrument saving Alt-1,2,3,4 Change active screen│░░░ ░░░│ Alt-R Toggle Random order Tab Switch between Instr│░░░ ░░░│ Alt-E Toggle Easy filemode /File Mode │░░░ ░░░│ Alt-C Copy files Ctrl-Left/ Increase/Decrease │░░░ ░░░│ Ctrl-D Toggle drum machine mode Ctrl-Right channel amount │░░░ ░░░│ Insert Tag ALL files ESC Exit │░░░ ░░░│ Delete UnTag ALL files Q...P Play instruments │░░░ ░░░│ Space In File mode TAG module Arrows Move in instrument │░░░ ░░░│ N Go to next tagged or file list │░░░ ░░░│ module and play it Home/End Go to beginning /end│░░░ ░░░│ F2 Save directory of file/instr. list │░░░ ░░░│ Graphics mode: │░░░ ░░░│ Alt-G toggle graphics mode Alt-1 Select volume bars │░░░ ░░░│ ESC exit graphics mode Alt-2 Select scope │░░░ ░░░│ F3 Negative image F4 Cycle colors 1 step │░░░ ░░░└────────────────────────────────────────────────────────────────────────┘░░░ Command line parameters @A0 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ @F9 ░░░┌───Available─command─line/environment─set─options─for─Morgul────────────┐░░░ ░░░│ │░░░ ░░░│ -r Select startup screen 1,2,3 -c Select sound device │░░░ ░░░│ -o Select Random mode -d Select sound card DMA chan │░░░ ░░░│ -n Set default panning -i Select scard interrupt │░░░ ░░░│ -v Set 80x56 mode -p Select scard port │░░░ ░░░│ -a Select Amplify rate -t Select DMA buffer size │░░░ ░░░│ -j Select bar color (0,1,2) -g Disable Gus DMA usage │░░░ ░░░│ -l Enable keyboard lights -b Disable use of EMS memory │░░░ ░░░│ -fxx Select digital effect xx -s Select sample rate │░░░ ░░░│ -m monochrome mode │░░░ ░░░│ Available sound device numbers: │░░░ ░░░│ 1=SB,2=SB Pro,3=PAS+,4=PAS16,5=SB16,6=DAC,7=Aria,8=Windows Sound │░░░ ░░░│ System/AudioTrix/BusinessAudio,9=Gravis Ultrasound,10=Speaker, │░░░ ░░░│ 11/12=Stereo DAC │░░░ ░░░│ These options can be used from the command line and also by │░░░ ░░░│ adding the line Set Morgul=options in your Autoexec.bat file. │░░░ ░░░│ │░░░ ░░░└────────────────────────────────────────────────────────────────────────┘░░░ @A0 The file screen explained ░ The Morgul 1.10 by Toni Nikkanen 1994. DSMI (C) Otto Chrons 1992-1994. ░░ @F9 ░ Press CTRL-Pgup for the module screen,CTRL-Pgdn for help or Alt-M for menu ░░ ░░░┌────────────────────────────────────────────────────────────────────────┐░░░ ░░▓│ Filesize: 25kb Patterns: 21 Samples: 5 Files tagged: 1 │░░░ ░░▓│ │ │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│ │ │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│ │ │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│ │ │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│ │ │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│ │ │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│. │A directory │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│.. │A directory │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│MODULE.MOD │And here's it's description │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│2ND_SKAV.S3M │Here's another module file │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│ │ │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│ │ │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│ │ │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│ │ │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│ │ │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│ │ │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓│ │ │ ■■■■■■■■■■■■■■■■■■■■ │░░░ ░░▓└Directory: E:\MODULE────────────────────────────────────────────────────┘░░░ ░░▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ░░ ░░░ ░░ ░░░ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ @A0 The file size means the size of the current file in kilobytes, patterns means the amount of patterns (the length) of the file, samples means how many samples (instruments) there are in it, and Files tagged means how many files you have tagged. The first column is where the file names will be. In this example file there are MODULE.MOD and 2ND_SKAV.S3M. In the next column is the module's song name. The next one (with ■■ characters) is graphical display of the file's size. At the lowermost part of the screen is a volume bar just for fun. The current directory is shown just below the file names. If a module with a description like "Inside MODULE.ARJ" or "Inside MODULE.ZIP" or so on appears, it means it is inside an archive. You can play these just like normal modules, the unarchiver will be called automatically. Note that Morgul is capable of using the unarchivers if they are as BAT/BTM files or even aliases. Tested software and hardware configurations: @Z3Tested s/hware @A0 MS-Dos 2.11 (YES!), MS-Dos 5.00, Ms-Dos 6.00, Ms-Dos 6.20, Dr Dos 6.0, PC-Dos 5.0, Novell Dos 7. OS/2 2.1 and Warp 2 with GUS. Morgul detects OS/2 and sets the correct parameters automatically. When Morgul is iconized or windowed, the icon/window title shows the position of the module. Timeslice releasing is supported. Quarterdeck DESQview 2.60 & 2.61 work on some computers. On some computers, scrolling does not show and only the first 25 lines of the first screen become visible. Timeslice releasing is supported but untested. It is possible to make Morgul work under Windows. Under some configurations it will work, and under others it won't. Try and see what happens, and send me info about what happened. Warning: Windows might very well crash. Windows time slice releasing is also supported, but untested. Quarterdeck QEMM 6.0-7.5, Microsoft EMM386, Qualitas 386^Max (works perfect, but on slow computers the Covox/Speaker support might hang the computer because these protected mode programs slow interrupts. They also decrease sound quality with Covox/Speaker devices.) Novell EMM386: In DOS Shell the music might slow down strangely. If you disable EMM386 or change to another memory manager, the problem disappears. UMB_DRVR 5.22: works perfectly, except for UMB_EMS4.SYS DON'T use Qemm's Vidram, it prevents Morgul from using 80x28 text mode, or if it doesn't, causes crashes. Helix Software NetRoom 3.02 (Works, and the Stretch utility, similar to Vidram, works perfectly, unlike Vidram.) Linux Dosemu 0.52pl0: Works, if you have vga console graphics set on, but cannot play anything. I believe it is currently impossible to use sound boards in dosemu. Somebody could try this under Windows NT, NeXTStep/486, Solaris, InterActive Unix, SCO Unix and the rest, and tell me about the results. Also it would be fun to know whether or not it runs on PowerMacintosh dos emulation, and AlphaPC-WindowsNT Dos emulation. Contact information: @Z6Contact @B0 Product: The Morgul Player 1.10 Author: Toni Nikkanen / Morgul Software Address: Kymenlaaksonkatu 9 D 47 SF-48100 Kotka Finland, Europe Voice: +358 52 15817 e-mail: tnikkane@clinet.fi (send uuencoded files here) You can finger tnikkane@clinet.fi if you want to know the latest news about Morgul. toni@valhall.nullnet.fi tnikkan@garbo.uwasa.fi luovaa@freeneet.hut.fi Fidonet netmail: 2:221/18 BBS: Valhalla Linux, +358 52 181299, leave message to account toni. Hangar BBBS, +358 51 3758236, leave message to Toni Nikkanen in the Posti conference. Credits and interesting info: @Z7Credits @A0 The module playing routines are part of the Digital Sound and Music Interface library by Otto Chrons 1992-1994. Everything else is written by me with Borland C++ 3.1, using C language and a few pieces of assembler. The editor used was Multi-Edit V7.00PN from American Cybernetics. This editor is, by the way, highly recommended and beats even the Semware Editor. The graphics were made by me using Deluxe Paint II Enhanced in a few minutes. The system used was: 386sx20/4MB-->386sx20/5MB-->386dx40/5MB->486dx33/5MB->486dx33/8MB, 202+130+40MB hd,1xspeed CD-Rom, OS/2 2.99 performance beta 2,4Dos,4OS2/32 Thanks go out for the following: @F0 Otto Chrons for making DSMI Pietu Pohjalainen, Rauli Priha, Teemu Koponen for making me buy DSMI Juha Niemi for lots of suggestions and bug reports Robert K Jung for very good ARJ documentation and support Nico de Vries/AIP-NL for very good UC2 support and documentation Harri Hirvola for perfect HA documentation Kari Tuomainen for helping with some messy Pascal sources and several other things Brad Meier for competing with my DMPS with his DMPC (keep on going; don't stop now! Where's your registration card, huh?) Kevin Burfitt for being the nice author of Cthugha Michael Schwendt for Sidplay Miha Peternel for the very expensive C64s (with $80 I could buy a real C64!) Leo Medellin for not being a member of the Medellin Drug Syndicate :) Lars Naber for being so supportive Daniel Tauritz for Dutch translation, ftp site support, aria bug reports and other things. Petri Harkko, Tomi Pahula, Olli Männistö, Jari Turkia for finding lots of bugs Maral / KLF for pointing out bugs with MTM files Ville Voutilainen for being a rather fanatic fanatic. Skaven/FC, PM/FC, C.C.Catch/Ren,Heatbeat, Moby,HMW, Zodiak for making lots of wonderful modules to test Morgul Player with. ID Software For DOOM,DOOM2 and LinuxXDoom J.M.Jarre for making lots of wonderful music which I could listen to while coding Morgul J.R.R. Tolkien for inventing the name of mor-gûl Player Terrgvatf gb Urffh Lyvara. PncnZbq vf n engure tbbq THF cynlre, V ubcr gur QFZV THF ebhgvarf jvyy or nf tbbq nf PncnZbq bar qnl. History ------- @A0 "And it came to pass, that I, an unknown programmer in the land of Finland, got tired of the lack of features in the otherwise very good olde DMP player; so I codeth the DMP Shell programme. And it came to pass, that I attendeth the Assembly'93, and lo and behold! There was a special discount for DSMI; and my friends pressureth me to buy it, which I did. I took the Task of coding the integration of DMP and DMPS; but the project turned out to be much more than a mere integration of the two. And, after a year of development, I decideth to release it, under the name Morgul Player." It has come to my attention that because of the DMP Shell, some people still think I'm the author of DMP too. That is not the case; instead, DMP is (C) 1992-1994 Otto Chrons. Distribution policy and all the legal stuff @Z8Policy ------------------------------------------- @A0 Morgul is freeware, with a few restrictions. The distributable version is in no way crippled and has no nag stuff. If you use this program for more than 7 days, there are two kinds of registration: The lighter one involves sending me a postcard (YES, a snail-mail POSTCARD, and e-mail is nice but it's not a postcard, so it doesn't count) from your homeland telling who you are, where you are, what you are, *where* you got Morgul from and what you think of this program. If possible, the postcard should have a picture of your home town. If you just can't find a postcard anywhere, a letter is also OK. If you want to support this project, you can send me $5 or 20FIM. This will get you the next MAJOR update via post on a 3.5" HD diskette (I can also send on a 5.25" HD diskette, but I can't quarantee it will be okay when it arrives), and it will say it's registered to your name. I will also fill the disk with good module files so if it's hard for you to get updates or modules (you don't have a modem/inet access), this is the way to go. And when I mean MAJOR update, I mean that. So you don't get the NEXT new version if it's not a major enough update. Please specify what version you were using at that time. You can also say "I want a 1.72MB FDFormatted floppy" and you'll get that. Now I am also accepting CDs and CD-Roms as registrations, following the example of Kevin Burfitt. But do not send anything that says "Ed Starink" or "Star Inc.", please. I would like it if somebody sent me the UltraSound Experience CD! If you send a CD, you only have to send $3 or 12mk if you want to have the disk mailed to you as well. Although CD's are usually rather expensive, I still have to require money for sending the disks, as I don't want to lose money. (Actually, I don't have any money to lose :) CD senders get their own VIP section in the regged.txt file in the same place with the money senders, and a feeling that they are really supporting this project. And Remember... Stay cool - don't close the fridge!