NEZplug Version 0.9.4.8
    in_nez.dll Input plugin for Winamp
    npnez.dll Plugin for Netscape/IE3.x,4.x,5.x

Introduction
------------

    NEZplug is a plugin that plays NSF and KSS, GBR, GBS, HES, AY files.

    NEZplug emulates the following sound chips:

        Richo     NES-APU(RP2A03H)             [Famicom(NES)]
        Konami    VRC6(053328 VRC VI)          Castle vania 3, Madara, ...
        Konami    VRC7(053982 VRC VII)         Lagrange Point
        Nintendo  MMC5                         Just Breed, Yakuman Tengoku
        Richo     FDS(RP2C33A)                 Zelda(FDS), Dabada(FDS), ...
        Namco     NAMCOT106                    D.D.S.2, KingOfKings, ...
        Sunsoft   FME7                         Gimmick!

        GI        PSG(AY-3-8910)               [MSX] [ZX Spectrum]
        Yamaha    SSG(YM2149)                  [Amstrad CPC]
        Yamaha    FM-PAC(YM2413)               Aleste, Xak, ...
        Yamaha    MSX-AUDIO(Y8950)             Labyrinth, Xevious, ...
        Konami    SCC(051649 SCC-I2212)        Nemesis2, Space Manbow, ...
        Konami    SCC+(052539 SCC-I2312)       SD Snatcher, ...
        Konami    MajutushiDAC                 Majutushi

        TI        SMS-SNG(SN76496)             [SEGA-MKIII(SMS)]
        Yamaha    FM-UNIT(YM2413)              Shinobi, Tri Formation, ...
        Sega      GG-SNG                       [Game Gear]

        Richo     DMG-SYSTEM                   [Game Boy]

        Hudson    HES-PSG(HuC6280)             [PC-Engine(TG16)]

        *(Atari     Mikey(AY931)                 [Lynx])

        * ... not implemented.

Requirements
------------

    High performance wave output device.
    A MMX Pentium 166MHz or faster is recommended for playing in best quality.

    Winamp 2.x or later version.
    Netscape 4.x or later version.
    Internet Explorer 3.x or 4.x or 5.x.

How to install for Winamp
-------------------------

    Just copy 'in_nez.dll' file included in the archive to the PLUGINS directory
    in your Winamp directory after closing Winamp.

How to install for browser
--------------------------

    Just copy 'npnez.dll' file included in the archive to the PLUGINS directory
    in your browser directory after closing browser.

ex.)
<EMBED title="NEZplug" src="test.nsz" type="audio/x-nsf-zip-compressed" pluginspage="http://www.proc.org.tohoku.ac.jp/befis/download/nezplug/" height="32" width="100%" hidden="false">

Extended Playlist
-----------------

    NEZplug extend M3U playlist format(v0.9) for Winamp

    filename::NSF,[1 based songno|$songno],[title],[time(h:m:s)],[loop(h:m:s)][-],[fade(h:m:s)],[loopcount]
    filename::KSS,[0 based songno|$songno],[title],[time(h:m:s)],[loop(h:m:s)][-],[fade(h:m:s)],[loopcount]
    filename::GBR,[0 based songno|$songno],[title],[time(h:m:s)],[loop(h:m:s)][-],[fade(h:m:s)],[loopcount]
    filename::GBS,[0 based songno|$songno],[title],[time(h:m:s)],[loop(h:m:s)][-],[fade(h:m:s)],[loopcount]
    filename::HES,[0 based songno|$songno],[title],[time(h:m:s)],[loop(h:m:s)][-],[fade(h:m:s)],[loopcount]
    filename::AY ,[0 based songno|$songno],[title],[time(h:m:s)],[loop(h:m:s)][-],[fade(h:m:s)],[loopcount]
    filename::NEZ,[0 based songno|$songno],[title],[time(h:m:s)],[loop(h:m:s)][-],[fade(h:m:s)],[loopcount]

    filename  song file relative path(*.zip;*.nsf;*.kss;...)

    songno    0-based songno(::NSF playlist only has 1-based songno for historical reason.)
    $songno   0-based hexadecimal songno

    title     song title

    time      song play time   h * 3600 + m * 60 + s (sec)
                Default time(5min) will be used, if time not specified.

    loop(h:m:s)
              loop length      h * 3600 + m * 60 + s (sec)
    loop(h:m:s-)
              loop start time  h * 3600 + m * 60 + s (sec)
    loop(-)
              loop length is equal to play time.
                Song will not loop, if loop not specified,

    fade      fadeout length   h * 3600 + m * 60 + s (sec)
                Default fadeout length(5sec) will be used, if time not specified.

    loopcount
              loop count
                Default LoopCount will be used, if time not specified.

    You may fail to play extend M3U because of Winamp 2.6x's bug.
    Try M3U2PLS converter.

