1QVIDCAP(1) User Commands 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 --fps=<fps>
100 Set frames-per-second (default is 30)
101 The following option is only valid when reading from a file:
103 -F, --field=<f>
105 Override field setting. <f> can be one of the following field
106 layouts: any, none, top, bottom, interlaced, seq_tb, seq_bt,
107 alternate, interlaced_tb, interlaced_bt
108 The following options are specific to the test pattern generator:
110 --list-patterns
112 List available patterns for use with --pattern
113 --pattern=<pat>
115 Choose output test pattern, the default is 0
116 --square
118 Show a square in the middle of the output test pattern
119 --border
121 Show a border around the pillar/letterboxed video
122 --sav Insert an SAV code in every line
124 --eav Insert an EAV code in every line
126 --pixel-aspect=<aspect>
128 Select a pixel aspect ratio, the default is to autodetect.
129 <aspect> can be one of: square, ntsc, pal
130 --video-aspect=<aspect>
132 Select a video aspect ratio, the default is to use the frame
133 ratio. <aspect> can be one of: 4 x3, 14x9, 16x9, anamorphic
134 --alpha=<alpha-value>
136 Value to use for the alpha component, range 0-255, the default
137 is 0
138 --alpha-red-only
140 Only use the --alpha value for the red colors, for all others
141 use 0
142 --rgb-lim-range
144 Encode RGB values as limited [16-235] instead of full range
145 --hor-speed=<speed>
147 Choose speed for horizontal movement, the default is 0 and the
148 range is [-3...3]
149 --vert-speed=<speed>
151 Choose speed for vertical movement, the default is 0 and the
152 range is [-3...3]
153 --perc-fill=<percentage>
155 Percentage of the frame to actually fill. the default is 100%
156 These options use the test pattern generator to test the OpenGL back‐
158 end:
159 --test=<count>
161 Test all formats, each test generates <count> frames.
162 --test-mask=<mask>
164 Mask which tests are performed. <mask> is a bit mask with these
165 values:
166 0x01: Mask iterating over pixel formats
167 0x02: Mask iterating over fields
168 0x04: Mask iterating over colorspaces
169 0x08: Mask iterating over transfer functions
170 0x10: Mask iterating over Y'CbCr encodings
171 0x20: Mask iterating over quantization ranges
172
174 Q Quit application.
175 P Cycle forwards through all the supported pixel formats. With
177 Shift pressed: cycle backwards. With Ctrl pressed: restore the
178 original pixel format. Only available with --file.
179 I Cycle forwards through all the supported interlaced field set‐
181 tings. With Shift pressed: cycle backwards. With Ctrl pressed:
182 restore the original interlaced field setting. Only available
183 with --file.
184 C Cycle forwards through all the supported colorspaces. With
186 Shift pressed: cycle backwards. With Ctrl pressed: restore the
187 original colorspace.
188 X Cycle forwards through all the supported transfer functions.
190 With Shift pressed: cycle backwards. With Ctrl pressed: restore
191 the original transfer function.
192 Y Cycle forwards through all the supported Y'CbCr encodings. With
194 Shift pressed: cycle backwards. With Ctrl pressed: restore the
195 original Y'CbCr encoding.
196 H Cycle forwards through all the supported HSV encodings. With
198 Shift pressed: cycle backwards. With Ctrl pressed: restore the
199 original HSV encoding.
200 R Cycle forwards through all the supported quantization ranges.
202 With Shift pressed: cycle backwards. With Ctrl pressed: restore
203 the original quantization range.
204 Right-Click
206 Open menu.
207 Double left-click
209 Toggle fullscreen on and off.
210 F Toggle fullscreen on and off.
212 ESC Exit fullscreen.
214 Space When in test mode (--test) pressing Space will skip to the next
216 test. When single-stepping, continue to the next frame.
217 Up Reduce the resolution by two pixels in height. Only available
219 when "Override resolution" is enabled.
220 Down Increase the resolution by two pixels in height. Only available
222 when "Override resolution" is enabled.
223 Left Reduce the resolution by two pixels in width. Only available
225 when "Override resolution" is enabled.
226 Right Increase the resolution by two pixels in width. Only available
228 when "Override resolution" is enabled.
229
231 On success, it returns 0. Otherwise, it will return the number of
232 errors.
233
235 Report bugs to Hans Verkuil <hverkuil@xs4all.nl>
236v4l-utils 1.18.0 June 2016 QVIDCAP(1)