Lines Matching +full:no +full:- +full:motion
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
4 .. _camera-controls:
14 .. _camera-control-id:
24 .. _v4l2-exposure-auto-type:
29 enum v4l2_exposure_auto_type -
38 .. flat-table::
39 :header-rows: 0
40 :stub-columns: 0
42 * - ``V4L2_EXPOSURE_AUTO``
43 - Automatic exposure time, automatic iris aperture.
44 * - ``V4L2_EXPOSURE_MANUAL``
45 - Manual exposure time, manual iris.
46 * - ``V4L2_EXPOSURE_SHUTTER_PRIORITY``
47 - Manual exposure time, auto iris.
48 * - ``V4L2_EXPOSURE_APERTURE_PRIORITY``
49 - Auto exposure time, manual iris.
77 .. _v4l2-exposure-metering:
82 enum v4l2_exposure_metering -
88 .. flat-table::
89 :header-rows: 0
90 :stub-columns: 0
92 * - ``V4L2_EXPOSURE_METERING_AVERAGE``
93 - Use the light information coming from the entire frame and average
94 giving no weighting to any particular portion of the metered area.
95 * - ``V4L2_EXPOSURE_METERING_CENTER_WEIGHTED``
96 - Average the light information coming from the entire frame giving
98 * - ``V4L2_EXPOSURE_METERING_SPOT``
99 - Measure only very small area at the center of the frame.
100 * - ``V4L2_EXPOSURE_METERING_MATRIX``
101 - A multi-zone metering. The light intensity is measured in several
112 left. A value of zero does not cause motion. This is a write-only
118 negative value down. A value of zero does not cause motion. This is
119 a write-only control.
133 interpret the values as arc seconds, with valid values between -180
140 between -180 * 3600 and +180 * 3600 inclusive.
151 write-only control.
169 .. _v4l2-auto-focus-status:
172 The automatic focus status. This is a read-only control.
180 .. flat-table::
181 :header-rows: 0
182 :stub-columns: 0
184 * - ``V4L2_AUTO_FOCUS_STATUS_IDLE``
185 - Automatic focus is not active.
186 * - ``V4L2_AUTO_FOCUS_STATUS_BUSY``
187 - Automatic focusing is in progress.
188 * - ``V4L2_AUTO_FOCUS_STATUS_REACHED``
189 - Focus has been reached.
190 * - ``V4L2_AUTO_FOCUS_STATUS_FAILED``
191 - Automatic focus has failed, the driver will not transition from
196 .. _v4l2-auto-focus-range:
201 enum v4l2_auto_focus_range -
206 .. flat-table::
207 :header-rows: 0
208 :stub-columns: 0
210 * - ``V4L2_AUTO_FOCUS_RANGE_AUTO``
211 - The camera automatically selects the focus range.
212 * - ``V4L2_AUTO_FOCUS_RANGE_NORMAL``
213 - Normal distance range, limited for best automatic focus
215 * - ``V4L2_AUTO_FOCUS_RANGE_MACRO``
216 - Macro (close-up) auto focus. The camera will use its minimum
218 * - ``V4L2_AUTO_FOCUS_RANGE_INFINITY``
219 - The lens is set to focus on an object at infinite distance.
225 zoom unit is driver-specific and its value should be a positive
231 telephoto direction, negative values towards the wide-angle
232 direction. The zoom unit is driver-specific. This is a write-only
241 wide-angle direction. The zoom speed unit is driver-specific.
252 write-only control.
256 is set to ``TRUE`` (1), no image can be captured by the camera.
263 Switch the band-stop filter of a camera sensor on or off, or specify
264 its strength. Such band-stop filters can be used, for example, to
267 .. _v4l2-auto-n-preset-white-balance:
272 enum v4l2_auto_n_preset_white_balance -
281 .. flat-table::
282 :header-rows: 0
283 :stub-columns: 0
285 * - ``V4L2_WHITE_BALANCE_MANUAL``
286 - Manual white balance.
287 * - ``V4L2_WHITE_BALANCE_AUTO``
288 - Automatic white balance adjustments.
289 * - ``V4L2_WHITE_BALANCE_INCANDESCENT``
290 - White balance setting for incandescent (tungsten) lighting. It
293 * - ``V4L2_WHITE_BALANCE_FLUORESCENT``
294 - White balance preset for fluorescent lighting. It corresponds
296 * - ``V4L2_WHITE_BALANCE_FLUORESCENT_H``
297 - With this setting the camera will compensate for fluorescent H
299 * - ``V4L2_WHITE_BALANCE_HORIZON``
300 - White balance setting for horizon daylight. It corresponds
302 * - ``V4L2_WHITE_BALANCE_DAYLIGHT``
303 - White balance preset for daylight (with clear sky). It corresponds
305 * - ``V4L2_WHITE_BALANCE_FLASH``
306 - With this setting the camera will compensate for the flash light.
309 * - ``V4L2_WHITE_BALANCE_CLOUDY``
310 - White balance preset for moderately overcast sky. This option
313 * - ``V4L2_WHITE_BALANCE_SHADE``
314 - White balance preset for shade or heavily overcast sky. It
319 .. _v4l2-wide-dynamic-range:
329 .. _v4l2-image-stabilization:
347 .. _v4l2-iso-sensitivity-auto-type:
352 enum v4l2_iso_sensitivity_type -
357 .. flat-table::
358 :header-rows: 0
359 :stub-columns: 0
361 * - ``V4L2_CID_ISO_SENSITIVITY_MANUAL``
362 - Manual ISO sensitivity.
363 * - ``V4L2_CID_ISO_SENSITIVITY_AUTO``
364 - Automatic ISO sensitivity adjustments.
368 .. _v4l2-scene-mode:
373 enum v4l2_scene_mode -
393 .. flat-table::
394 :header-rows: 0
395 :stub-columns: 0
397 * - ``V4L2_SCENE_MODE_NONE``
398 - The scene mode feature is disabled.
399 * - ``V4L2_SCENE_MODE_BACKLIGHT``
400 - Backlight. Compensates for dark shadows when light is coming from
402 * - ``V4L2_SCENE_MODE_BEACH_SNOW``
403 - Beach and snow. This mode compensates for all-white or bright
409 * - ``V4L2_SCENE_MODE_CANDLELIGHT``
410 - Candle light. The camera generally raises the ISO sensitivity and
414 * - ``V4L2_SCENE_MODE_DAWN_DUSK``
415 - Dawn and dusk. Preserves the colors seen in low natural light
419 * - ``V4L2_SCENE_MODE_FALL_COLORS``
420 - Fall colors. Increases saturation and adjusts white balance for
423 * - ``V4L2_SCENE_MODE_FIREWORKS``
424 - Fireworks. Long exposure times are used to capture the expanding
427 * - ``V4L2_SCENE_MODE_LANDSCAPE``
428 - Landscape. The camera may choose a small aperture to provide deep
432 * - ``V4L2_SCENE_MODE_NIGHT``
433 - Night, also known as Night Landscape. Designed for low light
436 medium-to-high ISO sensitivity, with a relatively long exposure
439 * - ``V4L2_SCENE_MODE_PARTY_INDOOR``
440 - Party and indoor. Designed to capture indoor scenes that are lit
444 * - ``V4L2_SCENE_MODE_PORTRAIT``
445 - Portrait. The camera adjusts the aperture so that the depth of
450 * - ``V4L2_SCENE_MODE_SPORTS``
451 - Sports. Significantly increases ISO and uses a fast shutter speed
452 to freeze motion of rapidly-moving subjects. Increased image noise
454 * - ``V4L2_SCENE_MODE_SUNSET``
455 - Sunset. Preserves deep hues seen in sunsets and sunrises. It bumps
457 * - ``V4L2_SCENE_MODE_TEXT``
458 - Text. It applies extra contrast and sharpness, it is typically a
459 black-and-white mode optimized for readability. Automatic focus
460 may be switched to close-up mode and this setting may also involve
461 some lens-distortion correction.
476 requests to lock it and should return no error. An example might be
484 .. flat-table::
485 :header-rows: 0
486 :stub-columns: 0
488 * - ``V4L2_LOCK_EXPOSURE``
489 - Automatic exposure adjustments lock.
490 * - ``V4L2_LOCK_WHITE_BALANCE``
491 - Automatic white balance adjustments lock.
492 * - ``V4L2_LOCK_FOCUS``
493 - Automatic focus lock.
501 left. A value of zero stops the motion if one is in progress and has
502 no effect otherwise.
507 value down. A value of zero stops the motion if one is in progress
508 and has no effect otherwise.
510 .. _v4l2-camera-sensor-orientation:
513 This read-only control describes the camera orientation by reporting its
519 example, a camera installed on the user-facing side of a phone, a tablet or
530 .. flat-table::
531 :header-rows: 0
532 :stub-columns: 0
534 * - ``V4L2_CAMERA_ORIENTATION_FRONT``
535 - The camera is oriented towards the user facing side of the device.
536 * - ``V4L2_CAMERA_ORIENTATION_BACK``
537 - The camera is oriented towards the back facing side of the device.
538 * - ``V4L2_CAMERA_ORIENTATION_EXTERNAL``
539 - The camera is not directly attached to the device and is freely movable.
542 .. _v4l2-camera-sensor-rotation:
545 This read-only control describes the rotation correction in degrees in the
546 counter-clockwise direction to be applied to the captured images once
551 bindings file 'video-interfaces.txt'.
556 0 X-axis
557 0 +------------------------------------->
568 Y-axis
570 Example one - Webcam
578 The camera is typically mounted upside-down to compensate the lens optical
580 V4L2_CID_CAMERA_SENSOR_ROTATION control is 0, no rotation is required to
583 If the camera sensor is not mounted upside-down it is required to compensate
588 +--------------------------------------+
598 +--------------------------------------+
603 +--------------------------------------+
613 +--------------------------------------+
615 Example two - Phone camera
624 aligned to the device longer side, upside-down mounted to compensate for
631 +-------------------------------------+
641 +-------------------------------------+
643 A correction of 90 degrees in counter-clockwise direction has to be
647 +--------------------+
662 +--------------------+