Setting for Winamp
------------------

    in_nez.ini:
    [NEZplug]
    DisableNSFSupport=0(default:support NES sound files),1(disable for using with another NSF plugin)
    DisableKSSSupport=0(default:support KSS sound files),1(disable for using with another KSS plugin)
    DisableGBRSupport=0(default:support GBR sound files),1(disable for using with another GBR plugin)
    DisableGBSSupport=0(default:support GBS sound files),1(disable for using with another GBS plugin)
    DisableHESSupport=0(default:support HES sound files),1(disable for using with another HES plugin)
    DisableAYSupport=0(default:support AY & CPC),1(disable for using with another AY plugin)
    DisableNSFExtension=0(default:support both NEZ/NSF),1(support NEZ only for using with another NSF plugin)
    DisablePCEExtension=0(support both HES/PCE),1(default:support HES only for using with PCE emulator)
    Frequency=48000,44100(default),24000,22050,11025
    Priority=Highest,Higher,Normal(default),Lower,Lowest
    LoopCount=0(infinite),1(no loop),2(default),3,4,5...255
    FadeoutTime=5000(msec:default)
    DefaultPlayTime=300000(msec:default)
    DisplayRealPlayTime=0(compatible),1(loop & fadeout affected time:default)
    FilterType=0(none:default),1(nosefart-easy-lowpass),2(nosefart-weighted)
    HookWinamp=0(old song selector),1(default)
    NSFApuVolume= -512(x4),-256(x2),0(default),256(x1/2),512(x1/4)
    NSFDpcmVolume=-512(x4),-256(x2),0(default),256(x1/2),512(x1/4)
    NSFFdsType=2(normalFDSengine:default),1(oldFDSengine1),3(oldFDSengine2),0(externalFDSengine)

Credits
-------

    This program is free software.
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY.

    NEZplug by Mamiya

    zlib 1.1.4
    (C) 1995-1998 Jean-loup Gailly and Mark Adler
    zlib 1.1.4 or later version is required to build from source files.

    Netscape plugin SDK
    Copyright (c) 1996 Netscape Communications Corporation. All rights reserved.
    NPSDK is required to build from source files.

Reference
---------

    nessound.txt    The NES sound channel guide 1.8 by Brad Taylor
    disksystem.txt  Disk System Infomation          by goroh
    konami.txt      Konami Mapper infomation        by goroh
    mmc5.txt        mmc5 infomation                 by goroh
    namco.txt       Namcot 106 Mapper infomation    by goroh
    ripper.html     NSFripper road (beta)           by Izumi (& Fukui.cat)
    nsfspec.txt     NES Music Format Spec v1.20     by Kevin Horton
    vrcvi.txt       VRCVI CHIP INFO v1.01           by Kevin Horton
    vrcvii.txt      VRCVII CHIP INFO v1.50          by Kevin Horton
    disksys.htm     Disksystem Information          by NORI
    Nintendo Disksystem Sound Spec                  by Norix
    unspec.htm      YM2413 Undocumented Spec        by [OK]
    pce_psg.txt     PC Engine PSG                   by Paul Clifford
    ppu.txt         NTSC PPU timing                 bt Samus Aran
    z80undoc.txt    Z80 Undocumented Features       by Sean Young
    nestech.txt     NES Documentation rev1.0        by Y0SHi
    6502.TXT        6502 Microprocessor             by <?>
    gbmanual.txt    GB(DMGSystem)Spec               by <?>
    6502BUGS.TXT    by <?> (posted by Ivo van Poorten)
    vrc7ed          by Fukui.cat & Kayama
    fmpac_naruto    by Narto
    FMTONE_OK       by [OK]
    opll_sama       by Sama
    MDXDRV          by 41568k
    M88             by cisc
    in_gbr          by cync
    in_he2          by cync
    in_kss          by cync
    KexMP3          by KLAUS
    in_cnez         by minachun
    Bleep!          by Neill Corlett
    Famtasia        by Nori/taka2
    VirtuaNES       by Norix
    emu2149         by [OK]
    emu2413         by [OK]
    MSP             by Sevy & Marp
    Nosefart        by Shady Matt Conte
    kbnez           by S.Kinoshita & Kobarin
    fmopl.c         by Tatsuyuki Satoh
    MCDRV for Win32 by toyoshima

Contacts
--------

    My E-Mail address: mamiya@users.sf.net

    NEZplug site: http://nezplug.sf.net/

    zlib site: http://www.gzip.org/zlib/

    Netscape site: http://home.netscape.com/

    Winamp site: http://www.winamp.com/

Changes
-------

