Debconf5 DVD builder
====================

Copyright 2005 Ben Hutchings <ben@decadentplace.org.uk>
See "copyright" file for licence terms.

Building of the DVD images is mostly automated using a Makefile, so it
may just be a case of running 'make'.  However, there are numerous
requirements and parameters you should check first.

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

You will need the following programs installed (available in Debian
3.1 "sarge" except where noted):

- dvdauthor
- make
- mencoder (available from Marillat)
- mjpegtools (availale from Marillat)
- mpegdemux
- mkisofs
- netpbm (for NTSC only)
- python
- python-gd
- ttf-bitstream-vera

You will also need the video files from dc5video.debian.net (as listed
in the Makefile) under a sub-directory (or symbolic-linked directory)
called dc5video.debian.net.  If you do not already have these files,
there is the option to download them automatically.

You MUST use a UTF-8 locale.  Under Debian, use 'dpkg-reconfigure
locales' to create one if you do not have one.  Set the LANG
environment variable to select it.

You will need a lot of disk space:
- recoded video files: 12 GB for each of PAL and NTSC (these will
  be created in the subdirectory 'build-pal' or 'build-ntsc' as
  appropriate)
- temporary DVD tree: 5 GB for single-layer, 8 GB for dual-layer
  (this will be created in the subdirectory 'tmp' by default)
- DVD images: 12 GB for each set (these will be created in the
  subdirectory 'build-pal' or 'build-ntsc' as appropriate)

Parameters
----------

Add 'DOWNLOAD=1' to the command line if you want to download missing
video files automatically.  This is disabled by default to avoid
wasting bandwidth due to files simply being in the wrong place.

By default, the Makefile will generate a set of 3 single-layer (DVD-5)
disc images suitable for use in PAL DVD players.  Add 'NTSC=1' to the
command line if you want to generate images suitable for use in NTSC
DVD players instead.  (These differ in frame rate, frame size and
audio codec.)  Add 'DUAL_LAYER=1' if you want to generate a set of 1
dual-layer (DVD-9) disc image plus 1 single-layer (DVD-5) disc image,
or add 'all' if you want both sets of disc images.

Add 'MINI=1' to the command line if you want to perform a test build
with just a minute of each video.  This will change the output
directory to 'build-pal-mini' or 'build-ntsc-mini' to avoid
interfering with full builds.  This is useful for quickly
experimenting with changes to encoding settings or navigation.

By default, encoding will be done in two passes to allow optimisation
of picture quality by allocating more bits to more complex scenes.
Add 'ONE_PASS=1' to the command line to use a faster one-pass process.

Add 'TEMP_DIR=<dir>' to the command line to select the directory <dir>
for building the DVD filesystem before generating each image.  This
directory should be empty or non-existent; it will be created and
deleted as needed.  I repeat, IT WILL BE DELETED.
