^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) .. _camera-controls:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) ************************
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) Camera Control Reference
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) ************************
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) The Camera class includes controls for mechanical (or equivalent
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) digital) features of a device such as controllable lenses or sensors.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) .. _camera-control-id:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) Camera Control IDs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) ==================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) ``V4L2_CID_CAMERA_CLASS (class)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) The Camera class descriptor. Calling
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) :ref:`VIDIOC_QUERYCTRL` for this control will
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) return a description of this control class.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) .. _v4l2-exposure-auto-type:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) ``V4L2_CID_EXPOSURE_AUTO``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) (enum)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) enum v4l2_exposure_auto_type -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) Enables automatic adjustments of the exposure time and/or iris
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) aperture. The effect of manual changes of the exposure time or iris
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) aperture while these features are enabled is undefined, drivers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) should ignore such requests. Possible values are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) * - ``V4L2_EXPOSURE_AUTO``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) - Automatic exposure time, automatic iris aperture.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) * - ``V4L2_EXPOSURE_MANUAL``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) - Manual exposure time, manual iris.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) * - ``V4L2_EXPOSURE_SHUTTER_PRIORITY``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) - Manual exposure time, auto iris.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) * - ``V4L2_EXPOSURE_APERTURE_PRIORITY``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) - Auto exposure time, manual iris.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) ``V4L2_CID_EXPOSURE_ABSOLUTE (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) Determines the exposure time of the camera sensor. The exposure time
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) is limited by the frame interval. Drivers should interpret the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) values as 100 µs units, where the value 1 stands for 1/10000th of a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) second, 10000 for 1 second and 100000 for 10 seconds.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) ``V4L2_CID_EXPOSURE_AUTO_PRIORITY (boolean)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) When ``V4L2_CID_EXPOSURE_AUTO`` is set to ``AUTO`` or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) ``APERTURE_PRIORITY``, this control determines if the device may
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) dynamically vary the frame rate. By default this feature is disabled
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) (0) and the frame rate must remain constant.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) ``V4L2_CID_AUTO_EXPOSURE_BIAS (integer menu)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) Determines the automatic exposure compensation, it is effective only
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) when ``V4L2_CID_EXPOSURE_AUTO`` control is set to ``AUTO``,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) ``SHUTTER_PRIORITY`` or ``APERTURE_PRIORITY``. It is expressed in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) terms of EV, drivers should interpret the values as 0.001 EV units,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) where the value 1000 stands for +1 EV.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) Increasing the exposure compensation value is equivalent to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) decreasing the exposure value (EV) and will increase the amount of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) light at the image sensor. The camera performs the exposure
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) compensation by adjusting absolute exposure time and/or aperture.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) .. _v4l2-exposure-metering:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) ``V4L2_CID_EXPOSURE_METERING``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) (enum)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) enum v4l2_exposure_metering -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) Determines how the camera measures the amount of light available for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) the frame exposure. Possible values are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) .. tabularcolumns:: |p{8.7cm}|p{8.8cm}|
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) * - ``V4L2_EXPOSURE_METERING_AVERAGE``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) - Use the light information coming from the entire frame and average
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) giving no weighting to any particular portion of the metered area.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) * - ``V4L2_EXPOSURE_METERING_CENTER_WEIGHTED``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) - Average the light information coming from the entire frame giving
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) priority to the center of the metered area.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) * - ``V4L2_EXPOSURE_METERING_SPOT``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) - Measure only very small area at the center of the frame.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) * - ``V4L2_EXPOSURE_METERING_MATRIX``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) - A multi-zone metering. The light intensity is measured in several
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) points of the frame and the results are combined. The algorithm of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) the zones selection and their significance in calculating the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) final value is device dependent.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) ``V4L2_CID_PAN_RELATIVE (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) This control turns the camera horizontally by the specified amount.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) The unit is undefined. A positive value moves the camera to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) right (clockwise when viewed from above), a negative value to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) left. A value of zero does not cause motion. This is a write-only
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) control.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) ``V4L2_CID_TILT_RELATIVE (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) This control turns the camera vertically by the specified amount.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) The unit is undefined. A positive value moves the camera up, a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) negative value down. A value of zero does not cause motion. This is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) a write-only control.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) ``V4L2_CID_PAN_RESET (button)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) When this control is set, the camera moves horizontally to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) default position.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) ``V4L2_CID_TILT_RESET (button)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) When this control is set, the camera moves vertically to the default
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) position.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) ``V4L2_CID_PAN_ABSOLUTE (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) This control turns the camera horizontally to the specified
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) position. Positive values move the camera to the right (clockwise
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) when viewed from above), negative values to the left. Drivers should
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) interpret the values as arc seconds, with valid values between -180
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) * 3600 and +180 * 3600 inclusive.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) ``V4L2_CID_TILT_ABSOLUTE (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) This control turns the camera vertically to the specified position.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) Positive values move the camera up, negative values down. Drivers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) should interpret the values as arc seconds, with valid values
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) between -180 * 3600 and +180 * 3600 inclusive.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) ``V4L2_CID_FOCUS_ABSOLUTE (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) This control sets the focal point of the camera to the specified
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) position. The unit is undefined. Positive values set the focus
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) closer to the camera, negative values towards infinity.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) ``V4L2_CID_FOCUS_RELATIVE (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) This control moves the focal point of the camera by the specified
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) amount. The unit is undefined. Positive values move the focus closer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) to the camera, negative values towards infinity. This is a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) write-only control.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) ``V4L2_CID_FOCUS_AUTO (boolean)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) Enables continuous automatic focus adjustments. The effect of manual
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) focus adjustments while this feature is enabled is undefined,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) drivers should ignore such requests.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) ``V4L2_CID_AUTO_FOCUS_START (button)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) Starts single auto focus process. The effect of setting this control
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) when ``V4L2_CID_FOCUS_AUTO`` is set to ``TRUE`` (1) is undefined,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) drivers should ignore such requests.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) ``V4L2_CID_AUTO_FOCUS_STOP (button)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162) Aborts automatic focusing started with ``V4L2_CID_AUTO_FOCUS_START``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163) control. It is effective only when the continuous autofocus is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164) disabled, that is when ``V4L2_CID_FOCUS_AUTO`` control is set to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 165) ``FALSE`` (0).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 166)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 167) .. _v4l2-auto-focus-status:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 168)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 169) ``V4L2_CID_AUTO_FOCUS_STATUS (bitmask)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 170) The automatic focus status. This is a read-only control.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 171)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 172) Setting ``V4L2_LOCK_FOCUS`` lock bit of the ``V4L2_CID_3A_LOCK``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 173) control may stop updates of the ``V4L2_CID_AUTO_FOCUS_STATUS``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 174) control value.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 175)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 176) .. tabularcolumns:: |p{6.7cm}|p{10.8cm}|
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 177)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 178) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 179) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 180) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 181)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 182) * - ``V4L2_AUTO_FOCUS_STATUS_IDLE``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 183) - Automatic focus is not active.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 184) * - ``V4L2_AUTO_FOCUS_STATUS_BUSY``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 185) - Automatic focusing is in progress.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 186) * - ``V4L2_AUTO_FOCUS_STATUS_REACHED``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 187) - Focus has been reached.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 188) * - ``V4L2_AUTO_FOCUS_STATUS_FAILED``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 189) - Automatic focus has failed, the driver will not transition from
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 190) this state until another action is performed by an application.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 191)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 192)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 193)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 194) .. _v4l2-auto-focus-range:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 195)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 196) ``V4L2_CID_AUTO_FOCUS_RANGE``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 197) (enum)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 198)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 199) enum v4l2_auto_focus_range -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 200) Determines auto focus distance range for which lens may be adjusted.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 201)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 202) .. tabularcolumns:: |p{6.8cm}|p{10.7cm}|
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 203)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 204) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 205) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 206) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 207)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 208) * - ``V4L2_AUTO_FOCUS_RANGE_AUTO``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 209) - The camera automatically selects the focus range.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 210) * - ``V4L2_AUTO_FOCUS_RANGE_NORMAL``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 211) - Normal distance range, limited for best automatic focus
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 212) performance.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 213) * - ``V4L2_AUTO_FOCUS_RANGE_MACRO``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 214) - Macro (close-up) auto focus. The camera will use its minimum
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 215) possible distance for auto focus.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 216) * - ``V4L2_AUTO_FOCUS_RANGE_INFINITY``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 217) - The lens is set to focus on an object at infinite distance.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 218)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 219)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 220)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 221) ``V4L2_CID_ZOOM_ABSOLUTE (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 222) Specify the objective lens focal length as an absolute value. The
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 223) zoom unit is driver-specific and its value should be a positive
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 224) integer.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 225)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 226) ``V4L2_CID_ZOOM_RELATIVE (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 227) Specify the objective lens focal length relatively to the current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 228) value. Positive values move the zoom lens group towards the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 229) telephoto direction, negative values towards the wide-angle
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 230) direction. The zoom unit is driver-specific. This is a write-only
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 231) control.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 232)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 233) ``V4L2_CID_ZOOM_CONTINUOUS (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 234) Move the objective lens group at the specified speed until it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 235) reaches physical device limits or until an explicit request to stop
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 236) the movement. A positive value moves the zoom lens group towards the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 237) telephoto direction. A value of zero stops the zoom lens group
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 238) movement. A negative value moves the zoom lens group towards the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 239) wide-angle direction. The zoom speed unit is driver-specific.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 240)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 241) ``V4L2_CID_IRIS_ABSOLUTE (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 242) This control sets the camera's aperture to the specified value. The
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 243) unit is undefined. Larger values open the iris wider, smaller values
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 244) close it.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 245)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 246) ``V4L2_CID_IRIS_RELATIVE (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 247) This control modifies the camera's aperture by the specified amount.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 248) The unit is undefined. Positive values open the iris one step
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 249) further, negative values close it one step further. This is a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 250) write-only control.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 251)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 252) ``V4L2_CID_PRIVACY (boolean)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 253) Prevent video from being acquired by the camera. When this control
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 254) is set to ``TRUE`` (1), no image can be captured by the camera.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 255) Common means to enforce privacy are mechanical obturation of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 256) sensor and firmware image processing, but the device is not
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 257) restricted to these methods. Devices that implement the privacy
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 258) control must support read access and may support write access.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 259)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 260) ``V4L2_CID_BAND_STOP_FILTER (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 261) Switch the band-stop filter of a camera sensor on or off, or specify
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 262) its strength. Such band-stop filters can be used, for example, to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 263) filter out the fluorescent light component.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 264)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 265) .. _v4l2-auto-n-preset-white-balance:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 266)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 267) ``V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 268) (enum)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 269)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 270) enum v4l2_auto_n_preset_white_balance -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 271) Sets white balance to automatic, manual or a preset. The presets
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 272) determine color temperature of the light as a hint to the camera for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 273) white balance adjustments resulting in most accurate color
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 274) representation. The following white balance presets are listed in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 275) order of increasing color temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 276)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 277) .. tabularcolumns:: |p{7.2 cm}|p{10.3cm}|
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 278)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 279) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 280) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 281) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 282)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 283) * - ``V4L2_WHITE_BALANCE_MANUAL``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 284) - Manual white balance.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 285) * - ``V4L2_WHITE_BALANCE_AUTO``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 286) - Automatic white balance adjustments.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 287) * - ``V4L2_WHITE_BALANCE_INCANDESCENT``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 288) - White balance setting for incandescent (tungsten) lighting. It
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 289) generally cools down the colors and corresponds approximately to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 290) 2500...3500 K color temperature range.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 291) * - ``V4L2_WHITE_BALANCE_FLUORESCENT``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 292) - White balance preset for fluorescent lighting. It corresponds
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 293) approximately to 4000...5000 K color temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 294) * - ``V4L2_WHITE_BALANCE_FLUORESCENT_H``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 295) - With this setting the camera will compensate for fluorescent H
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 296) lighting.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 297) * - ``V4L2_WHITE_BALANCE_HORIZON``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 298) - White balance setting for horizon daylight. It corresponds
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 299) approximately to 5000 K color temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 300) * - ``V4L2_WHITE_BALANCE_DAYLIGHT``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 301) - White balance preset for daylight (with clear sky). It corresponds
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 302) approximately to 5000...6500 K color temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 303) * - ``V4L2_WHITE_BALANCE_FLASH``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 304) - With this setting the camera will compensate for the flash light.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 305) It slightly warms up the colors and corresponds roughly to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 306) 5000...5500 K color temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 307) * - ``V4L2_WHITE_BALANCE_CLOUDY``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 308) - White balance preset for moderately overcast sky. This option
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 309) corresponds approximately to 6500...8000 K color temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 310) range.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 311) * - ``V4L2_WHITE_BALANCE_SHADE``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 312) - White balance preset for shade or heavily overcast sky. It
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 313) corresponds approximately to 9000...10000 K color temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 314)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 315)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 316)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 317) .. _v4l2-wide-dynamic-range:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 318)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 319) ``V4L2_CID_WIDE_DYNAMIC_RANGE (boolean)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 320) Enables or disables the camera's wide dynamic range feature. This
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 321) feature allows to obtain clear images in situations where intensity
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 322) of the illumination varies significantly throughout the scene, i.e.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 323) there are simultaneously very dark and very bright areas. It is most
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 324) commonly realized in cameras by combining two subsequent frames with
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 325) different exposure times. [#f1]_
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 326)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 327) .. _v4l2-image-stabilization:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 328)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 329) ``V4L2_CID_IMAGE_STABILIZATION (boolean)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 330) Enables or disables image stabilization.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 331)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 332) ``V4L2_CID_ISO_SENSITIVITY (integer menu)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 333) Determines ISO equivalent of an image sensor indicating the sensor's
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 334) sensitivity to light. The numbers are expressed in arithmetic scale,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 335) as per :ref:`iso12232` standard, where doubling the sensor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 336) sensitivity is represented by doubling the numerical ISO value.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 337) Applications should interpret the values as standard ISO values
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 338) multiplied by 1000, e.g. control value 800 stands for ISO 0.8.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 339) Drivers will usually support only a subset of standard ISO values.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 340) The effect of setting this control while the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 341) ``V4L2_CID_ISO_SENSITIVITY_AUTO`` control is set to a value other
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 342) than ``V4L2_CID_ISO_SENSITIVITY_MANUAL`` is undefined, drivers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 343) should ignore such requests.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 344)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 345) .. _v4l2-iso-sensitivity-auto-type:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 346)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 347) ``V4L2_CID_ISO_SENSITIVITY_AUTO``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 348) (enum)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 349)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 350) enum v4l2_iso_sensitivity_type -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 351) Enables or disables automatic ISO sensitivity adjustments.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 352)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 353)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 354)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 355) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 356) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 357) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 358)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 359) * - ``V4L2_CID_ISO_SENSITIVITY_MANUAL``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 360) - Manual ISO sensitivity.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 361) * - ``V4L2_CID_ISO_SENSITIVITY_AUTO``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 362) - Automatic ISO sensitivity adjustments.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 363)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 364)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 365)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 366) .. _v4l2-scene-mode:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 367)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 368) ``V4L2_CID_SCENE_MODE``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 369) (enum)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 370)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 371) enum v4l2_scene_mode -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 372) This control allows to select scene programs as the camera automatic
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 373) modes optimized for common shooting scenes. Within these modes the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 374) camera determines best exposure, aperture, focusing, light metering,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 375) white balance and equivalent sensitivity. The controls of those
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 376) parameters are influenced by the scene mode control. An exact
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 377) behavior in each mode is subject to the camera specification.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 378)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 379) When the scene mode feature is not used, this control should be set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 380) to ``V4L2_SCENE_MODE_NONE`` to make sure the other possibly related
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 381) controls are accessible. The following scene programs are defined:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 382)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 383) .. raw:: latex
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 384)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 385) \small
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 386)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 387) .. tabularcolumns:: |p{5.9cm}|p{11.5cm}|
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 388)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 389) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 390) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 391) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 392)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 393) * - ``V4L2_SCENE_MODE_NONE``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 394) - The scene mode feature is disabled.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 395) * - ``V4L2_SCENE_MODE_BACKLIGHT``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 396) - Backlight. Compensates for dark shadows when light is coming from
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 397) behind a subject, also by automatically turning on the flash.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 398) * - ``V4L2_SCENE_MODE_BEACH_SNOW``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 399) - Beach and snow. This mode compensates for all-white or bright
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 400) scenes, which tend to look gray and low contrast, when camera's
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 401) automatic exposure is based on an average scene brightness. To
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 402) compensate, this mode automatically slightly overexposes the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 403) frames. The white balance may also be adjusted to compensate for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 404) the fact that reflected snow looks bluish rather than white.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 405) * - ``V4L2_SCENE_MODE_CANDLELIGHT``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 406) - Candle light. The camera generally raises the ISO sensitivity and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 407) lowers the shutter speed. This mode compensates for relatively
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 408) close subject in the scene. The flash is disabled in order to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 409) preserve the ambiance of the light.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 410) * - ``V4L2_SCENE_MODE_DAWN_DUSK``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 411) - Dawn and dusk. Preserves the colors seen in low natural light
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 412) before dusk and after down. The camera may turn off the flash, and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 413) automatically focus at infinity. It will usually boost saturation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 414) and lower the shutter speed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 415) * - ``V4L2_SCENE_MODE_FALL_COLORS``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 416) - Fall colors. Increases saturation and adjusts white balance for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 417) color enhancement. Pictures of autumn leaves get saturated reds
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 418) and yellows.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 419) * - ``V4L2_SCENE_MODE_FIREWORKS``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 420) - Fireworks. Long exposure times are used to capture the expanding
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 421) burst of light from a firework. The camera may invoke image
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 422) stabilization.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 423) * - ``V4L2_SCENE_MODE_LANDSCAPE``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 424) - Landscape. The camera may choose a small aperture to provide deep
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 425) depth of field and long exposure duration to help capture detail
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 426) in dim light conditions. The focus is fixed at infinity. Suitable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 427) for distant and wide scenery.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 428) * - ``V4L2_SCENE_MODE_NIGHT``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 429) - Night, also known as Night Landscape. Designed for low light
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 430) conditions, it preserves detail in the dark areas without blowing
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 431) out bright objects. The camera generally sets itself to a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 432) medium-to-high ISO sensitivity, with a relatively long exposure
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 433) time, and turns flash off. As such, there will be increased image
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 434) noise and the possibility of blurred image.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 435) * - ``V4L2_SCENE_MODE_PARTY_INDOOR``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 436) - Party and indoor. Designed to capture indoor scenes that are lit
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 437) by indoor background lighting as well as the flash. The camera
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 438) usually increases ISO sensitivity, and adjusts exposure for the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 439) low light conditions.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 440) * - ``V4L2_SCENE_MODE_PORTRAIT``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 441) - Portrait. The camera adjusts the aperture so that the depth of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 442) field is reduced, which helps to isolate the subject against a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 443) smooth background. Most cameras recognize the presence of faces in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 444) the scene and focus on them. The color hue is adjusted to enhance
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 445) skin tones. The intensity of the flash is often reduced.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 446) * - ``V4L2_SCENE_MODE_SPORTS``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 447) - Sports. Significantly increases ISO and uses a fast shutter speed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 448) to freeze motion of rapidly-moving subjects. Increased image noise
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 449) may be seen in this mode.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 450) * - ``V4L2_SCENE_MODE_SUNSET``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 451) - Sunset. Preserves deep hues seen in sunsets and sunrises. It bumps
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 452) up the saturation.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 453) * - ``V4L2_SCENE_MODE_TEXT``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 454) - Text. It applies extra contrast and sharpness, it is typically a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 455) black-and-white mode optimized for readability. Automatic focus
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 456) may be switched to close-up mode and this setting may also involve
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 457) some lens-distortion correction.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 458)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 459) .. raw:: latex
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 460)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 461) \normalsize
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 462)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 463)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 464) ``V4L2_CID_3A_LOCK (bitmask)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 465) This control locks or unlocks the automatic focus, exposure and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 466) white balance. The automatic adjustments can be paused independently
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 467) by setting the corresponding lock bit to 1. The camera then retains
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 468) the settings until the lock bit is cleared. The following lock bits
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 469) are defined:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 470)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 471) When a given algorithm is not enabled, drivers should ignore
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 472) requests to lock it and should return no error. An example might be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 473) an application setting bit ``V4L2_LOCK_WHITE_BALANCE`` when the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 474) ``V4L2_CID_AUTO_WHITE_BALANCE`` control is set to ``FALSE``. The
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 475) value of this control may be changed by exposure, white balance or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 476) focus controls.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 477)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 478)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 479)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 480) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 481) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 482) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 483)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 484) * - ``V4L2_LOCK_EXPOSURE``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 485) - Automatic exposure adjustments lock.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 486) * - ``V4L2_LOCK_WHITE_BALANCE``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 487) - Automatic white balance adjustments lock.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 488) * - ``V4L2_LOCK_FOCUS``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 489) - Automatic focus lock.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 490)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 491)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 492)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 493) ``V4L2_CID_PAN_SPEED (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 494) This control turns the camera horizontally at the specific speed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 495) The unit is undefined. A positive value moves the camera to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 496) right (clockwise when viewed from above), a negative value to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 497) left. A value of zero stops the motion if one is in progress and has
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 498) no effect otherwise.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 499)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 500) ``V4L2_CID_TILT_SPEED (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 501) This control turns the camera vertically at the specified speed. The
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 502) unit is undefined. A positive value moves the camera up, a negative
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 503) value down. A value of zero stops the motion if one is in progress
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 504) and has no effect otherwise.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 505)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 506) ``V4L2_CID_CAMERA_ORIENTATION (menu)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 507) This read-only control describes the camera orientation by reporting its
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 508) mounting position on the device where the camera is installed. The control
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 509) value is constant and not modifiable by software. This control is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 510) particularly meaningful for devices which have a well defined orientation,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 511) such as phones, laptops and portable devices since the control is expressed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 512) as a position relative to the device's intended usage orientation. For
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 513) example, a camera installed on the user-facing side of a phone, a tablet or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 514) a laptop device is said to be have ``V4L2_CAMERA_ORIENTATION_FRONT``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 515) orientation, while a camera installed on the opposite side of the front one
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 516) is said to be have ``V4L2_CAMERA_ORIENTATION_BACK`` orientation. Camera
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 517) sensors not directly attached to the device, or attached in a way that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 518) allows them to move freely, such as webcams and digital cameras, are said to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 519) have the ``V4L2_CAMERA_ORIENTATION_EXTERNAL`` orientation.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 520)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 521)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 522)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 523) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 524) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 525) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 526)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 527) * - ``V4L2_CAMERA_ORIENTATION_FRONT``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 528) - The camera is oriented towards the user facing side of the device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 529) * - ``V4L2_CAMERA_ORIENTATION_BACK``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 530) - The camera is oriented towards the back facing side of the device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 531) * - ``V4L2_CAMERA_ORIENTATION_EXTERNAL``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 532) - The camera is not directly attached to the device and is freely movable.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 533)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 534)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 535)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 536) ``V4L2_CID_CAMERA_SENSOR_ROTATION (integer)``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 537) This read-only control describes the rotation correction in degrees in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 538) counter-clockwise direction to be applied to the captured images once
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 539) captured to memory to compensate for the camera sensor mounting rotation.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 540)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 541) For a precise definition of the sensor mounting rotation refer to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 542) extensive description of the 'rotation' properties in the device tree
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 543) bindings file 'video-interfaces.txt'.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 544)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 545) A few examples are below reported, using a shark swimming from left to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 546) right in front of the user as the example scene to capture. ::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 547)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 548) 0 X-axis
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 549) 0 +------------------------------------->
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 550) !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 551) !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 552) !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 553) ! |\____)\___
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 554) ! ) _____ __`<
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 555) ! |/ )/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 556) !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 557) !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 558) !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 559) V
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 560) Y-axis
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 561)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 562) Example one - Webcam
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 563)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 564) Assuming you can bring your laptop with you while swimming with sharks,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 565) the camera module of the laptop is installed on the user facing part of a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 566) laptop screen casing, and is typically used for video calls. The captured
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 567) images are meant to be displayed in landscape mode (width > height) on the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 568) laptop screen.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 569)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 570) The camera is typically mounted upside-down to compensate the lens optical
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 571) inversion effect. In this case the value of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 572) V4L2_CID_CAMERA_SENSOR_ROTATION control is 0, no rotation is required to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 573) display images correctly to the user.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 574)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 575) If the camera sensor is not mounted upside-down it is required to compensate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 576) the lens optical inversion effect and the value of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 577) V4L2_CID_CAMERA_SENSOR_ROTATION control is 180 degrees, as images will
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 578) result rotated when captured to memory. ::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 579)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 580) +--------------------------------------+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 581) ! !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 582) ! !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 583) ! !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 584) ! __/(_____/| !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 585) ! >.___ ____ ( !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 586) ! \( \| !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 587) ! !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 588) ! !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 589) ! !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 590) +--------------------------------------+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 591)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 592) A software rotation correction of 180 degrees has to be applied to correctly
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 593) display the image on the user screen. ::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 594)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 595) +--------------------------------------+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 596) ! !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 597) ! !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 598) ! !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 599) ! |\____)\___ !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 600) ! ) _____ __`< !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 601) ! |/ )/ !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 602) ! !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 603) ! !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 604) ! !
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 605) +--------------------------------------+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 606)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 607) Example two - Phone camera
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 608)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 609) It is more handy to go and swim with sharks with only your mobile phone
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 610) with you and take pictures with the camera that is installed on the back
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 611) side of the device, facing away from the user. The captured images are meant
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 612) to be displayed in portrait mode (height > width) to match the device screen
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 613) orientation and the device usage orientation used when taking the picture.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 614)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 615) The camera sensor is typically mounted with its pixel array longer side
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 616) aligned to the device longer side, upside-down mounted to compensate for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 617) the lens optical inversion effect.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 618)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 619) The images once captured to memory will be rotated and the value of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 620) V4L2_CID_CAMERA_SENSOR_ROTATION will report a 90 degree rotation. ::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 621)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 622)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 623) +-------------------------------------+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 624) | _ _ |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 625) | \ / |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 626) | | | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 627) | | | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 628) | | > |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 629) | < | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 630) | | | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 631) | . |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 632) | V |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 633) +-------------------------------------+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 634)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 635) A correction of 90 degrees in counter-clockwise direction has to be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 636) applied to correctly display the image in portrait mode on the device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 637) screen. ::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 638)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 639) +--------------------+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 640) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 641) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 642) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 643) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 644) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 645) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 646) | |\____)\___ |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 647) | ) _____ __`< |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 648) | |/ )/ |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 649) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 650) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 651) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 652) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 653) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 654) +--------------------+
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 655)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 656)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 657) .. [#f1]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 658) This control may be changed to a menu control in the future, if more
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 659) options are required.