Version 0.9.4.8 Nov.25, 2002
    Improved APU sound emulation.

Version 0.9.4.7 Nov.24, 2002
    Improved APU sound emulation.
    Adjusted pitch of APU/VRC6/MMC5 sound emulation.
    Adjusted VSYNC timing of NSF.

Version 0.9.4.6 Nov.2, 2002
    Improved APU sound emulation.
    Improved FDS sound emulation.
    Added CGB mode.
    Adjusted VSYNC timing.

Version 0.9.4.5 Jul.16, 2002
    Improved FDS sound emulation.

Version 0.9.4.4 Jul.16, 2002
    Rewritten FDS sound engine.

Version 0.9.4.3 Jun.13, 2002
    Improved SN76496 sound emulation.
    Fixed a bug with HuC6280 register read.

Version 0.9.4.2 Apr.10, 2002
    Fixed a bug with OPL ADPCM master volume.

Version 0.9.4 Feb.4, 2002
    Fixed a bug with Winamp extended playlist.
    Fixed a bug with OPL ADPCM sample decode.
    Fixed bugs with DeliAY(ZXAYEMUL) initializing.
    Fixed MSX M1 cycle timing.
    Added MajutushiDAC sound emulation.
    Added MSX1bitDAC sound emulation.
    Improved Z80 undocumented flag emulation.

Version 0.9.3.7 Jun.5, 2001
    Improved MSX-AUDIO sound emulation.

Version 0.9.3.6+ Jun.4, 2001
Version 0.9.3.6 May.31, 2001
    Fixed a bug with KSS header.
    Improved FM-PAC/MSX-AUDIO/FM-UNIT/VRC7 sound emulation.

Version 0.9.3.5 May.25, 2001
    Improved FM-PAC/MSX-AUDIO/FM-UNIT/VRC7 sound emulation.

Version 0.9.3.4 May.25, 2001
    Fixed a bug with FM-PAC/MSX-AUDIO/FM-UNIT rhythm mode.

Version 0.9.3.3 May.23, 2001
    Improved HES noise emulation.
    Improved FM-PAC/MSX-AUDIO/FM-UNIT/VRC7 sound emulation.

Version 0.9.3.2 May.22, 2001
    Improved PSG/FME7 sound emulation.
    Improved FM-PAC/MSX-AUDIO/FM-UNIT/VRC7 sound emulation.

Version 0.9.3.1 May.18, 2001
    Fixed a bug with ZIP archive.
    Improved FM-PAC/MSX-AUDIO/FM-UNIT/VRC7 sound emulation.


Version 0.9.3 May.16, 2001
    Added HES format support.
    Added HuC6280 cpu/sound emulation.
    Added GBR/GBS format support.
    Added DMG-SYSTEM cpu/sound emulation.
    Added DeliAY(ZXAYEMUL) format support.
    Added KSS format support.
    Added Z80 cpu emulation.
    Added SCC sound emulation.
    Added SCC+ sound emulation.
    Added FM-PAC sound emulation.
    Added MSX-AUDIO sound emulation.
    Added SN76496 sound emulation.
    Added FM-UNIT sound emulation.
    Added GG-STEREO sound emulation.
    Fixed a bug with fadeout.
    Fixed DPCM IRQ timing.
    Rewritten APU sound engine.
    Rewritten FDS sound engine.
    Rewritten VRC7 sound engine.

Version 0.9.2.1 Jul.12, 2000
    Fixed bugs with NSD I/O.
    Fixed DPCM IRQ timing.

Version 0.9.2 Jul.11, 2000
    Added NSD format support.
    Added broser UI.
    Improved VRC6 and VRC7 sound emulation.
    Improved VRC7 tone.
    Optimized APU and VRC7 sound emulation.

Version 0.9.1 Jun.21, 2000
    Added VRC7 tone(vrc7tone.bin) setting.
    Improved VRC7 sound emulation.
    Improved APU sound emulation.

Version 0.8 May.26, 2000
    Improved APU sound emulation.
    Improved VRC7 sound emulation.
    Improved 6502 emulation.

Version 0.7 May.13, 2000
    Added FDS sound emulation.
    Added FME7 sound emulation.
    Improved APU sound emulation.
    Improved N106 sound emulation.

Version 0.6 Mar.10, 2000
    Added song selector.

Version 0.5 Mar.09, 2000
    Added MMC5 multiplier emulation.

Version 0.4 Mar.09, 2000
    Added N106 sound emulation.

Version 0.3 Mar.08, 2000
    Added N106 sound emulation.
    Improved VRC7 sound emulation.

Version 0.2 Mar.07, 2000
    Added MMC5 sound emulation.

Version 0.1 Mar.06, 2000
    First release.
