1PLAYDV(1) General Commands Manual PLAYDV(1)
2
6 playdv - display digital video streams on screen
7
9 playdv [ options ] file
10
12 playdv reads in DV-encoded video data from file and displays it on
13 screen.
14 -v, --version
16 show playdv version number.
17 --disable-audio
19 skip audio decoding.
20 --disable-video
22 skip video decoding.
23 -n, --num-frames=count
25 stop playing after count frames.
26 --dump-frames=pattern
28 save a PPM image of each frame to an individual file. pattern
29 determines the file names and may be given in printf-style tak‐
30 ing one numeric argument that gets replaced with the current
31 frame number. Like capture%05d.ppm for files capture00001.ppm,
32 capture00002.ppm, etc. Use - to stream the frames to stdout.
33 --no-mmap
35 don't use mmap for reading (useful for pipes).
36 -l, --loop-count=count
38 loop playback count= times, 0 for infinite.
39 Audio Output Options
41 --audio-device=devicename
43 target audio device; e.g. /dev/dsp, which is also the default.
44 --audio-file=file
46 send raw decoded audio stream to file, skipping audio ioctls.
47 --audio-mix=(-16 .. 16)
49 mixing level of 4 channel audio for 32KHz 12bit. 0 [default].
50 -16 selects second channel, 16 selects first channel.
51 Video Output Options
53 -d, --display=(0|1|2|3)
55 method used to display video data on screen: 0=autoselect
56 [default], 1=gtk, 2=Xv, 3=SDL. Xv is usually the fastest but
57 requires XFree86 version 4.0 or higher with XVideo extensions.
58 --aspect=(n|w|normal|wide)
60 video display aspect ratio (for Xv only): n=normal 4:3, w=wide
61 16:9 . Not all window manager support resizing at fixed aspect
62 ratio. If they do, resizing is done at fixed aspect ratio.
63 --size=(10 .. 100)
65 initial scaleing percentage (for Xv only): 10 <= n <= 100.
66 Decoder Options
68 -V, --video-system=(0|1|2|3)
70 sets the video standard of the incoming DV data: 0=autoselect
71 [default], 1=525/60 4:1:1 (NTSC), 2=625/50 4:2:0 (PAL,IEC 61834
72 DV), 3=625/50 4:1:1 (PAL,SMPTE 314M DV). Autoselect usually
73 works fine. Only use this option if you know what you are doing.
74 Video Decode Options
76 -q, --quality=(1|2|3)
78 quality level of desired video decoding. The process of decod‐
79 ing DV data is split into several steps. Each additional step
80 enhances output quality, but of course also slows down decoding.
81 If your machine is too slow to keep up an interactive frame
82 rate, you might want to decrease this number: 1=DC and no ACs,
83 2=DC and single-pass for ACs, 3=DC and multi-pass for ACs
84 [default].
85 -m, --monochrome
87 skip decoding of color blocks. Another way to speed up the
88 decoding process.
89 Audio Decode Options
91 -f, --frequency=(0|1|2|3)
93 frequency of audio data in the input stream: 0=autodetect
94 [default], 1=32 kHz, 2=44.1 kHz, 3=48 kHz.
95 -Q, --quantization=(0|1|2)
97 dynamic range of audio data in the input stream: 0=autodetect
98 [default], 1=12 bit, 2=16bit.
99 -e, --emphasis=(0|1|2)
101 first-order preemphasis of 50/15 us: 0=autodetect [default],
102 1=on, 2=off.
103 Help Options
105 -?, --help
107 Show help message. Use this command to get a brief description
108 of available options.
109 --usage
111 Display brief usage message.
112
114 dvconnect(1),dubdv(1),encodedv(1).
115
117 See http://libdv.sourceforge.net/ for the latest version.
118
120 playdv was written by Charles 'Buck' Krasic <krasic@acm.org> and Erik
121 Walthinsen <omega@cse.ogi.edu>.
122 This manual page is based on playdv's help message and was written by
124 Daniel Kobras <kobras@debian.org> for the Debian GNU/Linux system (but
125 may be used by others).
126 January 2003 PLAYDV(1)