encodedv (1)
NAME
encodedv - encode a series of images to a digital video stream
SYNOPSIS
encodedv [ options ] video_pattern [ audio_input ]
DESCRIPTION
encodedv takes a series of images in PPM/PGM/video format and option-
ally an audio stream and compiles them into a DV-encoded video stream.
pattern specifies where the input data is located and may be either -
for stdin, or a printf-style pattern taking one numeric argument that
gets replaced by the current frame number. Like image%03d.ppm, which
gets expanded to image000.ppm, image001.ppm, etc.
--version
show encodedv version number.
-s, --start-frame=count
start encoding at frame number count (defaults to 0).
-e, --end-frame=count
end encoding at frame number count (defaults to unlimited).
-l, --wrong-interlace
flip lines to compensate for wrong interlacing in the input
data. Happened with mpeg2dec generated data.
-p, --vlc-passes
vlc code distribution passes (1-3) greater values = better qual-
ity but not necessarily slower encoding! This defaults for best
quality = 3.
-v, --verbose
show encoder statistics / status information
-i, --input=filter-name
Choose input-filter: [>ppm<, pgm, video] The ppm-filter only
supports raw rgb ppm files. The pgm file format is the one gen-
erated by mpeg2dec of the livid project. ( http://linuxvideo.org
) This means: Y-data appended by U and V data which are scaled
down by 2 and placed side by side. This option defaults to PPM.
Some things you want to keep in mind:
1) If you want to stream video frames (using video_pattern =
"-") you have to make sure that there is no trailing garbage at
the end of the pictures. This is ignored by most image manipula-
tion programs!
2) If you are one of the poor persons with a buggy PCI bus-mas-
tering board be sure to have a backup handy if you want to use
video support. Some versions of the VIA board chipsets crash
your machine and even your harddisk. Since encodedv uses full
resolution capturing it is more likely to trigger these bugs
than other programs. If you have a VIA board you definitely want
to upgrade to Linux 2.4.3 or higher.
But keep in mind, that this pgm format is only optimal for PAL
since NTSC averages the U and V values somewhat differently.
-a, --audio-input=filter-name
Choose audio-input-filter: [>none<, wav, dsp]
-o, --output=filter-name
Choose output-filter: [>raw<] Hint for Arne Schirmacher to add
AVI support ;-)
-q, --static-qno=table-no
Static qno tables for quantisation on 2 VLC passes. For turbo
(but somewhat lossy encoding) try -q [1,2] -p [2,3]. There are
only two static qno tables registered right now:
1 : for sharp DV pictures
2 : for somewhat noisy satelite television signal
If you want to add some more, go ahead ;-)
-f, --fps=fps-number
Set frames per second (default: use all frames)
-d, --force-dct=dct-mode
Force dct mode (88 or 248) for whole picture
Help Options
-?, --help
Show help message.
--usage
Display brief usage message.
SEE ALSO
playdv(1).
AVAILABILITY
See http://libdv.sourceforge.net/ for the latest version.
AUTHORS
encodedv was written by James Bowman <jamesb@excamera.com> and Peter
Schlaile <udbz@rz.uni-karlsruhe.de>.
This manual page is based on encodedv's help message and was written by
Daniel Kobras <kobras@debian.org> for the Debian GNU/Linux system (but
may be used by others). It was updated by Peter Schlaile <udbz@rz.uni-
karlsruhe.de>.
April 2001 ENCODE(1)