Lines Matching +full:enforce +full:- +full:video +full:- +full:mode
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.
75 .. _v4l2-exposure-metering:
80 enum v4l2_exposure_metering -
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
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.
253 Prevent video from being acquired by the camera. When this control
255 Common means to enforce privacy are mechanical obturation of the
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 -
376 parameters are influenced by the scene mode control. An exact
377 behavior in each mode is subject to the camera specification.
379 When the scene mode feature is not used, this control should be set
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
402 compensate, this mode automatically slightly overexposes the
405 * - ``V4L2_SCENE_MODE_CANDLELIGHT``
406 - Candle light. The camera generally raises the ISO sensitivity and
407 lowers the shutter speed. This mode compensates for relatively
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
449 may be seen in this mode.
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
566 laptop screen casing, and is typically used for video calls. The captured
567 images are meant to be displayed in landscape mode (width > height) on the
570 The camera is typically mounted upside-down to compensate the lens optical
575 If the camera sensor is not mounted upside-down it is required to compensate
580 +--------------------------------------+
590 +--------------------------------------+
595 +--------------------------------------+
605 +--------------------------------------+
607 Example two - Phone camera
612 to be displayed in portrait mode (height > width) to match the device screen
616 aligned to the device longer side, upside-down mounted to compensate for
623 +-------------------------------------+
633 +-------------------------------------+
635 A correction of 90 degrees in counter-clockwise direction has to be
636 applied to correctly display the image in portrait mode on the device
639 +--------------------+
654 +--------------------+