read_file.dll, build 07/20/2002
(c) 2001-2002 Peter Pawlowski, http://www.blorp.com/~peter/

This dll is a part of winamp setup; it is used by my input plugins to read compressed files.
In Winamp3, all input plugins will use access local files via read_file.dll so you will be
able to play zipped Mp3s for an example. Of course, it also reads regular non-compressed
files. You are not allowed to redistribute this DLL anywhere without my permission.

Currently supported formats are:
- ZIP and GZIP (powered by all-time great ZLIB)
- RAR (powered by UnRAR source code; now includes Rar v3.x)
- ARJ (powered by UnARJ source code)

Plugins that support read_file.dll:
- in_midi (in winamp setup)
- in_wave (my one, not Nullsoft's plugin from Winamp setup)
- in_vorbis (will be in the next winamp setup)
- in_mod (updated version will be in the next Winamp setup)
- in_vqf
- in_spc
- in_tfmx

Most of the plugins listed above can be found on my web site.

Read_file.dll's major purpose is to decompress compressed mods/midis (archives containing
single file) 'on the fly'. The file is being completely decompressed into memory while
opening. Be careful with this stuff - if you compress a 50-meg wav you will need 50 megs
of free RAM in order to play it and it will take several seconds to open it.

New versions have some other features:
- CD letter detection - replace drive letter with # character, eg. "#:\main.mix", read_file.dll
  will automatically scan all drive letters for that file.

- Partial file access - eg. "partial://xxxxxxx-yyyyyyyy:x:\dir\file.ext\file.mid"
  where : xxxxxxxx - start offset in hex (must be 8 characters!), yyyyyyyy - end offset in hex,
  x:\dir\file.ext - path of file, file.mid - 'display name' of file (most input plugins will
  recognize it as file name); extension is important to make sure that proper input plugin
  opens the file.  Example: Install my in_wave, insert Red Alert CD1 english and open
  "partial://188391D4-18C4BEC0:#:\main.mix\Hell March.aud".

- Zip/Rar file extraction - eg. "c:\music\spc\FF5.rar\ff5-1-01.spc". You can compress all your
  SPCs with RAR and create playlists referencing RAR files; this will save huge amounts of disk
  space (about 30 megs for me).

TIP: If you want to compress whole directory of files, append '.rar' (or '.zip') to its name,
     then create big playlist with files in it, save it in parent directory, remove '.rar'
     ('.zip') extension, compress contents with rar/zip (make sure that rar/zip file name is
     the same as altered directory name before) and put rar/zip file in parent directory
     (where your playlist is).


*** Using read_file.dll in your plugins ***
Read_file.dll is based on pre-released Winamp3 specs (Tempura). It should even still work with
Tempura. Complete (almost) specs were inside Winamp3 Pre-SDK which used to be available on NSDN
- http://www.winamp.com/nsdn/ and might be still there.
Exported symbol is int readerSource(HINSTANCE ,reader_source**), this is not mentioned in the
Tempura specs.