Lines Matching +full:frame +full:- +full:inversion
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
3 .. _camera-controls:
13 .. _camera-control-id:
23 .. _v4l2-exposure-auto-type:
28 enum v4l2_exposure_auto_type -
36 .. flat-table::
37 :header-rows: 0
38 :stub-columns: 0
40 * - ``V4L2_EXPOSURE_AUTO``
41 - Automatic exposure time, automatic iris aperture.
42 * - ``V4L2_EXPOSURE_MANUAL``
43 - Manual exposure time, manual iris.
44 * - ``V4L2_EXPOSURE_SHUTTER_PRIORITY``
45 - Manual exposure time, auto iris.
46 * - ``V4L2_EXPOSURE_APERTURE_PRIORITY``
47 - Auto exposure time, manual iris.
53 is limited by the frame interval. Drivers should interpret the
60 dynamically vary the frame rate. By default this feature is disabled
61 (0) and the frame rate must remain constant.
75 .. _v4l2-exposure-metering:
80 enum v4l2_exposure_metering -
82 the frame exposure. Possible values are:
86 .. flat-table::
87 :header-rows: 0
88 :stub-columns: 0
90 * - ``V4L2_EXPOSURE_METERING_AVERAGE``
91 - Use the light information coming from the entire frame and average
93 * - ``V4L2_EXPOSURE_METERING_CENTER_WEIGHTED``
94 - Average the light information coming from the entire frame giving
96 * - ``V4L2_EXPOSURE_METERING_SPOT``
97 - Measure only very small area at the center of the frame.
98 * - ``V4L2_EXPOSURE_METERING_MATRIX``
99 - A multi-zone metering. The light intensity is measured in several
100 points of the frame and the results are combined. The algorithm of
110 left. A value of zero does not cause motion. This is a write-only
117 a write-only control.
131 interpret the values as arc seconds, with valid values between -180
138 between -180 * 3600 and +180 * 3600 inclusive.
149 write-only control.
167 .. _v4l2-auto-focus-status:
170 The automatic focus status. This is a read-only control.
178 .. flat-table::
179 :header-rows: 0
180 :stub-columns: 0
182 * - ``V4L2_AUTO_FOCUS_STATUS_IDLE``
183 - Automatic focus is not active.
184 * - ``V4L2_AUTO_FOCUS_STATUS_BUSY``
185 - Automatic focusing is in progress.
186 * - ``V4L2_AUTO_FOCUS_STATUS_REACHED``
187 - Focus has been reached.
188 * - ``V4L2_AUTO_FOCUS_STATUS_FAILED``
189 - Automatic focus has failed, the driver will not transition from
194 .. _v4l2-auto-focus-range:
199 enum v4l2_auto_focus_range -
204 .. flat-table::
205 :header-rows: 0
206 :stub-columns: 0
208 * - ``V4L2_AUTO_FOCUS_RANGE_AUTO``
209 - The camera automatically selects the focus range.
210 * - ``V4L2_AUTO_FOCUS_RANGE_NORMAL``
211 - Normal distance range, limited for best automatic focus
213 * - ``V4L2_AUTO_FOCUS_RANGE_MACRO``
214 - Macro (close-up) auto focus. The camera will use its minimum
216 * - ``V4L2_AUTO_FOCUS_RANGE_INFINITY``
217 - The lens is set to focus on an object at infinite distance.
223 zoom unit is driver-specific and its value should be a positive
229 telephoto direction, negative values towards the wide-angle
230 direction. The zoom unit is driver-specific. This is a write-only
239 wide-angle direction. The zoom speed unit is driver-specific.
250 write-only control.
261 Switch the band-stop filter of a camera sensor on or off, or specify
262 its strength. Such band-stop filters can be used, for example, to
265 .. _v4l2-auto-n-preset-white-balance:
270 enum v4l2_auto_n_preset_white_balance -
279 .. flat-table::
280 :header-rows: 0
281 :stub-columns: 0
283 * - ``V4L2_WHITE_BALANCE_MANUAL``
284 - Manual white balance.
285 * - ``V4L2_WHITE_BALANCE_AUTO``
286 - Automatic white balance adjustments.
287 * - ``V4L2_WHITE_BALANCE_INCANDESCENT``
288 - White balance setting for incandescent (tungsten) lighting. It
291 * - ``V4L2_WHITE_BALANCE_FLUORESCENT``
292 - White balance preset for fluorescent lighting. It corresponds
294 * - ``V4L2_WHITE_BALANCE_FLUORESCENT_H``
295 - With this setting the camera will compensate for fluorescent H
297 * - ``V4L2_WHITE_BALANCE_HORIZON``
298 - White balance setting for horizon daylight. It corresponds
300 * - ``V4L2_WHITE_BALANCE_DAYLIGHT``
301 - White balance preset for daylight (with clear sky). It corresponds
303 * - ``V4L2_WHITE_BALANCE_FLASH``
304 - With this setting the camera will compensate for the flash light.
307 * - ``V4L2_WHITE_BALANCE_CLOUDY``
308 - White balance preset for moderately overcast sky. This option
311 * - ``V4L2_WHITE_BALANCE_SHADE``
312 - White balance preset for shade or heavily overcast sky. It
317 .. _v4l2-wide-dynamic-range:
327 .. _v4l2-image-stabilization:
345 .. _v4l2-iso-sensitivity-auto-type:
350 enum v4l2_iso_sensitivity_type -
355 .. flat-table::
356 :header-rows: 0
357 :stub-columns: 0
359 * - ``V4L2_CID_ISO_SENSITIVITY_MANUAL``
360 - Manual ISO sensitivity.
361 * - ``V4L2_CID_ISO_SENSITIVITY_AUTO``
362 - Automatic ISO sensitivity adjustments.
366 .. _v4l2-scene-mode:
371 enum v4l2_scene_mode -
389 .. flat-table::
390 :header-rows: 0
391 :stub-columns: 0
393 * - ``V4L2_SCENE_MODE_NONE``
394 - The scene mode feature is disabled.
395 * - ``V4L2_SCENE_MODE_BACKLIGHT``
396 - Backlight. Compensates for dark shadows when light is coming from
398 * - ``V4L2_SCENE_MODE_BEACH_SNOW``
399 - Beach and snow. This mode compensates for all-white or bright
405 * - ``V4L2_SCENE_MODE_CANDLELIGHT``
406 - Candle light. The camera generally raises the ISO sensitivity and
410 * - ``V4L2_SCENE_MODE_DAWN_DUSK``
411 - Dawn and dusk. Preserves the colors seen in low natural light
415 * - ``V4L2_SCENE_MODE_FALL_COLORS``
416 - Fall colors. Increases saturation and adjusts white balance for
419 * - ``V4L2_SCENE_MODE_FIREWORKS``
420 - Fireworks. Long exposure times are used to capture the expanding
423 * - ``V4L2_SCENE_MODE_LANDSCAPE``
424 - Landscape. The camera may choose a small aperture to provide deep
428 * - ``V4L2_SCENE_MODE_NIGHT``
429 - Night, also known as Night Landscape. Designed for low light
432 medium-to-high ISO sensitivity, with a relatively long exposure
435 * - ``V4L2_SCENE_MODE_PARTY_INDOOR``
436 - Party and indoor. Designed to capture indoor scenes that are lit
440 * - ``V4L2_SCENE_MODE_PORTRAIT``
441 - Portrait. The camera adjusts the aperture so that the depth of
446 * - ``V4L2_SCENE_MODE_SPORTS``
447 - Sports. Significantly increases ISO and uses a fast shutter speed
448 to freeze motion of rapidly-moving subjects. Increased image noise
450 * - ``V4L2_SCENE_MODE_SUNSET``
451 - Sunset. Preserves deep hues seen in sunsets and sunrises. It bumps
453 * - ``V4L2_SCENE_MODE_TEXT``
454 - Text. It applies extra contrast and sharpness, it is typically a
455 black-and-white mode optimized for readability. Automatic focus
456 may be switched to close-up mode and this setting may also involve
457 some lens-distortion correction.
480 .. flat-table::
481 :header-rows: 0
482 :stub-columns: 0
484 * - ``V4L2_LOCK_EXPOSURE``
485 - Automatic exposure adjustments lock.
486 * - ``V4L2_LOCK_WHITE_BALANCE``
487 - Automatic white balance adjustments lock.
488 * - ``V4L2_LOCK_FOCUS``
489 - Automatic focus lock.
507 This read-only control describes the camera orientation by reporting its
513 example, a camera installed on the user-facing side of a phone, a tablet or
523 .. flat-table::
524 :header-rows: 0
525 :stub-columns: 0
527 * - ``V4L2_CAMERA_ORIENTATION_FRONT``
528 - The camera is oriented towards the user facing side of the device.
529 * - ``V4L2_CAMERA_ORIENTATION_BACK``
530 - The camera is oriented towards the back facing side of the device.
531 * - ``V4L2_CAMERA_ORIENTATION_EXTERNAL``
532 - The camera is not directly attached to the device and is freely movable.
537 This read-only control describes the rotation correction in degrees in the
538 counter-clockwise direction to be applied to the captured images once
543 bindings file 'video-interfaces.txt'.
548 0 X-axis
549 0 +------------------------------------->
560 Y-axis
562 Example one - Webcam
570 The camera is typically mounted upside-down to compensate the lens optical
571 inversion effect. In this case the value of the
575 If the camera sensor is not mounted upside-down it is required to compensate
576 the lens optical inversion effect and the value of the
580 +--------------------------------------+
590 +--------------------------------------+
595 +--------------------------------------+
605 +--------------------------------------+
607 Example two - Phone camera
616 aligned to the device longer side, upside-down mounted to compensate for
617 the lens optical inversion effect.
623 +-------------------------------------+
633 +-------------------------------------+
635 A correction of 90 degrees in counter-clockwise direction has to be
639 +--------------------+
654 +--------------------+