Orange Pi5 kernel

Deprecated Linux kernel 5.10.110 for OrangePi 5/5B/5+ boards

3 Commits   0 Branches   0 Tags
^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.