NAME

       playdv - display digital video streams on screen

SYNOPSIS

       playdv [ options ] file

DESCRIPTION

       playdv reads in DV-encoded video data from file and displays it on screen.

       -v, --version
              show playdv version number.

       --disable-audio
              skip audio decoding.

       --disable-video
              skip video decoding.

       -n, --num-frames=count
              stop playing after count frames.

       --dump-frames=pattern
              save  a  PPM image of each frame to an individual file. pattern determines the file
              names and may be given in  printf-style  taking  one  numeric  argument  that  gets
              replaced   with   the   current   frame  number.  Like  capture%05d.ppm  for  files
              capture00001.ppm, capture00002.ppm, etc.  Use - to stream the frames to stdout.

       --no-mmap
              don't use mmap for reading (useful for pipes).

       -l, --loop-count=count
              loop playback count= times, 0 for infinite.

       Audio Output Options

       --audio-device=devicename
              target audio device; e.g. /dev/dsp, which is also the default.

       --audio-file=file
              send raw decoded audio stream to file, skipping audio ioctls.

       --audio-mix=(-16 .. 16)
              mixing level of 4 channel audio for 32KHz 12bit. 0 [default].  -16  selects  second
              channel, 16 selects first channel.

       Video Output Options

       -d, --display=(0|1|2|3)
              method  used  to display video data on screen: 0=autoselect [default], 1=gtk, 2=Xv,
              3=SDL. Xv is usually the fastest but requires XFree86 version 4.0  or  higher  with
              XVideo extensions.

       --aspect=(n|w|normal|wide)
              video  display  aspect  ratio  (for  Xv only): n=normal 4:3, w=wide 16:9 .  Not all
              window manager support resizing at fixed aspect ratio. If they do, resizing is done
              at fixed aspect ratio.

       --size=(10 .. 100)
              initial scaleing percentage (for Xv only): 10 <= n <= 100.

       Decoder Options

       -V, --video-system=(0|1|2|3)
              sets  the  video standard of the incoming DV data: 0=autoselect [default], 1=525/60
              4:1:1 (NTSC), 2=625/50 4:2:0 (PAL,IEC 61834 DV),  3=625/50  4:1:1  (PAL,SMPTE  314M
              DV).  Autoselect  usually works fine. Only use this option if you know what you are
              doing.

       Video Decode Options

       -q, --quality=(1|2|3)
              quality level of desired video decoding.  The process of decoding DV data is  split
              into  several  steps.   Each additional step enhances output quality, but of course
              also slows down decoding.  If your machine is too slow to keep  up  an  interactive
              frame  rate,  you  might  want  to  decrease this number: 1=DC and no ACs, 2=DC and
              single-pass for ACs, 3=DC and multi-pass for ACs [default].

       -m, --monochrome
              skip decoding of color blocks. Another way to speed up the decoding process.

       Audio Decode Options

       -f, --frequency=(0|1|2|3)
              frequency of audio data in the input  stream:  0=autodetect  [default],  1=32  kHz,
              2=44.1 kHz, 3=48 kHz.

       -Q, --quantization=(0|1|2)
              dynamic  range of audio data in the input stream: 0=autodetect [default], 1=12 bit,
              2=16bit.

       -e, --emphasis=(0|1|2)
              first-order preemphasis of 50/15 us: 0=autodetect [default], 1=on, 2=off.

       Help Options

       -?, --help
              Show help message. Use this  command  to  get  a  brief  description  of  available
              options.

       --usage
              Display brief usage message.

SEE ALSO

       dvconnect(1),dubdv(1),encodedv(1).

AVAILABILITY

       See http://libdv.sourceforge.net/ for the latest version.

AUTHORS

       playdv  was  written  by  Charles  'Buck'  Krasic  <krasic@acm.org>  and  Erik  Walthinsen
       <omega@cse.ogi.edu>.

       This manual page is based on playdv's help  message  and  was  written  by  Daniel  Kobras
       <kobras@debian.org> for the Debian GNU/Linux system (but may be used by others).

                                           January 2003                                 PLAYDV(1)