/*****************************************************\
*      MOD Plugin - (c) 1997 by Olivier Lapicque      *
*                                                     *
*               - Distribute freely -                 *
*                                                     *
*         contact: c1lapicq@watson.ibm.com            *
*                                                     *
*    (Special thanks to MisterX for the graphics)     *
\*****************************************************/


- 1. Requirements
- 2. Installation
- 3. How do I use the MOD Plugin in my HTML files ?
- 4. Can I use the MOD plugin to play my modules on my
     local hard drive ?
- 5. What's new ?
- 6. Troubleshooting

-------------------------------------------------------
1. Requirements
-------------------------------------------------------

- DX2-66 or higher
- Windows 95 or NT 4.0.
- A soundcard with 32-bit drivers
- Netscape Navigator 3.0, or Microsoft Internet Explorer 3.0

NOTE:
  44.1KHz sound quality is not recommended for computers
  slower than a 486DX4-100.

MOD-Plugin is a freeware and may be freely distributed.
As it is a freeware, I am not responsible for any
problems that could be caused by the usage of this plugin.

To save a song, or configure the sound quality, right-click
on the controls, and a menu will be displayed.

Setup Options:
--------------

- Mixing Rate, Stereo, 16-Bit: quality of the sound

- Pre-Amplification: increases the volume of the song, the formula
  is preamp_vol = vol * (1 + numchannels / 12), this gives a better
  signal/noise ratio. If the sound cracks, you should decrease
  the volume of the song (or change the volume=x statement in the
  EMBED tag). Clipping is now done with version 1.57+, which takes
  a little bit more CPU time.

- Surround: Mix according to the Dolby Pro-Logic specs.
  (It may sounds weird if you don't have a Dolby Pro-Logic
  decoder) This forces all channels to surround. If this option
  is off, surround commands in the song can still put a channel
  in surround mode.

- Reverb: Add reverb effect to the song when playing.

- Disable oversampling: you should not use this option,
  unless you have a slow CPU. You can try to listen to
  the music with and without oversampling to see the
  difference.

- Save packed songs: pack the samples when saving songs,
  using the Sae As command (Can reduce up to 50% the size of the
  song).

---------------------------------------------------------
2. Installation
---------------------------------------------------------

- Execute modsetup.exe and follows the instruction.
  You must select the path where your browser is installed.

- Launch your browser (If it was already launched, you'll
  need to quit and restart it).

- Check for updates at "http://www.castlex.com/modplug".


---------------------------------------------------------
3. How do I use the MOD Plugin in my HTML files ?
---------------------------------------------------------

The syntax to put a song in your page is the following:

<EMBED SRC="whatever.mod" width="145" height="48" ...>

NOTE:
  On a Web server, the command should also include the mime-type:

<EMBED type="audio/x-mod" src="whatever.mod" ...

The mime-type used by the MOD Plugin are the following:
audio/x-mod
audio/mod
audio/s3m
audio/xm
audio/med
audio/mtm
audio/x-zipped-mod (1.71+)

But you can always put any mime type for different file types:
audio/mod works with a s3m file, and vice-versa.
You should use "audio/x-mod" for all modules.
(You can also play NST, WOW and 669 files: just rename them into .MOD)

PLEASE DO NOT USE "audio/x-xm" and "audio/x-s3m"!!! I will remove
them if I need more MIME types. (audio/x-xm is not supported since
version 1.65 - use audio/xm or audio/x-mod instead)


That's it!


NOTE: Don't forget to use the packing option of the plugin:
  you'll need to use the "Save packed songs" options in the
  setup dialog, and save the song. This can make the file
  twice smaller. When the user will download the file from
  your page, it will be unpacked. It can make a big difference
  when downloading a file larger than 200K.


The other options you may want to add are the following:
- volume="x": set the volume of the song to x.
  (Default="100", range="1" to "100")

- loop="true": Loop the song. (Default:"false")

- autostart="true": Start playing the song when loaded.
  (Default="false"). (Also "autoplay" on versions 1.31+)

- autonext="true": Jump to next mod when finished playing.
  (Default="false") This is useful only if you have more
  than one song in your page. (You should use loop="true"
  instead to make the same song loop)

