home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / dos / music / morgul / morgul.doc < prev    next >
Text File  |  1994-09-09  |  39KB  |  670 lines

  1. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  @F9
  2. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  3. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒┌──────────────────────────────────────────────────────┐▒▒▒▒▒▒▒▒▒▒
  4. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│   The Morgul Player 1.10 Online Help Documentation   │░▒▒▒▒▒▒▒▒▒
  5. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│                                                      │░▒▒▒▒▒▒▒▒▒
  6. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│Keep this file in your path or in the directory where │░▒▒▒▒▒▒▒▒▒
  7. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│you start Morgul from. In Morgul you can access this  │░▒▒▒▒▒▒▒▒▒
  8. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│file by pressing Alt-H. If this file is not found,    │░▒▒▒▒▒▒▒▒▒
  9. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│you will only get the quick help screen. If you are   │░▒▒▒▒▒▒▒▒▒
  10. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│not reading this document with Morgul, you should use │░▒▒▒▒▒▒▒▒▒
  11. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│the included README.EXE program to read this file.    │░▒▒▒▒▒▒▒▒▒
  12. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│If you read this document with an external ascii      │░▒▒▒▒▒▒▒▒▒
  13. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│viewer or editor, please set line wrapping off so that│░▒▒▒▒▒▒▒▒▒
  14. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│the control codes outside the screen will not become  │░▒▒▒▒▒▒▒▒▒
  15. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│visible. That way this document looks much cleaner.   │░▒▒▒▒▒▒▒▒▒
  16. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒└──────────────────────────────────────────────────────┘░▒▒▒▒▒▒▒▒▒
  17. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▒▒▒▒▒▒▒▒▒
  18. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  19.                                                                                   @A0
  20.                               Introduction                                        @Z1Introduction
  21.                               ------------                                        @A0
  22.  
  23.     The Morgul Player is a music module file player, which plays most
  24.     music module formats on all popular sound devices. The sound output
  25.     system is DSMI, which allows for lots of features and flexibility.
  26.  
  27.     Morgul is free software, which means you can copy it to your friends,
  28.     upload it to BBS's and FTP sites, and distribute in other similar
  29.     ways as long as no money is involved and all the files are included.
  30.     If you put this program on a CD-Rom, you are required to send me
  31.     information about that CD. I'd also like a free sample of the CD you
  32.     are making. If you find yourself using this program, you are asked to
  33.     send me a postcard or a CD. My mail address can be found at the end
  34.     of this file.
  35.  
  36.     Currently the following popular sound cards and their compatibles
  37.     are supported:
  38.  
  39.         1 Sound Blaster                                                           @F0
  40.         2 Sound Blaster Pro
  41.         3 PAS+
  42.         4 PAS16
  43.         5 SB16 and SB AWE 32
  44.         6 general DAC (Covox)
  45.         7 Aria cards, like Audiobahn
  46.         8 Windows Sound System & compatibles, like AudioTrix Pro and
  47.           Compaq BusinessAudio
  48.         9 Gravis Ultrasound and Gus MAX
  49.         10 PC Speaker
  50.         11 Stereo DAC (LPT1 & 2)
  51.         12 Stereo-on-1 DAC
  52.                                                                                   @A0
  53.  
  54.             The following module formats are currently supported:
  55.  
  56.     MOD,NST     Sound/Noise/Pro/Fast/TakeTracker,PT4Gus and so on, also           @F0
  57.                 reverse file names (MOD.* NST.*) are supported.
  58.     STM         Scream Tracker 2.x 4 channel files
  59.     S3M         Scream Tracker 3 1-16 channel files (AdLib channels not
  60.                 supported)
  61.     MTM         MultiTracker 1-32 channel files
  62.     FAR         Farandole Tracker 16-channel files
  63.     669         669 Composer 8-channel files
  64.     AMF         Special module format which only DSMI players can play.
  65.                 Other modules converted to this format will be smaller
  66.                 than the originals.
  67.                                                                                   @A0
  68.  
  69.     What separates Morgul from other players is the advanced file manager
  70.     where you can choose files using the arrow keys or tag several files
  71.     into play queues. You can also COPY and DELETE wanted/unwanted files!
  72.     The file manager is active always, not only before the actual module
  73.     playing.  All common archive formats are supported, and the archives
  74.     are searched for module files which can then be played like any other
  75.     modules. Morgul takes care of calling the unarchiver. Archive formats
  76.     currently supported are ARJ,ZIP,LZH/LHA,SQZ,RAR,UC2 and HA.
  77.  
  78.     For playing the larger modules, Morgul can take advantage of EMS
  79.     memory, loading the instruments into EMS.
  80.  
  81.     Digital, user-definable effects makes modules sound even better than
  82.     they used to! For example, Hall Reverb can make modules sound like
  83.     they were played in a big hall. Currently available effect types are
  84.     reverb and filter.
  85.  
  86.     Some or all of the channels can be Surround-Panned.
  87.  
  88.     Because of advanced mixing techniques, the sound quality is generally
  89.     better on 8-bit cards than with other players, and Morgul is one of
  90.     the few players to take advantage of the extra sound quality offered
  91.     by the 16-bit sound cards.
  92.  
  93.     Because Morgul is very feature-rich, there is a quick help screen, a
  94.     command menu, and online documentation (which is actually this file).
  95.     These can help you take full advantage of Morgul's capabilities.
  96.  
  97.     Morgul can be configured to your tastes by using the configuration
  98.     file Morgul.cfg. All command line switches can be put to the MORGUL
  99.     environment variable so you don't have to type them over and over
  100.     again.
  101.  
  102.     You can try out and play the samples in the modules and then save
  103.     them in raw,Microsoft WAVE or Scream Tracker 3 formats. Support for
  104.     GUS patches is coming, as well as signed (Amiga) raw files.
  105.  
  106.     In the DOS Shell, you can change the master volume and position of
  107.     the module which is currently playing using the shell hotkeys + and -
  108.     on the numeric keypad, accompanied with Alt or Control.
  109.  
  110.     An option to use the keyboard LEDs as VU meters!
  111.  
  112.                             Requirements                                          @Z2Requirements
  113.                             ------------                                          @A0
  114.  
  115.     386 compatible processor. If you have a 486, Morgul will use some
  116.     486-specific optimizations for more speed.
  117.     VGA-compatible display adapter. EGA adapters work partially.
  118.  
  119.     Mouse and soundcard optional (although a soundcard is highly
  120.     recommended, the internal speaker doesn't sound too good. If you
  121.     can't afford a soundcard, build a "Covox" device which is a simple
  122.     DAC in the printer port.)
  123.     If you want real sound quality, get a Gravis Ultrasound board.                @C0
  124.     (This little advertisement is not funded by Advanced Gravis,                  @A0
  125.     although it certainly would not hurt me if it was :)
  126.  
  127.  
  128.  
  129.                             Possible bugs                                         @F0
  130.                                                                                   @A0
  131.  
  132.     As some of my pre-public beta stage testers have mostly been lazy,
  133.     testing under different situations is not perfect. Some of the bug
  134.     reports I receive are just about as useful as "Hi! Your program
  135.     crashes on me." Also, DSMI seems to have a couple of small bugs. All
  136.     comments and bug reports are very welcome! See the contact methods
  137.     near the end of this document. If you do a bug report, please report
  138.     at least the following:
  139.  
  140.     Operating system and version (type ver /r and give all the info it
  141.     gives), What memory manager and what version of it you were running,
  142.     if any, your config.sys and autoexec.bat contents, what machine you
  143.     have (processor, chipset, bios, video adapter), the sound board you
  144.     are using, including version numbers and everything, specific
  145.     instructions for reproducing the error situation: Telling "Well I
  146.     started it and soon it crashed." won't help me to find the bug, but
  147.     if you tell the directory and path you were in, how and with what
  148.     parameters Morgul was started with, the contents of the Set Morgul
  149.     environment variable, the contents of the morgul.cfg file (you can
  150.     leave out the comment lines to reduce bug report size ;) and what you
  151.     did inside Morgul, and if you shelled, what software and commands you
  152.     ran. All error messages are important!
  153.  
  154.  
  155.  
  156.                             Instructions                                          @Z4Instructions
  157.                             ------------                                          @A0
  158.  
  159.     Available topics (press the appropriate number to get there)                  @F0
  160.                                                                                   @A0
  161.     1       Introduction
  162.     2       Hardware and software requirements
  163.     3       Tested software and hardware combinations
  164.     4       Instructions (this part)
  165.     5       Available keys and commands
  166.     6       Contact information
  167.     7       Credits, greetings
  168.     8       Distribution policy, closing words
  169.  
  170.  
  171.     Note: If you find it hard to learn all the keys, just remember this
  172.     one: Alt-M. It will bring up a menu of functions and also shows the
  173.     keys for each function.
  174.  
  175.                          The file system and startup                              @F0
  176.                                                                                   @A0
  177.     When the Morgul starts up, it loads the current directory, searching
  178.     for module files. When that's done, the file selection screen shows
  179.     up. Here you can move up and down in the file list with the cursor
  180.     keys and tag files for playing with space or enter.
  181.  
  182.     There are two ways to work with files in Morgul. The default one is
  183.     called the Easy mode, where everything works like in normal programs:
  184.     If you press enter or space on a file, it will start playing right
  185.     away. However, if you need more flexibility, you can switch off the
  186.     Easy mode (press Alt-E or use the -e switch, or the configfile
  187.     Easymode option.)
  188.  
  189.     Without the Easy mode, Morgul acts as follows:
  190.  
  191.     When you tag your first file, Morgul loads it immediately and starts
  192.     playing it. When you tag more files, they will be added in the
  193.     playing list, so that when you press N or the currently playing
  194.     module ends, it will go automatically for the next file and play
  195.     that. When all files are played, it will go back to the beginning. If
  196.     you have Random mode on (achieved by pressing ALT-R or using
  197.     cmdline/environment parameter -o, or the config file), Morgul will
  198.     play the tagged files in random order.
  199.  
  200.     Because of it's features, Morgul is a good "demo" program for people
  201.     who run soundcard demostrations on their machines. They can tag
  202.     several good module files and let it play through them all over and
  203.     over again, without having to worry about either the player repeating
  204.     the same thing all the time or changing the module themselves. If you
  205.     use Morgul for this kind of purposes, you must send me a postcard
  206.     from your company, in which you tell me exactly how you use the
  207.     program, and what kind of company you run, and possibly other
  208.     information. (You're also welcome to send me any samples of the
  209.     hardware you sell, I'm always open for bribes :)
  210.  
  211.                              Archive support                                      @F0
  212.                                                                                   @A0
  213.     Morgul needs the correct unpackers if you wish to play modules from
  214.     archives. The unpackers are searched from the path, with these
  215.     filenames: ARJ.EXE, PKUNZIP.EXE, LHA.EXE, SQZ.EXE, RAR.EXE, UC.EXE
  216.     and HA.EXE. If these are not found, you will receive a "File error"
  217.     message when playing archived modules.
  218.     The modules are extracted to a temp directory pointed to by the SET
  219.     TEMP environment variable. If TEMP is not found, TMP is used, and if
  220.     that is not found, C:\$ARCTMP$ will be used. It is recommended you
  221.     point TEMP to a fast hard drive or a ramdisk.
  222.  
  223.     Note: Even for READING UC2 files, you will need UC.EXE in your path,
  224.     because the only possible way for third-party developers supporting
  225.     UC2 to read the file contents is to execute UC.EXE with a special
  226.     parameter and then read it's output. This is because even the
  227.     directory structure of an UC2 archive is compressed! Also, to play
  228.     UC2'ed files, you will probably run out of memory because UC2 needs
  229.     lots of memory. If you experience this, you can use UltraStealth.
  230.     Install UltraStealth into your autoexec.bat file (add C:\UC\US.EXE to
  231.     the end of autoexec.bat) and enable UltraStealth from the Morgul
  232.     config file by setting UltraStealth=On.
  233.  
  234.  
  235.                            The multiple screens                                   @F0
  236.                                                                                   @A0
  237.     The Morgul consists of 3 different screens (somebody calls them
  238.     "virtual screens".) The middle one is the default one which you see
  239.     at the startup: It has the file selector system. The other two ones
  240.     are the top and bottom screen. You can scroll between them with Page
  241.     Up and Page Down keys, or by pressing Alt-1, Alt-2, Alt-3 or Alt-4.
  242.     You can also change the default startup screen with the cmdline/
  243.     environment parameter -r[1,2,3,4] or in the config file.
  244.  
  245.     The topmost screen is the most interesting one. Here you can see the
  246.     instrument names, volume bars, and other information about the
  247.     currently playing module file. It is also possible to do different
  248.     operations from here. You can play the instruments of the module
  249.     YOURSELF on the keyboard! Open extra channels for yourself with the
  250.     Ctrl-left and Ctrl-Right keys, then press TAB and you can move around
  251.     in the instrument list with the cursor keys.
  252.  
  253.                             2 3   5 6 7   9 0                                     @F0
  254.                            q w e r t y u i o p
  255.                                                                                   @A0
  256.     These are the keys you can use for playing the instruments. If you
  257.     don't want the module to disturb your fine music, press Alt-p to
  258.     pause the module. If you open several extra channels, you can play
  259.     several voices simultaneously, with ANY soundcard supported! This
  260.     might be some fun.
  261.  
  262.     Pressing TAB again gets you back to the normal "file" mode.
  263.  
  264.     Please note that even if you're not in the file screen or in the
  265.     instrument screen, you can still use all the keys. So you can press
  266.     Enter anywhere to go to the next module, or play the instruments
  267.     while looking at the files or the helpscreen.
  268.  
  269.                             Drum Machine Mode                                     @F0
  270.                                                                                   @A0
  271.     Pressing CTRL-D brings you into the drum machine mode. In this mode,
  272.     if a module is loaded, you can play different samples without first
  273.     selecting them by pressing the keys from 1 to 0 and from a to z. The
  274.     instrument will play at it's base frequency. This mode is especially
  275.     meant for trying out drum instruments in a module. Remember that you
  276.     need to have opened extra channels for Drum Machine Mode, just like
  277.     you would have to in the Instrument playing mode.
  278.  
  279.                             Instrument saving                                     @F0
  280.                                                                                   @A0
  281.     When you have activated the instrument playing mode with TAB, you
  282.     have the red selector bar which you can also use to save the
  283.     instruments to disk. Move the selector bar to the instrument you want
  284.     to save ( you can of course test it first!), then press Alt-S. You
  285.     will be asked for the instrument type. Press S for ScreamTracker 3, W
  286.     for WAV or N for Normal (8-bit mono unsigned raw). Then you will be
  287.     asked for a file name. In the file name asker, you can also see the
  288.     speed and size of the instrument.
  289.  
  290.                             The track screen                                      @F0
  291.                                                                                   @A0
  292.     Pressing Alt-T will activate the track screen which shows the notes,
  293.     their octaves and samples go by on the channels as they are played.
  294.     The track screen will replace the volume bar screen. The tracks are
  295.     made of 6-character fields, looking like this:
  296.  
  297.     E-3-01                                                                        @F0
  298.     │ │ ││
  299.     │ │ │└──────────── The number of the instrument
  300.     │ │ └───────────── which is currently being played.
  301.     │ │
  302.     │ └─────────────── The octave of the note
  303.     └───────────────── The note, and whether or not it is #'ed.
  304.                                                                                   @A0
  305.     Press Alt-T to deactivate the track screen and get the volume bars
  306.     back. Note that if you hit alt-t twice, the whole screen will be
  307.     redrawn. Use it if the screen gets messed up by something.
  308.  
  309.                             The graphics mode                                     @F0
  310.                                                                                   @A0
  311.     This is the standard starfield thing with volume bars and swelling
  312.     stars and a logo. While you're in the graphics mode, all the keys
  313.     will still work, although you can't see much of anything. I'm
  314.     currently working to make it even better, but the main development
  315.     direction is not here.
  316.  
  317.                              The Help Screen                                      @F0
  318.                                                                                   @A0
  319.     Screen number 3 (the bottom one) is the help screen, accessible via
  320.     either Page Down or Alt-3. There's nothing to do here except look at
  321.     the instructions. It is very recommended to do so! There are many
  322.     things that you would miss otherwise. Pressing Alt-H will give you
  323.     this documentation if it's in the current directory or in the path.
  324.     If not, it will simply give you the help screen. Pressing Alt-M will
  325.     give you a menu where you can choose commands.
  326.  
  327.                                Dos Shell                                          @F0
  328.                                                                                   @A0
  329.     While in Dos Shell you can change the volume of the music with Alt-
  330.     and Alt+ (on the numeric keypad) and skip patterns with Ctrl+/Ctrl-
  331.     on the numeric keypad.
  332.  
  333.                               File copying                                        @F0
  334.                                                                                   @A0
  335.     If you have no tagged files, pressing Alt-C will copy the file under
  336.     the cursor to the specified location. If you have tagged files, all
  337.     tagged files will be copied to the location. If you specify a drive
  338.     or a directory or drive+directory, the file(s) will be copied there,
  339.     if you specify [drive+][directory+]filename, the file(s) will be
  340.     copied to that filename.
  341.     If you have no tagged files and you are on the "." directory, all
  342.     files in the directory will be copied.
  343.  
  344.     To allow flexible pathname handling, your command processor is
  345.     executed to do the actual copying. Morgul uses the COMSPEC
  346.     environment variable so users of 4Dos and other command.com
  347.     replacements will have no trouble at all.
  348.  
  349.                             Configuration file                                    @F0
  350.                                                                                   @A0
  351.     You can change the default settings by putting the appropriate
  352.     switches into a SET MORGUL=switches statement in your autoexec.bat,
  353.     but you can also use the Morgul.cfg configuration file. Use any ascii
  354.     editor to change the values in there, and keep the file either in
  355.     your path or in the directory you start Morgul from. The
  356.     configuration file options are explained in detail in the config file
  357.     itself. Look at the config file before you start demanding me for new
  358.     features, they might already be there! Config file parameters are
  359.     overriden by the SET MORGUL= environment variable, and these both are
  360.     overriden by the command line.
  361.  
  362.  
  363.                             Digital Effects                                       @F0
  364.                                                                                   @A0
  365.     By pressing Alt-F, you can choose a Digital Effect to enhance your
  366.     sound enjoyment! The effects are defined in morgul.cfg and you need
  367.     the file if you want to have the digital effects.
  368.  
  369.                             Keyboard Lights                                       @F0
  370.                                                                                   @A0
  371.     With the -l parameter or with the KeyboardLights config file option,
  372.     you can enable the use of the keyboard LEDs as VU meters. This mode
  373.     should be on by default but it is not, as it messes up with the
  374.     keyboard so that not all keys work, and you'll have to press both
  375.     shift keys every now and then. I'm working on this..
  376.  
  377.                             Directory Saving                                      @F0
  378.                                                                                   @A0
  379.     You can save the current directory to a file "taglist.mrg" by
  380.     pressing F1. The next time Morgul starts up in this directory (or you
  381.     change to this directory in Morgul), this file will be loaded instead
  382.     of loading the directory and scanning all modules and archives.
  383.     Saving the directory is HIGHLY recommended if you have many archives
  384.     and/or modules in the same directory. You can also save your taggings
  385.     this way, and when Morgul starts in this directory the next time, it
  386.     will start playing right away.
  387.  
  388.                           The Overlay System                                      @F0
  389.                                                                                   @A0
  390.     To allow for extra doodads like graphic logos without loss of memory,
  391.     an overlay system called MOVERLAY was developed. This extremely
  392.     flexible, fast and advanced system is also easy to use. You can
  393.     unpack the MO.EXE file with any quality EXE unpacker like UNP v4.00
  394.     from Ben Castricum, or with PKLITE, if you like. The exe will still
  395.     run, so you can check for embedded viruses (There are none, of
  396.     course.) (You can contact me if you want this small, fast and easy
  397.     system for your use.)
  398.  
  399.  
  400.  
  401.                 List of all available keys and commands                           @Z5Commands
  402.                                                                                   @A0
  403. ░░░┌───The─Morgul─Help─Screen───────────────────────────────────────────────┐░░░  @F9
  404. ░░░│ Available keys:                                                        │░░░
  405. ░░░│ Alt-M    Menu                         F1           Save directory      │░░░
  406. ░░░│ Alt-P    Pause module                 CTRL-P       Panning setup screen│░░░
  407. ░░░│ Alt-J    Shell to Dos                 PgUp/Pgdn    Scroll the files    │░░░
  408. ░░░│ Alt-V    Toggle 80x56 mode            CTRL-PgUp/Dn Scroll the screen   │░░░
  409. ░░░│ Alt-D    Delete current file          CTRL-V       Change Master Volume│░░░
  410. ░░░│ Alt-H    ONLINE DOCS                  ^R,^G,^B     Change box color    │░░░
  411. ░░░│ Alt-T    Track screen                 Alt-1,2,3,4  Change active screen│░░░
  412. ░░░│ Alt-S    Instrument saving            Tab          Switch between Instr│░░░
  413. ░░░│ Alt-R    Toggle Random order                       /File Mode          │░░░
  414. ░░░│ Alt-E    Toggle Easy filemode         Ctrl-Left/   Increase/Decrease   │░░░
  415. ░░░│ Alt-G    Graphical mode               Ctrl-Right   channel amount      │░░░
  416. ░░░│ Alt-C    Copy files                   ESC          Exit                │░░░
  417. ░░░│ Alt-F    Digital Effects              Q...P        Play instruments    │░░░
  418. ░░░│ Ctrl-D   Toggle drum machine mode     Arrows       Move in instrument  │░░░
  419. ░░░│ Insert   Tag ALL files                             or file list        │░░░
  420. ░░░│ Delete   UnTag ALL files              Home/End     Go to beginning /end│░░░
  421. ░░░│ Space    In File mode TAG module                   of file/instr. list │░░░
  422. ░░░│ N        Go to next tagged                                             │░░░
  423. ░░░│          module and play it                                            │░░░
  424. ░░░└────────────────────────────────────────────────────────────────────────┘░░░
  425.                                                                                   @A0
  426.                         Command line parameters
  427.  
  428. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  @F9
  429. ░░░┌───Available─command─line/environment─set─options─for─Morgul────────────┐░░░
  430. ░░░│                                                                        │░░░
  431. ░░░│   -r    Select startup screen 1,2,3  -c    Select sound device         │░░░
  432. ░░░│   -o    Select Random mode           -d    Select sound card DMA chan  │░░░
  433. ░░░│   -n    Set default panning          -i    Select scard interrupt      │░░░
  434. ░░░│   -v    Set 80x56 mode               -p    Select scard port           │░░░
  435. ░░░│   -a    Select Amplify rate          -t    Select DMA buffer size      │░░░
  436. ░░░│   -j    Select bar color (0,1,2)     -g    Disable Gus DMA usage       │░░░
  437. ░░░│   -l    Enable keyboard lights       -b    Disable use of EMS memory   │░░░
  438. ░░░│   -fxx  Select digital effect xx     -s    Select sample rate          │░░░
  439. ░░░│   Available sound device numbers:                                      │░░░
  440. ░░░│   1=SB,2=SB Pro,3=PAS+,4=PAS16,5=SB16,6=DAC,7=Aria,8=Windows Sound     │░░░
  441. ░░░│   System/AudioTrix/BusinessAudio,9=Gravis Ultrasound,10=Speaker,       │░░░
  442. ░░░│   11/12=Stereo DAC                                                     │░░░
  443. ░░░│   These options can be used from the command line and also by          │░░░
  444. ░░░│   adding the line Set Morgul=options in your Autoexec.bat file.        │░░░
  445. ░░░│                                                                        │░░░
  446. ░░░└────────────────────────────────────────────────────────────────────────┘░░░
  447.                                                                                   @A0
  448.                         The file screen explained
  449.  
  450. ░ The Morgul 1.10 by Toni Nikkanen 1994.  DSMI (C)  Otto Chrons 1992-1994.    ░░  @F9
  451. ░ Press CTRL-Pgup for the module screen,CTRL-Pgdn for help or Alt-M for menu  ░░
  452. ░░░┌────────────────────────────────────────────────────────────────────────┐░░░
  453. ░░▓│ Filesize: 25kb   Patterns: 21   Samples: 5    Files tagged: 1          │░░░
  454. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  455. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  456. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  457. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  458. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  459. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  460. ░░▓│.            │A directory                       │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  461. ░░▓│..           │A directory                       │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  462. ░░▓│MODULE.MOD   │And here's it's description       │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  463. ░░▓│2ND_SKAV.S3M │Here's another module file        │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  464. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  465. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  466. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  467. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  468. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  469. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  470. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  471. ░░▓└Directory: E:\MODULE────────────────────────────────────────────────────┘░░░
  472. ░░▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░
  473. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  474. ░░                                                                           ░░░
  475. ░░                                                                           ░░░
  476. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  477.                                                                                   @A0
  478.     The file size means the size of the current file in kilobytes,
  479.     patterns means the amount of patterns (the length) of the file,
  480.     samples means how many samples (instruments) there are in it, and
  481.     Files tagged means how many files you have tagged.
  482.  
  483.     The first column is where the file names will be. In this example
  484.     file there are MODULE.MOD and 2ND_SKAV.S3M. In the next column is the
  485.     module's song name. The next one (with ■■ characters) is graphical
  486.     display of the file's size. At the lowermost part of the screen is a
  487.     volume bar just for fun. The current directory is shown just below
  488.     the file names.
  489.  
  490.     If a module with a description like "Inside MODULE.ARJ" or "Inside
  491.     MODULE.ZIP" or so on appears, it means it is inside an archive. You
  492.     can play these just like normal modules, the unarchiver will be
  493.     called automatically. Note that Morgul is capable of using the
  494.     unarchivers if they are as BAT/BTM files or even aliases.
  495.  
  496.                 Tested software and hardware configurations:                      @Z3Tested s/hware
  497.                                                                                   @A0
  498.  
  499.     MS-Dos 2.11 (YES!), MS-Dos 5.00, Ms-Dos 6.00, Ms-Dos 6.20, Dr Dos
  500.     6.0, PC-Dos 5.0, Novell Dos 7.
  501.  
  502.     It seems that Morgul won't work with OS/2 releases up to 2.11,
  503.     because DSMI uses DMA features which are not supported under OS/2.
  504.     If a cure is found, I will of course inform you of it. I will be
  505.     looking into OS/2 Performance Beta II and see if I can make it work.
  506.  
  507.     Quarterdeck DESQview 2.60 & 2.61 work on some computers. On some
  508.     computers, scrolling does not show and only the first 25 lines of
  509.     the first screen become visible. Timeslice releasing is supported
  510.     but untested.
  511.  
  512.     It is possible to make Morgul work under Windows. Under some
  513.     configurations it will work, and under others it won't. Try and see
  514.     what happens, and send me info about what happened. Warning: Windows
  515.     might very well crash. Windows time slice releasing is also
  516.     supported, but untested.
  517.  
  518.     Quarterdeck QEMM, Microsoft EMM386, Qualitas 386^Max (works perfect,
  519.     but on slow computers the Covox/Speaker support might hang the
  520.     computer because these protected mode programs slow interrupts. They
  521.     also decrease sound quality with Covox/Speaker devices.)
  522.  
  523.     Novell EMM386: In DOS Shell the music might slow down strangely. If
  524.     you disable EMM386 or change to another memory manager, the problem
  525.     disappears.
  526.  
  527.     UMB_DRVR 5.22: works perfectly, except for UMB_EMS4.SYS
  528.     DON'T use Qemm's Vidram, it prevents Morgul from using 80x28 text
  529.     mode, or if it doesn't, causes crashes.
  530.  
  531.     Helix Software NetRoom 3.02 (Works, and the Stretch utility, similar
  532.     to Vidram, works perfectly, unlike Vidram.)
  533.  
  534.     Linux Dosemu 0.52pl0: Works, if you have vga console graphics set
  535.     on, but cannot play anything. I believe it is currently impossible
  536.     to use sound boards in dosemu.
  537.  
  538.     Somebody could try this under Windows NT, NeXTStep/486, Solaris,
  539.     InterActive Unix, SCO Unix and the rest, and tell me about the
  540.     results. Also it would be fun to know whether or not it runs on
  541.     PowerMacintosh dos emulation, and AlphaPC-WindowsNT Dos emulation.
  542.  
  543.  
  544.  
  545.  
  546. contact information:                                                              @Z6Contact
  547. Product:         The Morgul Player 1.10                                           @B0
  548. Author:          Toni Nikkanen / Morgul Software
  549. Address:         Kymenlaaksonkatu 9 D 47
  550.                  SF-48100 Kotka
  551.                  Finland, Europe
  552. Voice:           +358 52 15817
  553. e-mail:          tnikkane@clinet.fi         (send uuencoded files here)
  554.                  toni@valhall.nullnet.fi
  555.                  tnikkan@garbo.uwasa.fi
  556.                  luovaa@freeneet.hut.fi
  557. Fidonet netmail: 2:221/18
  558. BBS:             Valhalla Linux, +358 52 181299, leave message to
  559.                  account toni.
  560.                  Hangar BBBS, +358 51 3758236, leave message to Toni
  561.                  Nikkanen in the Posti conference.
  562.  
  563.                      Credits and interesting info:                                @Z7Credits
  564.                                                                                   @A0
  565.     The module playing routines are part of the Digital Sound and Music
  566.     Interface library by Otto Chrons 1992-1994. Everything else is
  567.     written by me with Borland C++ 3.1, using C language and a few pieces
  568.     of assembler. The editor used was Multi-Edit V7.00PN from American
  569.     Cybernetics. This editor is, by the way, highly recommended and beats
  570.     even the Semware Editor. The graphics were made by me using Deluxe
  571.     Paint II Enhanced in a few minutes.
  572.  
  573.     Thanks go out for the following:
  574.                                                                                   @F0
  575.     Otto Chrons             for making DSMI (and bug reports :)
  576.     Pietu Pohjalainen,
  577.     Rauli Priha,
  578.     Teemu Koponen           for making me buy DSMI
  579.     Juha Niemi              for lots of suggestions and bug reports
  580.     Robert K Jung           for very good ARJ documentation and support
  581.     Nico de Vries/AIP-NL    for very good UC2 support and documentation
  582.     Harri Hirvola           for perfect HA documentation
  583.     Kari Tuomainen          for helping with some messy Pascal sources and
  584.                             several other things
  585.     Brad Meier              for competing with my DMPS with his DMPC
  586.                             (keep on going; don't stop now! Where's your
  587.                             registration card, huh?)
  588.     Kevin Burfitt           for being the nice author of Cthugha
  589.     Michael Schwendt        for Sidplay
  590.     Leo Medellin            for not being a member of the Medellin
  591.                             Drug Syndicate :)
  592.     Lars Naber              for being so supportive
  593.     Petri Harkko,
  594.     Tomi Pahula,
  595.     Olli Männistö,
  596.     Jari Turkia             for finding lots of bugs
  597.     Maral / KLF             for pointing out a bug with slw2_klf.mtm
  598.     Skaven/FC, PM/FC,
  599.     C.C.Catch/Ren,Heatbeat,
  600.     Moby,HMW, Zodiak        for making lots of wonderful modules to test
  601.                             Morgul Player with.
  602.     ID Software             For DOOM
  603.     J.M.Jarre               for making lots of wonderful music which I could
  604.                             listen to while coding Morgul
  605.     J.R.R. Tolkien          for inventing the name of Morgul Player
  606.  
  607.  
  608.                                 History
  609.                                 -------                                           @A0
  610.     "And it came to pass, that I, an unknown programmer in the land of
  611.     Finland, got tired of the lack of a reasonable interface in the
  612.     otherwise very good olde DMP player; so I codeth the DMP Shell
  613.     programme. And it came to pass, that I attendeth the Assembly'93,
  614.     and lo and behold! There was a special discount for DSMI; and my
  615.     friends pressureth me to buy it, which I did. I started the Task of
  616.     coding the integration of DMP and DMPS; but the project turned out
  617.     to be much more than a mere integration of the two. And, after a
  618.     year of sometimes hard a sometimes lazy work, I decideth to release
  619.     it, under the name Morgul Player."
  620.     It has come to my attention that because of the DMP Shell, some
  621.     people still think I'm the author of DMP too. That is not the case;
  622.     instead, DMP is (C) 1992-1994 Otto Chrons.
  623.  
  624.  
  625.                             Distribution policy                                   @Z8Policy
  626.                             -------------------                                   @A0
  627.  
  628.     Morgul is freeware, with a few restrictions. The distributable
  629.     version is in no way crippled and it is fully functional. If you use
  630.     this program for more than 7 days, there are two kinds of
  631.     registration:
  632.  
  633.     The lighter one, which involves sending me a postcard (YES, a
  634.     snail-mail POSTCARD, and e-mail is nice but it's not a postcard, so
  635.     it doesn't count) from your homeland telling who you are, where you
  636.     are, what you are,where you got Morgul from and what you think of
  637.     this program. If possible, the postcard should have a picture of your
  638.     home town.
  639.  
  640.     The better one is sending me $5 or 20 FIM (equivalent amounts in
  641.     other currencies are accepted), this will get you the next MAJOR
  642.     update via post on a 3.5" HD diskette (I can also send on a 5.25" HD
  643.     diskette, but I can't quarantee it will be okay when it arrives), and
  644.     it will say it's registered to your name. I will also fill the disk
  645.     with good module files so if it's hard for you to get updates or
  646.     modules (you don't have a modem/inet access), this is the way to go.
  647.     And when I mean MAJOR update, I mean that. So you don't get the NEXT
  648.     new version if it's not a major enough update. Please specify what
  649.     version you were using at that time. You can also say "I want a
  650.     1.72MB FDFormatted floppy" and you'll get that.
  651.  
  652.     Now I am also accepting CDs as registrations, following the example
  653.     of Kevin Burfitt. But do not send anything that says "Ed Starink" or
  654.     "Star Inc.", and no SB AWE32 demo CD's, please. If you send a CD, you
  655.     only have to send $3 or 12mk if you want to have the disk mailed to
  656.     you as well. Although CD's are usually rather expensive, I still have
  657.     to require money for sending the disks, as I don't want to lose
  658.     money. (Actually, I don't have money to lose :)
  659.  
  660.     CD senders get their own VIP section in the regged.txt file in
  661.     the same place with the money senders.
  662.  
  663.  
  664.     You really don't have to send ANY money; a postcard or a CD is
  665.     enough, but since I've had some trouble writing this program I'd
  666.     really appreciate some encouragement, but YOU DON'T EVER HAVE TO PAY,
  667.     if you don't want to. So Morgul is actually NOT shareware as we know
  668.     it. (So there, I avoid DSMI license restrictions quite sneakily!)
  669.  
  670.