This is LibDV, a GPL codec for DV video.  

See http://libdv.sourceforge.net/

LibDV now uses the GNU "Autotools" for building.  

BUILDING from CVS checkout
==========================

Starting with version 0.98, the libdv CVS repository does include the
configure script generated by the autotools.  Hopefully, this will
ease the pain for people who are not inclined to modify their machines
installation just to build libdv.

If you do have such desire, you can still try to run the bootstrap
script*:

  ./bootstrap

You can ignore the following error messages:

  automake: configure.in: installing `config/install-sh'
      error while copying

  automake: configure.in: installing `config/mkinstalldirs'
      error while copying

  automake: configure.in: installing `config/missing'
      error while copying


To build the libdv library and the example player:

  ./configure --enable-maintainer-mode
  make

The maintainer-mode is if you are on a system that has recent
autotools installed, and you wish to make changes to the build
scripts.

The makefile generated by the autotools is very large, so the more
useful targets don't jump out at you.  Here are a few.

Build a "tar.gz" distribution file:

  make dist 

Build a rpm package file.  This requires you run as root, or you
setup your ~/.rpmmacros to allow building rpms without root:

  make rpm 

Clean up objects and binaries:

  make clean 

Clean up including files generated by autotools, which should return
the working directory state to be like it as after a CVS checkout:

  make maintainer-clean 


* The autotools book (http://sources.redhat.com/autobook/) recommends
  "bootstrap" instead of autogen.sh.  


NTSC Setup/Pedestal
===================

This option has been disabled in libdv due to improper usage.
If you are still curious about this topic, see Adam Wilt's DV FAQ:
http://www.adamwilt.com/DV-FAQ-tech.html#Setup


Luma and Chroma Clamping
========================

ITU-R 601 specifies that the legal range for luma is 16-235 and 
for chroma is 16-240 regardless of NTSC, PAL, or setup issues. However,
some users take advantage of the footroom or headroom below or above
these ranges to encode additional information for things such as
luma keying. The luma and chroma clamp options permit the range checking
to be disabled to preserve the superblack and superwhite.

For more information read Charles' Poyton's Color FAQ:
http://www.inforamp.net/~poynton/notes/colour_and_gamma/ColorFAQ.html#RTFToC30

and his white paper "Merging Computing with Studio Video:
Converting Between R'G'B' and 4:2:2":
http://home.inforamp.net/~poynton/papers/Discreet_Logic/index.html

