Lines Matching +full:lens +full:- +full:focus
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.
143 position. The unit is undefined. Positive values set the focus
148 amount. The unit is undefined. Positive values move the focus closer
150 write-only control.
153 Enables continuous automatic focus adjustments. The effect of manual
154 focus adjustments while this feature is enabled is undefined,
158 Starts single auto focus process. The effect of setting this 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 -
201 Determines auto focus distance range for which lens may be adjusted.
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
216 possible distance for auto focus.
217 * - ``V4L2_AUTO_FOCUS_RANGE_INFINITY``
218 - The lens is set to focus on an object at infinite distance.
223 Specify the objective lens focal length as an absolute value. The
224 zoom unit is driver-specific and its value should be a positive
228 Specify the objective lens focal length relatively to the current
229 value. Positive values move the zoom lens group towards the
230 telephoto direction, negative values towards the wide-angle
231 direction. The zoom unit is driver-specific. This is a write-only
235 Move the objective lens group at the specified speed until it
237 the movement. A positive value moves the zoom lens group towards the
238 telephoto direction. A value of zero stops the zoom lens group
239 movement. A negative value moves the zoom lens group towards the
240 wide-angle direction. The zoom speed unit is driver-specific.
251 write-only control.
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 -
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
408 * - ``V4L2_SCENE_MODE_CANDLELIGHT``
409 - Candle light. The camera generally raises the ISO sensitivity and
413 * - ``V4L2_SCENE_MODE_DAWN_DUSK``
414 - Dawn and dusk. Preserves the colors seen in low natural light
416 automatically focus at infinity. It will usually boost saturation
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
429 in dim light conditions. The focus is fixed at infinity. Suitable
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
447 the scene and focus on them. The color hue is adjusted to enhance
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
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.
468 This control locks or unlocks the automatic focus, exposure and
479 focus controls.
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
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
580 the lens optical inversion effect and the value of the
584 +--------------------------------------+
594 +--------------------------------------+
599 +--------------------------------------+
609 +--------------------------------------+
611 Example two - Phone camera
620 aligned to the device longer side, upside-down mounted to compensate for
621 the lens optical inversion effect.
627 +-------------------------------------+
637 +-------------------------------------+
639 A correction of 90 degrees in counter-clockwise direction has to be
643 +--------------------+
658 +--------------------+