- controls="smallconsole"/"none"/"stereo":
  * "smallconsole" shows a small control for the song,
   without displaying the title, and without volume control.
   In this case, the height parameter should be set to "15".
  * "none": don't display anything - use with care
   because there is no way the user will be able to stop the
   mod (besides exiting the page). (same as "hidden="true")
  * "stereo"(1.65+): the horizontal spectrum analyzer will
   be split for right/left, on each side of the plugin.
   In this case the number of bands will be (width - 184) / 16.

- hidden="true": same as controls="none".

- title="song_title": Displays the text "song_title" when
  the song is not yet loaded. (Default: displays "Loading...")

- shuffle="true" (1.57+): goes along with autonext="true".
  when a song finishes playing, the next song will be randomly
  chosen. The shuffle option is a global flag and should appear
  on the first EMBED section in the page. This flags sets
  the autonext="true" flag automatically.

- bgcolor="black"(default),"gray" (1.60+): Select a background color
  for the plugin.

- spcolor="red"(default),"green","blue" (1.61+): Select the color of
  the spectrum analyzer.


NOTE: (v1.43+)
--------------
- If you want to enable the VU-Meter, the width parameter
  should be set to "168". The VU-Meter cannot be used with
  the controls="smallconsole" option.

Spectrum Analyzer (1.60+)
-------------------------
- You can enable the spectrum analyzer by setting a height
  of 96 (bottom spectrum) or a width of 336 (right spectrum).
- v1.61+: You can have from 3 to 80 bands in your right spectrum
  analyzer: set the width parameter to 176+(numbands*8).
  The frequency range is between 86Hz (left) and 11KHz (right).
- v1.65+: With the stereo spectrum, the number of bands on each
  side will be (width - 184) / 16.
 

--------------------------------------------------------
4. Can I use the MOD plugin to play my modules on my
   local hard drive ?
--------------------------------------------------------

Well, of course.
Create a modlist.htm file in your modules directory,
with a line for each module (Try not to put more than
10 mods on the same page, because they will all be 
loaded in memory)

The file should look like that:

<HTML>
<HEAD>
<TITLE>Ultra-trance-tekkno-rave mod page</TITLE>
</HEAD>
<BODY>

<P><A HREF="prevpage.htm">Previous Page</A></P>

<P><EMBED TYPE="audio/x-mod" SRC="mod01.mod" width="145" height="48" autostart="true" autonext="true"></P>
<P><EMBED TYPE="audio/x-mod" SRC="mod02.mod" width="168" height="48" autonext="true"></P>
<P><EMBED TYPE="audio/x-mod" SRC="mod03.s3m" width="145" height="48" autonext="true"></P>

<P><A HREF="nextpage.htm">Next Page</A></P>

</BODY>
</HTML>

* end of file *

After that, you can open this file in Netscape in
File - Open File in Browser.

And voila !



--------------------------------------------------------
5. What's new ?
--------------------------------------------------------

------------- MOD Plugin version 1.7 -------------------
1.73:
- Improved modsetup.exe (no more archive).
- Removed modlinks.htm - you can get it in the "deluxe version".

1.72:
- Improved ZIP support.
- Updated sound library to match ModPlug Player 1.07.

1.71:
- Improved setup.exe
- Changed audio/mdz to "audio/x-zipped-mod".
- Updated sound library to match ModPlug Player 1.03.

------------- MOD Plugin version 1.6 -------------------
1.69:
- Fixed tone-portamento bug in MOD files.
- Fixed vibrato depth bug.
- Misc. small bugs fixed.
- Pitch/Pan separation is no more lost when saving IT files.

1.68:
- Added support for instrument auto-vibrato in XM/IT.
- Fixed bug in Volume/Pan envelope interpolation.

1.67:
- Fixed panning envelope bug.
- Fixed tone-portamento bug.
- Fixed Global Volume (0) bug.
- Added Zipped-Module support (*.mdz): In order to play zipped mods,
  you can zip them with any zip archiver (like PKZIP) and rename them
  into .MDZ. To get the maximum compression level, you should first use
  the Save Packed Songs option, and then zip the packed song.
  example, to make mymod.s3m as small as possible:
     - Check Save Packed Songs
     - Use "Save As" and save the song as mymod1.s3m
     - use PKZIP mymod.mdz mymod1.s3m
- Removed MIME-Type audio/669. You should now rename any 669 modules
  into another supported extension.

1.66:
- Fixed registry problem (associations lost).
- Fixed panning slide bug.
- Added MOD surround support (8A4)
- Improved IT save function.
- Improved MOD loader.

1.65:
- audio/x-xm MIME-type has been removed (I needed room for .669)
- Fixed another HUGE bug (crash) with some mods (in all formats)
- Added Channel Volume Slide and Global Volume Slide effects.
- Added Save As support for IT modules.
- Added beta 669 support.
- Added controls="stereo" option for the spectrum analyzer.

1.64:
- Added most of the Impulse Tracker effects.
- The Save As MOD is now more powerful when converting from S3M/XM.
- Better MED support.
- Fixed a HUGE bug if 'force amiga limits' flags was set in S3M.

1.63:
- Added volume and pan envelopes support in XM modules.
- The packing option now converts 16-bit samples to 8-bits.
- The Set Filter amiga command can disable the oversampling.

1.62:
- Envelope information in XM modules is no more lost.
- Added pre-alpha support for IT modules (sample mode only).
- Fixed possible crash in replay routine.
- Portamento Slides were too fast in MODs.
- Note Delay was broken since 1.60.

1.61:
- Added "spcolor" option.
- Spectrum Analyzer is more accurate.

1.60:
- Added support for conversion to MOD/S3M/XM from any format.
- Added MTM modules support (import).
- Added Global Volume effects.
- Fixed VU-Meter bug when Surround was used.
- Added 20-bands Spectrum Analyzer
- Added Panning Slide effect in XM modules.
- Added Reverb option.
- Reduced total size of sound buffer from 1.6s to 1s.

------------- MOD Plugin version 1.5 -------------------
1.57:
- The replay routine runs now in a separate thread.
- Improved the Pre-Amplification option by clipping the sound.
- Added "shuffle" option.

1.56:
- MAJOR BUG FIX: Save As was corrupting MOD files with version 1.55
- Decreased size of sound buffer but increased number of buffers
- Fixed bug in S3M when sample loop end was bigger than sample length.
- "Loading..." is displayed when loading a module.

1.55:
- Fixed WAV file format bug.
- Fixed font display bug when displaying the song title.
- Updated MODLINKS.HTM

1.54:
- Added FastVolSlide & AmigaLimits flags in S3M modules.
- Fixed Speed 0 bug in MOD/XM.
- Fixed XM instrument panning bug.
- Fixed finetune bug in MODs.
- Fixed vibrato bug
- Too high frequencies are not played anymore (>200KHz).
- Added support for linear frequencies in XM modules.
- Added Save As Wave option (.wav export)

1.53:
- Instruments are now saved unsigned in s3m MODULES.
- Unused channels are now removed in S3M modules..
- Pattern Break bug fixed in XM modules.
- Song slider bug fixed.

1.52:
- Added OctaMed MMD2/MMD3 support.
- Song slider bug fixed.
- Minor bugs fixed.

1.51:
- Added basic support for OctaMed MMD0/MMD1 Modules (*.med)
- Added audio/x-xm and audio/x-s3m MIME-type (They were removed
  in 1.50 - but I saw some sites using them)

1.50:
- Added support for 16-bit samples (S3M,XM)
- Fixed VolSlide(0) in MODs
- Optimized play function

------------- MOD Plugin version 1.4x -------------------

- Now set the correct tempo when changing the position
- Improved XM support (fixed tempo<->speed) bug.
- Added Pro-Logic Surround and Pre-Amplicication options.
- Added XM key off/fadeout support.
- Added E8x effect in MOD/XM.
- Added 32KHz and 48KHz sound quality.
- Added X1/X2 effects in XM files.
- Added default "Loading..." while downloading a file.
- Fixed possible crash with Note Delay effect.
- Fixed Offset 0 effect bug
- Fixed retrig bug
- Fixed FineTune bug
- Fixed arpeggio bug
- Fixed volume slide bug in S3m.
- Fixed setup bug for MSIE when the plugins directory
  didn't exist.
- Recognises "looping" same as "loop" (for compatibility
  with the DSM Mac plugin).
- Fixed bug when "properties" was used before the module
  was loaded. (Properties screen was staying blank)
- Fixed VU-Meter bug in 8-bit format (always in the red)
- Fixed a problem that caused clicks in some loops
- Fixed S3M bug in Fine & Extra Fine Portamento Up/Down
- Fixed Note Delay problem with non-zero volume column byte
- Added MODLINKS.HTM to the package.
- Added VU-Meter.
- Added Glissando Control.
- Remember the last song position.
- Added multisample instrument support in XM files.
- Changed SETUP.EXE to support Internet Explorer.

------------- MOD Plugin version 1.3x ------------------

- Fixed bugs with Note Delay, Tremor and Retrigger.
- Added Save As for XM files (multisample instruments
  are not supported yet)
- Improved S3M Load/Save function
- Support for patterns with more than 64 rows in XM files.
- Minor other adjustments
- Added support for 16-bit samples
- Added effects on XM files.
- Added "hidden" option (same as "controls="none").
- Added Note Delay effect in MODs (EDx).
- Increased size of sound buffer.
- MAJOR bug fix in s3m modules.
- Added basic XM support (no effects and no Save As...).
- Fixed Netscape crash when changing page before load completed
- Added channel pan position effect.
- Added support with up to 32 channels for s3m modules.
- Added autoplay same than autostart.
- Added 4-bit ADPCM support for modules: this can make the module
  twice smaller! But WARNING: your other players/trackers will
  probably not support ADPCM, and will not be able to load the
  samples -> By default, the plugin will unpack the songs when
  saving. If you want to pack them, check the "Save packed songs"
  checkbox in the Setup dialog, and use the Save As command.
  If the "Save packed song" option is not checked, the song will
  be save unpacked, even if it was packed before. It can then be
  loaded by any tracker/player.

  This is very useful for the internet since it will be twice faster
  to download the module. (Think about it if you want to put a module
  on your home page)

  ATTENTION DEVELOPPERS: (If you want to support the packed format)
  When saving the song, the plugin will pack the samples only if
  it doesn't affect the quality. In MOD files, the sample data starts
  by "ADPCM". In S3M the regular compression byte is used with a value
  of 0x04. 4-bit ADPCM is coding the delta values between a sample and
  the next in 4-bits (starting value is zero). The delta values are
  stored as a 16-byte table at the start of the sample data:
  [16-bytes delta values][(length+1)/2 bytes of 4-bit indexes...]
  In XM files, the bit 6 of the sample type is set to 1, and the reserved
  byte is set to 0xAD. In IT files, the sample flags byte is set to 0xFF.


------------- MOD Plugin version 1.2x ------------------

- Added Retrig effect on MOD files (E9x command)
- Added Pattern Delay effect on MOD files (EEx command)
- Added Pattern Loop effect
- Added 'title' option.
- Added S3M support
- Added channels, instruments and patterns in the 
  properties box.
- Fixed some clicks problems in modules with an odd
  number of channels.
- Added README.TXT (this file).


------------- MOD Plugin version 1.1 -------------------

- Fixed problems with some NT sound drivers.
- Fixed "Netscape will launch the application..." 
  message when you had a mod player already installed.
- Added support for mods with more than 16 channels.


------------- MOD Plugin version 1.0 -------------------

First release of the plugin.

- Support up to 16 channels mods.
- Sound interpolation for each track remove metallic
  quality of the sound. (Like what the GUS does in 
  hardware) (256x oversampling)


-------------------------------------------------------
6. Troubleshooting
-------------------------------------------------------


- The setup.exe program failed!

  Be sure to run the program setup.exe in the same directory
  than where the npmod32.dll file is located.
  Try to copy the file NPMOD32.DLL in the plugins
  directory of your browser if it's still not working.


- I don't like the MOD Plugin, it's crap and I hate it.

  Ta mere elle chausse du 2.


- I have a Mac, how can I get MOD Plugin for Mac ?

  A plugin is already available for Mac (PowerPC only).
  Check at: "http://www.spilk.org/dsm". (DSM Plugin)
  This plugin doesn't support compression.

- I'm running OS/2, how can I get MOD Plugin for OS/2 ?

  An OS/2 plugin is available at the following address:
  "http://www.polsci.wvu.edu/Henry/Madbrain/npdsmi.html"
  (DSMI/2 doesn't support compression yet)

- The plugin takes too much CPU

  Well, unlike most players, mod-plugin supports 16-bit
  samples (They are not converted to 8-bit). There is also
  an oversampling performed for each track in the song.
  The internal volume is calculated on 32-bit, which makes
  it hard to use a lookup table for multiply instructions.
  To decrease the CPU usage, you can try not going above
  32KHz, play in mono, disable the reverb effect, and use
  the 'disable oversampling' option.

- For all other questions about the MOD Plugin, e-mail me
  at c1lapicq@watson.ibm.com, and don't forget to tell me
  which version of the plugin you're using.