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)