NEZplug Version 0.9.3(alpha 6) by Mamiya
    npnez.dll Plugin for Netscape/IE
    in_nez.dll Input plugin for Winamp

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

    NEZplug is a plugin that plays KSS and NSF files.

    NEZplug emulates the following cpus:

        Nintendo  NES-CPU(RP2A03E/G/H)         [Famicom(NES)]
        Zilog     Z80A                         [MSX], [SEGA-MKIII(SMS)], ...
        *(Hudson    HES-CPU(HuC6280)             [PC-Engine(TG16)])
        *(Atari     Mikey(AY931)                 [Lynx])
        *(Nintendo  DMG-CPU                      [Game Boy])

        * ... not implemented.

    NEZplug emulates the following sound chips:

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

        Yamaha    PSG(AY-3-8910)               [MSX]
        Panasonic FM-PAC(YM2413)               Aleste, Xak, ...
        Konami    SCC                          Nemesis2, Space Manbow, ...
        Konami    SCC+(052539 SCC-I2312P001)   Snatcher, ...

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

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

        *(Nintendo  DMG-CPU                      [Game Boy])

        *(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 later version.

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

    Rename 'npnez.dll' file included in the archive to 'in_nez.dll', and copy 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">

Extend Playlist
---------------

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

    filename::NSF,songno,title,time(h:m:s),loop(h:m:s/h:m:s-/-),fade(h:m:s)
    filename::KSS,songno,title,time(h:m:s),loop(h:m:s/h:m:s-/-),fade(h:m:s)

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

    songno    song no

    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.

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

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

    Sorry, current version has text-base setting only.

    plugin.ini:
    [NEZamp]
    DisableNSFExtension=0(default:NEZ & NSF),1(NEZ only for another plugin)
    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(easy-lowpass),2(weighted)
    HookWinamp=0(old song selector),1(default)

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.3
    (C) 1995-1998 Jean-loup Gailly and Mark Adler
    zlib 1.1.3 or later version is required to build from source files.

    RAZE v1.03
    Copyright (c) 1999-2000 Richard Mitton                 
    RAZE v1.03 is required to build from source files.

    fmopl.c -- software implementation of FM sound generator
    (C) 1999 Tatsuyuki Satoh , MultiArcadeMachineEmurator development
    Source files in src/nes/device/fmopl directory are under M.A.M.E. license.

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

Reference
---------

    nessoind.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
    nestech.txt     NES Documentation rev1.0        by Y0SHi
    6502.TXT        6502 Microprocessor             by <?>
    6502BUGS.TXT    by <?> (posted by Ivo van Poorten)
    vrc7tone.bin    by Fukui.cat & Kayama
    MDXDRV          by 41568k
    M88             by cisc
    in_kss          by cync
    KexMP3          by KLAUS
    Bleep!          by Neill Corlett
    Famtasia        by Nori/taka2
    MSP             by Sevy & Marp
    Nosefart        by Shady Matt Conte
    MCDRV for Win32 by toyoshima
    unes_apu.c      by Yoyo.

Contacts
--------

    My E-Mail address: mamiya@proc.org.tohoku.ac.jp

    NEZplug site: http://www.proc.org.tohoku.ac.jp/befis/

    zlib site: http://www.info-zip.org/zlib/

    RAZE site: http://etc.home.dhs.org/

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

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

Changes
-------

Version 0.9.3 ???.??, 2000
    Added KSS format support.
    Added Z80 cpu emulation.
    Added SCC sound emulation.
    Added SCC+ sound emulation.
    Added FM-PAC sound emulation.
    Added SN76496 sound emulation.
    Added FM-UNIT sound emulation.
    Added GG-STEREO sound emulation.

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.
