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 -
37 .. flat-table::
38 :header-rows: 0
39 :stub-columns: 0
41 * - ``V4L2_EXPOSURE_AUTO``
42 - Automatic exposure time, automatic iris aperture.
43 * - ``V4L2_EXPOSURE_MANUAL``
44 - Manual exposure time, manual iris.
45 * - ``V4L2_EXPOSURE_SHUTTER_PRIORITY``
46 - Manual exposure time, auto iris.
47 * - ``V4L2_EXPOSURE_APERTURE_PRIORITY``
48 - Auto exposure time, manual iris.
76 .. _v4l2-exposure-metering:
81 enum v4l2_exposure_metering -
87 .. flat-table::
88 :header-rows: 0
89 :stub-columns: 0
91 * - ``V4L2_EXPOSURE_METERING_AVERAGE``
92 - Use the light information coming from the entire frame and average
94 * - ``V4L2_EXPOSURE_METERING_CENTER_WEIGHTED``
95 - Average the light information coming from the entire frame giving
97 * - ``V4L2_EXPOSURE_METERING_SPOT``
98 - Measure only very small area at the center of the frame.
99 * - ``V4L2_EXPOSURE_METERING_MATRIX``
100 - A multi-zone metering. The light intensity is measured in several
111 left. A value of zero does not cause motion. This is a write-only
118 a write-only control.
132 interpret the values as arc seconds, with valid values between -180
139 between -180 * 3600 and +180 * 3600 inclusive.
150 write-only control.
168 .. _v4l2-auto-focus-status:
171 The automatic focus status. This is a read-only control.
179 .. flat-table::
180 :header-rows: 0
181 :stub-columns: 0
183 * - ``V4L2_AUTO_FOCUS_STATUS_IDLE``
184 - Automatic focus is not active.
185 * - ``V4L2_AUTO_FOCUS_STATUS_BUSY``
186 - Automatic focusing is in progress.
187 * - ``V4L2_AUTO_FOCUS_STATUS_REACHED``
188 - Focus has been reached.
189 * - ``V4L2_AUTO_FOCUS_STATUS_FAILED``
190 - Automatic focus has failed, the driver will not transition from
195 .. _v4l2-auto-focus-range:
200 enum v4l2_auto_focus_range -
205 .. flat-table::
206 :header-rows: 0
207 :stub-columns: 0
209 * - ``V4L2_AUTO_FOCUS_RANGE_AUTO``
210 - The camera automatically selects the focus range.
211 * - ``V4L2_AUTO_FOCUS_RANGE_NORMAL``
212 - Normal distance range, limited for best automatic focus
214 * - ``V4L2_AUTO_FOCUS_RANGE_MACRO``
215 - Macro (close-up) auto focus. The camera will use its minimum
217 * - ``V4L2_AUTO_FOCUS_RANGE_INFINITY``
218 - The lens is set to focus on an object at infinite distance.
224 zoom unit is driver-specific and its value should be a positive
230 telephoto direction, negative values towards the wide-angle
231 direction. The zoom unit is driver-specific. This is a write-only
240 wide-angle direction. The zoom speed unit is driver-specific.
251 write-only control.
254 Prevent video from being acquired by the camera. When this control
256 Common means to enforce privacy are mechanical obturation of the
262 Switch the band-stop filter of a camera sensor on or off, or specify
263 its strength. Such band-stop filters can be used, for example, to
266 .. _v4l2-auto-n-preset-white-balance:
271 enum v4l2_auto_n_preset_white_balance -
280 .. flat-table::
281 :header-rows: 0
282 :stub-columns: 0
284 * - ``V4L2_WHITE_BALANCE_MANUAL``
285 - Manual white balance.
286 * - ``V4L2_WHITE_BALANCE_AUTO``
287 - Automatic white balance adjustments.
288 * - ``V4L2_WHITE_BALANCE_INCANDESCENT``
289 - White balance setting for incandescent (tungsten) lighting. It
292 * - ``V4L2_WHITE_BALANCE_FLUORESCENT``
293 - White balance preset for fluorescent lighting. It corresponds
295 * - ``V4L2_WHITE_BALANCE_FLUORESCENT_H``
296 - With this setting the camera will compensate for fluorescent H
298 * - ``V4L2_WHITE_BALANCE_HORIZON``
299 - White balance setting for horizon daylight. It corresponds
301 * - ``V4L2_WHITE_BALANCE_DAYLIGHT``
302 - White balance preset for daylight (with clear sky). It corresponds
304 * - ``V4L2_WHITE_BALANCE_FLASH``
305 - With this setting the camera will compensate for the flash light.
308 * - ``V4L2_WHITE_BALANCE_CLOUDY``
309 - White balance preset for moderately overcast sky. This option
312 * - ``V4L2_WHITE_BALANCE_SHADE``
313 - White balance preset for shade or heavily overcast sky. It
318 .. _v4l2-wide-dynamic-range:
328 .. _v4l2-image-stabilization:
346 .. _v4l2-iso-sensitivity-auto-type:
351 enum v4l2_iso_sensitivity_type -
356 .. flat-table::
357 :header-rows: 0
358 :stub-columns: 0
360 * - ``V4L2_CID_ISO_SENSITIVITY_MANUAL``
361 - Manual ISO sensitivity.
362 * - ``V4L2_CID_ISO_SENSITIVITY_AUTO``
363 - Automatic ISO sensitivity adjustments.
367 .. _v4l2-scene-mode:
372 enum v4l2_scene_mode -
377 parameters are influenced by the scene mode control. An exact
378 behavior in each mode is subject to the camera specification.
380 When the scene mode feature is not used, this control should be set
392 .. flat-table::
393 :header-rows: 0
394 :stub-columns: 0
396 * - ``V4L2_SCENE_MODE_NONE``
397 - The scene mode feature is disabled.
398 * - ``V4L2_SCENE_MODE_BACKLIGHT``
399 - Backlight. Compensates for dark shadows when light is coming from
401 * - ``V4L2_SCENE_MODE_BEACH_SNOW``
402 - Beach and snow. This mode compensates for all-white or bright
405 compensate, this mode automatically slightly overexposes the
408 * - ``V4L2_SCENE_MODE_CANDLELIGHT``
409 - Candle light. The camera generally raises the ISO sensitivity and
410 lowers the shutter speed. This mode compensates for relatively
413 * - ``V4L2_SCENE_MODE_DAWN_DUSK``
414 - Dawn and dusk. Preserves the colors seen in low natural light
418 * - ``V4L2_SCENE_MODE_FALL_COLORS``
419 - Fall colors. Increases saturation and adjusts white balance for
422 * - ``V4L2_SCENE_MODE_FIREWORKS``
423 - Fireworks. Long exposure times are used to capture the expanding
426 * - ``V4L2_SCENE_MODE_LANDSCAPE``
427 - Landscape. The camera may choose a small aperture to provide deep
431 * - ``V4L2_SCENE_MODE_NIGHT``
432 - Night, also known as Night Landscape. Designed for low light
435 medium-to-high ISO sensitivity, with a relatively long exposure
438 * - ``V4L2_SCENE_MODE_PARTY_INDOOR``
439 - Party and indoor. Designed to capture indoor scenes that are lit
443 * - ``V4L2_SCENE_MODE_PORTRAIT``
444 - Portrait. The camera adjusts the aperture so that the depth of
449 * - ``V4L2_SCENE_MODE_SPORTS``
450 - Sports. Significantly increases ISO and uses a fast shutter speed
451 to freeze motion of rapidly-moving subjects. Increased image noise
452 may be seen in this mode.
453 * - ``V4L2_SCENE_MODE_SUNSET``
454 - Sunset. Preserves deep hues seen in sunsets and sunrises. It bumps
456 * - ``V4L2_SCENE_MODE_TEXT``
457 - Text. It applies extra contrast and sharpness, it is typically a
458 black-and-white mode optimized for readability. Automatic focus
459 may be switched to close-up mode and this setting may also involve
460 some lens-distortion correction.
483 .. flat-table::
484 :header-rows: 0
485 :stub-columns: 0
487 * - ``V4L2_LOCK_EXPOSURE``
488 - Automatic exposure adjustments lock.
489 * - ``V4L2_LOCK_WHITE_BALANCE``
490 - Automatic white balance adjustments lock.
491 * - ``V4L2_LOCK_FOCUS``
492 - Automatic focus lock.
510 This read-only control describes the camera orientation by reporting its
516 example, a camera installed on the user-facing side of a phone, a tablet or
527 .. flat-table::
528 :header-rows: 0
529 :stub-columns: 0
531 * - ``V4L2_CAMERA_ORIENTATION_FRONT``
532 - The camera is oriented towards the user facing side of the device.
533 * - ``V4L2_CAMERA_ORIENTATION_BACK``
534 - The camera is oriented towards the back facing side of the device.
535 * - ``V4L2_CAMERA_ORIENTATION_EXTERNAL``
536 - The camera is not directly attached to the device and is freely movable.
541 This read-only control describes the rotation correction in degrees in the
542 counter-clockwise direction to be applied to the captured images once
547 bindings file 'video-interfaces.txt'.
552 0 X-axis
553 0 +------------------------------------->
564 Y-axis
566 Example one - Webcam
570 laptop screen casing, and is typically used for video calls. The captured
571 images are meant to be displayed in landscape mode (width > height) on the
574 The camera is typically mounted upside-down to compensate the lens optical
579 If the camera sensor is not mounted upside-down it is required to compensate
584 +--------------------------------------+
594 +--------------------------------------+
599 +--------------------------------------+
609 +--------------------------------------+
611 Example two - Phone camera
616 to be displayed in portrait mode (height > width) to match the device screen
620 aligned to the device longer side, upside-down mounted to compensate for
627 +-------------------------------------+
637 +-------------------------------------+
639 A correction of 90 degrees in counter-clockwise direction has to be
640 applied to correctly display the image in portrait mode on the device
643 +--------------------+
658 +--------------------+