1QVIDCAP(1) 1.25.0"" QVIDCAP(1)
2
6 qvidcap - A v4l2 video capture viewer
7
9 qvidcap [<options>]
10
12 The qvidcap tool is used to test video4linux capture devices, either
13 using a video device, a file, or over network. This application can
14 also serve as a generic video/TV viewer application.
15 It does not (yet) support compressed video streams other than MJPEG
17
19 -d, --device=<dev>
20 Use device <dev> as the video device if <dev> is a number, then
21 /dev/video<dev> is used
22 -f, --file=<file>
24 Read from the file <file> for the raw frame data
25 -p, --port[=<port>]
27 Listen for a network connection on the given port. The default
28 port is 8362
29 -T, --tpg
31 Use the test pattern generator. If neither -d, -f nor -T is
32 specified then use /dev/video0.
33 -c, --count=<cnt>
35 Stop after <cnt> captured frames
36 -b, --buffers=<bufs>
38 Request <bufs> buffers (default 4) when streaming from a video
39 device.
40 -s, --single-step[=<frm>]
42 Starting with frame <frm> (default 1), pause after displaying
43 each frame until Space is pressed.
44 -C, --colorspace=<c>
46 Override colorspace. <c> can be one of the following col‐
47 orspaces: smpte170m, smpte240m, rec709, 470m, 470bg, jpeg, srgb,
48 oprgb, bt2020, dcip3
49 -X, --xfer-func=<x>
51 Override transfer function. <x> can be one of the following
52 transfer functions: default, 709, srgb, oprgb, smpte240m,
53 smpte2084, dcip3, none
54 -Y, --ycbcr-enc=<y>
56 Override Y'CbCr encoding. <y> can be one of the following Y'CbCr
57 encodings: default, 601, 709, xv601, xv709, bt2020, bt2020c,
58 smpte240m
59 -Q, --quant=<q>
61 Override quantization. <q> can be one of the following quantiza‐
62 tion methods: default, full-range, lim-range
63 -P, --pixelformat=<p>
65 For video devices: set the format to this pixel format. For
66 reading from a file: interpret the data using this pixel format
67 setting. Ignored for other modes. Use -l to see the list of
68 supported pixel formats.
69 -l, --list-formats
71 Display all supported formats
72 -h, --help
74 Display this help message
75 -t, --timings
77 Report frame render timings
78 -v, --verbose
80 Be more verbose
81 -R, --raw
83 Open device in raw mode
84 --opengl
86 Force openGL to display the video
87 --opengles
89 Force openGL ES to display the video
90 The following options are ignored when capturing from a video device:
92 -W,--width=<width>
94 Set width
95 -H,--height=<height>
97 Set frame (not field!) height
98 -A,--padding=<bytes>
100 set additional horizontal padding (after width)
101 --fps=<fps>
103 Set frames-per-second (default is 30)
104 The following option is only valid when reading from a file:
106 -F, --field=<f>
108 Override field setting. <f> can be one of the following field
109 layouts: any, none, top, bottom, interlaced, seq_tb, seq_bt, al‐
110 ternate, interlaced_tb, interlaced_bt
111 The following options are specific to the test pattern generator:
113 --list-patterns
115 List available patterns for use with --pattern
116 --pattern=<pat>
118 Choose output test pattern, the default is 0
119 --square
121 Show a square in the middle of the output test pattern
122 --border
124 Show a border around the pillar/letterboxed video
125 --sav Insert an SAV code in every line
127 --eav Insert an EAV code in every line
129 --pixel-aspect=<aspect>
131 Select a pixel aspect ratio, the default is to autodetect. <as‐
132 pect> can be one of: square, ntsc, pal
133 --video-aspect=<aspect>
135 Select a video aspect ratio, the default is to use the frame ra‐
136 tio. <aspect> can be one of: 4 x3, 14x9, 16x9, anamorphic
137 --alpha=<alpha-value>
139 Value to use for the alpha component, range 0-255, the default
140 is 0
141 --alpha-red-only
143 Only use the --alpha value for the red colors, for all others
144 use 0
145 --rgb-lim-range
147 Encode RGB values as limited [16-235] instead of full range
148 --hor-speed=<speed>
150 Choose speed for horizontal movement, the default is 0 and the
151 range is [-3...3]
152 --vert-speed=<speed>
154 Choose speed for vertical movement, the default is 0 and the
155 range is [-3...3]
156 --perc-fill=<percentage>
158 Percentage of the frame to actually fill. the default is 100%
159 These options use the test pattern generator to test the OpenGL back‐
161 end:
162 --test=<count>
164 Test all formats, each test generates <count> frames.
165 --test-mask=<mask>
167 Mask which tests are performed. <mask> is a bit mask with these
168 values:
169 0x01: Mask iterating over pixel formats
170 0x02: Mask iterating over fields
171 0x04: Mask iterating over colorspaces
172 0x08: Mask iterating over transfer functions
173 0x10: Mask iterating over Y'CbCr encodings
174 0x20: Mask iterating over quantization ranges
175
177 Q Quit application.
178 P Cycle forwards through all the supported pixel formats. With
180 Shift pressed: cycle backwards. With Ctrl pressed: restore the
181 original pixel format. Only available with --file.
182 I Cycle forwards through all the supported interlaced field set‐
184 tings. With Shift pressed: cycle backwards. With Ctrl pressed:
185 restore the original interlaced field setting. Only available
186 with --file.
187 C Cycle forwards through all the supported colorspaces. With
189 Shift pressed: cycle backwards. With Ctrl pressed: restore the
190 original colorspace.
191 X Cycle forwards through all the supported transfer functions.
193 With Shift pressed: cycle backwards. With Ctrl pressed: restore
194 the original transfer function.
195 Y Cycle forwards through all the supported Y'CbCr encodings. With
197 Shift pressed: cycle backwards. With Ctrl pressed: restore the
198 original Y'CbCr encoding.
199 H Cycle forwards through all the supported HSV encodings. With
201 Shift pressed: cycle backwards. With Ctrl pressed: restore the
202 original HSV encoding.
203 R Cycle forwards through all the supported quantization ranges.
205 With Shift pressed: cycle backwards. With Ctrl pressed: restore
206 the original quantization range.
207 Right-Click
209 Open menu.
210 Double left-click
212 Toggle fullscreen on and off.
213 F Toggle fullscreen on and off.
215 ESC Exit fullscreen.
217 Space When in test mode (--test) pressing Space will skip to the next
219 test. When single-stepping, continue to the next frame.
220 Up Reduce the resolution by two pixels in height. Only available
222 when "Override resolution" is enabled.
223 Down Increase the resolution by two pixels in height. Only available
225 when "Override resolution" is enabled.
226 Left Reduce the resolution by two pixels in width. Only available
228 when "Override resolution" is enabled.
229 Right Increase the resolution by two pixels in width. Only available
231 when "Override resolution" is enabled.
232
234 On success, it returns 0. Otherwise, it will return the number of er‐
235 rors.
236
238 Report bugs to Hans Verkuil <hverkuil@xs4all.nl>
239v4l-utils June 2016 QVIDCAP(1)