nes_ntsc 0.2.2: NES NTSC Video Filter
-------------------------------------
This library filters a NES image to match what a TV would show, allowing
an authentic image in an emulator. It uses a highly optimized algorithm
to perform the same signal processing as an NTSC decoder in a TV, giving
very similar pixel artifacts and color bleeding. The usual picture
controls can be adjusted: hue, saturation, contrast, brightness, and
sharpness. Additionally, the amount of NTSC chroma and luma artifacts
can be reduced, allowing an image that corresponds to composite video
(artifacts), S-video (color bleeding only), RGB (clean pixels), or
anywhere inbetween.

The output is scaled to the proper horizontal width, leaving it up the
emulator to simply double the height. An optional even/odd field merging
feature is provided to reduce flicker when the host display's refresh
rate isn't 60 Hz. Specialized blitters can be easily written using a
special interface, allowing customization of input and output pixel
formats, optimization for the host platform, and efficient scanline
doubling.

Blitting a 256x240 source image to a 602x240 pixel 16-bit RGB memory
buffer at 60 frames per second uses 8% CPU on a 2.0 GHz Athlon 3500+ and
40% CPU on a 10-year-old 400 MHz G3 PowerMac.

Author  : Shay Green <gblargg@gmail.com>
Website : http://www.slack.net/~ant/
Forum   : http://groups.google.com/group/blargg-sound-libs
License : GNU Lesser General Public License (LGPL)
Language: C or C++


Getting Started
---------------
Build a program from demo.c, nes_ntsc.c, and the SDL multimedia library
(see http://libsdl.org/). Run it with "test.bmp" in the same directory
and it should show the filtered image. See demo.c for more.

See nes_ntsc.txt for documentation and nes_ntsc.h for reference. Post to
the discussion forum for assistance.


Files
-----
readme.txt          Essential information
nes_ntsc.txt        Library documentation
changes.txt         Changes made since previous releases
license.txt         GNU Lesser General Public License

benchmark.c         Measures frame rate and processor usage of library
demo.c              Displays and saves NTSC filtered image
demo_impl.h         Internal routines used by demo
test.bmp            Test image for demo
tests/              Test ROMs to verify burst phase operation

nes_ntsc_config.h   Library configuration (modify as needed)
nes_ntsc.h          Library header and source
nes_ntsc.c
nes_ntsc_impl.h

-- 
Shay Green <gblargg@gmail.com>
