File: Readme_UnComb.txt

// UnComb - Simple fast brain-dead YV12 IVTC filter for Avisynth 2.5
// Copyright (C) 2003 Tom Barry - trbarry@trbarry.com
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation; either version 2 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Also, this program is "Philanthropy-Ware". That is, if you like it and feel
the need to reward or inspire the author then please feel free (but not obligated)
to consider joining or donating to the Electronic Frontier Foundation. This will
help keep cyber space free of barbed wire and bullsh*t.

See their web page at www.eff.org

***************

Okay, on to business.

WARNING - This version only runs on the Avisynth 2.5+ release.

UnComb is a simple IVTC filter for matching up even and odd fields of properly
telecined NTSC or PAL film source video. Think of it as a poor mans little
brother to Telecide(). It is fast but that's because it makes no attempt at
finding frames that must be deinterlaced.

USAGE - To use it just:

1) Place the UnComb.dll in a directory somewhere. If that is the C:\Program
Files\AviSynth 2.5\plugins folder folder (recommended) then you can omit the
LoadPlugin command in your script. You can get UnComb from:

www.trbarry.com/UnComb.zip

2) In your Avisynth file use commands similar to

LoadPlugin("F:\UnComb\UnComb.dll")
Avisource("D:\wherever\myfile.avi")
UnComb()

Of course replace the file and directory names with your own. There are no parameters.


KNOWN ISSUES AND LIMITATIONS

1) Requires Avisynth 2.5 and YV12 input.

2) Sorry, currently requires a P-III, Athlon, or higher. Needs SSEMMX support.

3) It will not handle improperly telecined material or bad video edit. It does
not even check for combed frames. It just makes the best field match from
what is available. It will not blend, interpolate, deinterlace, or
even care. It is for reasonably good source material.

4) It does not and likely will not have fancy options like Telecide(). Use
Telecide() when needed.

5) It does not decimate. Follow UnComb with Decimate(5) when you need to
decimate frames from 30 to 24 fps.

6) It is wicked fast. ;-)

FILE LOCATIONS

For now, both source, this readme, and DLL should be at:

www.trbarry.com/UnComb.zip

A copy of this Readme_UnComb.txt file should be at:

www.trbarry.com/Readme_UnComb.txt

***************

Change Log:

2003/05/01 V 0.1.0.0 Initial test release for Avisynth 2.5 only