sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget)}(hhh]h)}(h(enum)h]h(enum)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjubj)}(hXenum v4l2_exposure_auto_type - Enables automatic adjustments of the exposure time and/or iris aperture. The effect of manual changes of the exposure time or iris aperture while these features are enabled is undefined, drivers should ignore such requests. Possible values are: h](j#)}(henum v4l2_exposure_auto_type -h]henum v4l2_exposure_auto_type -}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j"hhhK"hjubj>)}(hhh]h)}(hEnables automatic adjustments of the exposure time and/or iris aperture. The effect of manual changes of the exposure time or iris aperture while these features are enabled is undefined, drivers should ignore such requests. Possible values are:h]hEnables automatic adjustments of the exposure time and/or iris aperture. The effect of manual changes of the exposure time or iris aperture while these features are enabled is undefined, drivers should ignore such requests. Possible values are:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhK"hjhhubeh}(h]jah ]h"]v4l2-exposure-auto-typeah$]h&]uh1jhjhhhhhNexpect_referenced_by_name}jjsexpect_referenced_by_id}jjsubhtabular_col_spec)}(hhh]h}(h]h ]h"]h$]h&]spec|p{7.1cm}|p{10.4cm}|uh1j hhhK$hjhhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjubj#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(h``V4L2_EXPOSURE_AUTO``h]j))}(hjIh]hV4L2_EXPOSURE_AUTO}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjGubah}(h]h ]h"]h$]h&]uh1hhhhK*hjDubah}(h]h ]h"]h$]h&]uh1jBhj?ubjC)}(hhh]h)}(h1Automatic exposure time, automatic iris aperture.h]h1Automatic exposure time, automatic iris aperture.}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hjdubah}(h]h ]h"]h$]h&]uh1jBhj?ubeh}(h]h ]h"]h$]h&]uh1j=hj:ubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_EXPOSURE_MANUAL``h]j))}(hjh]hV4L2_EXPOSURE_MANUAL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhK,hjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(h"Manual exposure time, manual iris.h]h"Manual exposure time, manual iris.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hj:ubj>)}(hhh](jC)}(hhh]h)}(h"``V4L2_EXPOSURE_SHUTTER_PRIORITY``h]j))}(hjh]hV4L2_EXPOSURE_SHUTTER_PRIORITY}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhK.hjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(h Manual exposure time, auto iris.h]h Manual exposure time, auto iris.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hj:ubj>)}(hhh](jC)}(hhh]h)}(h#``V4L2_EXPOSURE_APERTURE_PRIORITY``h]j))}(hj h]hV4L2_EXPOSURE_APERTURE_PRIORITY}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhK0hjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(h Auto exposure time, manual iris.h]h Auto exposure time, manual iris.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hj$ubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hj:ubeh}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjhhhNhNubj)}(hhh](j)}(hX(``V4L2_CID_EXPOSURE_ABSOLUTE (integer)`` Determines the exposure time of the camera sensor. The exposure time is limited by the frame interval. Drivers should interpret the values as 100 µs units, where the value 1 stands for 1/10000th of a second, 10000 for 1 second and 100000 for 10 seconds. h](j#)}(h(``V4L2_CID_EXPOSURE_ABSOLUTE (integer)``h]j))}(hj]h]h$V4L2_CID_EXPOSURE_ABSOLUTE (integer)}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj[ubah}(h]h ]h"]h$]h&]uh1j"hhhK9hjWubj>)}(hhh]h)}(hDetermines the exposure time of the camera sensor. The exposure time is limited by the frame interval. Drivers should interpret the values as 100 µs units, where the value 1 stands for 1/10000th of a second, 10000 for 1 second and 100000 for 10 seconds.h]hDetermines the exposure time of the camera sensor. The exposure time is limited by the frame interval. Drivers should interpret the values as 100 µs units, where the value 1 stands for 1/10000th of a second, 10000 for 1 second and 100000 for 10 seconds.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjrubah}(h]h ]h"]h$]h&]uh1j=hjWubeh}(h]h ]h"]h$]h&]uh1jhhhK9hjTubj)}(hX``V4L2_CID_EXPOSURE_AUTO_PRIORITY (boolean)`` When ``V4L2_CID_EXPOSURE_AUTO`` is set to ``AUTO`` or ``APERTURE_PRIORITY``, this control determines if the device may dynamically vary the frame rate. By default this feature is disabled (0) and the frame rate must remain constant. h](j#)}(h-``V4L2_CID_EXPOSURE_AUTO_PRIORITY (boolean)``h]j))}(hjh]h)V4L2_CID_EXPOSURE_AUTO_PRIORITY (boolean)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhK?hjubj>)}(hhh]h)}(hWhen ``V4L2_CID_EXPOSURE_AUTO`` is set to ``AUTO`` or ``APERTURE_PRIORITY``, this control determines if the device may dynamically vary the frame rate. By default this feature is disabled (0) and the frame rate must remain constant.h](hWhen }(hjhhhNhNubj))}(h``V4L2_CID_EXPOSURE_AUTO``h]hV4L2_CID_EXPOSURE_AUTO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh is set to }(hjhhhNhNubj))}(h``AUTO``h]hAUTO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh or }(hjhhhNhNubj))}(h``APERTURE_PRIORITY``h]hAPERTURE_PRIORITY}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh, this control determines if the device may dynamically vary the frame rate. By default this feature is disabled (0) and the frame rate must remain constant.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK)}(hhh](h)}(hX-Determines the automatic exposure compensation, it is effective only when ``V4L2_CID_EXPOSURE_AUTO`` control is set to ``AUTO``, ``SHUTTER_PRIORITY`` or ``APERTURE_PRIORITY``. It is expressed in terms of EV, drivers should interpret the values as 0.001 EV units, where the value 1000 stands for +1 EV.h](hJDetermines the automatic exposure compensation, it is effective only when }(hjhhhNhNubj))}(h``V4L2_CID_EXPOSURE_AUTO``h]hV4L2_CID_EXPOSURE_AUTO}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh control is set to }(hjhhhNhNubj))}(h``AUTO``h]hAUTO}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh, }(hjhhhNhNubj))}(h``SHUTTER_PRIORITY``h]hSHUTTER_PRIORITY}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh or }(hjhhhNhNubj))}(h``APERTURE_PRIORITY``h]hAPERTURE_PRIORITY}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh. It is expressed in terms of EV, drivers should interpret the values as 0.001 EV units, where the value 1000 stands for +1 EV.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKBhjubh)}(hIncreasing the exposure compensation value is equivalent to decreasing the exposure value (EV) and will increase the amount of light at the image sensor. The camera performs the exposure compensation by adjusting absolute exposure time and/or aperture.h]hIncreasing the exposure compensation value is equivalent to decreasing the exposure value (EV) and will increase the amount of light at the image sensor. The camera performs the exposure compensation by adjusting absolute exposure time and/or aperture.}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKHhjubeh}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhKKhjThhubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubh)}(h.. _v4l2-exposure-metering:h]h}(h]h ]h"]h$]h&]hԌv4l2-exposure-meteringuh1hhKMhjhhhhubj)}(hhh](j)}(h&``V4L2_CID_EXPOSURE_METERING`` (enum) h](j#)}(h``V4L2_CID_EXPOSURE_METERING``h]j))}(hjh]hV4L2_CID_EXPOSURE_METERING}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhKPhjubj>)}(hhh]h)}(h(enum)h]h(enum)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKPhjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhKPhjubj)}(henum v4l2_exposure_metering - Determines how the camera measures the amount of light available for the frame exposure. Possible values are: h](j#)}(henum v4l2_exposure_metering -h]henum v4l2_exposure_metering -}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j"hhhKThjubj>)}(hhh]h)}(hmDetermines how the camera measures the amount of light available for the frame exposure. Possible values are:h]hmDetermines how the camera measures the amount of light available for the frame exposure. Possible values are:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKShjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhKThjhhubeh}(h]jah ]h"]v4l2-exposure-meteringah$]h&]uh1jhjhhhhhNj}j jsj }jjsubj )}(hhh]h}(h]h ]h"]h$]h&]j|p{8.7cm}|p{8.7cm}|uh1j hhhKVhjhhubj)}(hhh]j)}(hhh](j#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjubj#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjubj9)}(hhh](j>)}(hhh](jC)}(hhh]h)}(h"``V4L2_EXPOSURE_METERING_AVERAGE``h]j))}(hj>h]hV4L2_EXPOSURE_METERING_AVERAGE}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj<ubah}(h]h ]h"]h$]h&]uh1hhhhK\hj9ubah}(h]h ]h"]h$]h&]uh1jBhj6ubjC)}(hhh]h)}(hUse the light information coming from the entire frame and average giving no weighting to any particular portion of the metered area.h]hUse the light information coming from the entire frame and average giving no weighting to any particular portion of the metered area.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK]hjYubah}(h]h ]h"]h$]h&]uh1jBhj6ubeh}(h]h ]h"]h$]h&]uh1j=hj3ubj>)}(hhh](jC)}(hhh]h)}(h*``V4L2_EXPOSURE_METERING_CENTER_WEIGHTED``h]j))}(hj~h]h&V4L2_EXPOSURE_METERING_CENTER_WEIGHTED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj|ubah}(h]h ]h"]h$]h&]uh1hhhhK_hjyubah}(h]h ]h"]h$]h&]uh1jBhjvubjC)}(hhh]h)}(hmAverage the light information coming from the entire frame giving priority to the center of the metered area.h]hmAverage the light information coming from the entire frame giving priority to the center of the metered area.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK`hjubah}(h]h ]h"]h$]h&]uh1jBhjvubeh}(h]h ]h"]h$]h&]uh1j=hj3ubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_EXPOSURE_METERING_SPOT``h]j))}(hjh]hV4L2_EXPOSURE_METERING_SPOT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhKbhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(h8Measure only very small area at the center of the frame.h]h8Measure only very small area at the center of the frame.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hj3ubj>)}(hhh](jC)}(hhh]h)}(h!``V4L2_EXPOSURE_METERING_MATRIX``h]j))}(hjh]hV4L2_EXPOSURE_METERING_MATRIX}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhKdhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hA multi-zone metering. The light intensity is measured in several points of the frame and the results are combined. The algorithm of the zones selection and their significance in calculating the final value is device dependent.h]hA multi-zone metering. The light intensity is measured in several points of the frame and the results are combined. The algorithm of the zones selection and their significance in calculating the final value is device dependent.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKehjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hj3ubeh}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjhhhNhNubj)}(hhh](j)}(hX5``V4L2_CID_PAN_RELATIVE (integer)`` This control turns the camera horizontally by the specified amount. The unit is undefined. A positive value moves the camera to the right (clockwise when viewed from above), a negative value to the left. A value of zero does not cause motion. This is a write-only control. h](j#)}(h#``V4L2_CID_PAN_RELATIVE (integer)``h]j))}(hjRh]hV4L2_CID_PAN_RELATIVE (integer)}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjPubah}(h]h ]h"]h$]h&]uh1j"hhhKqhjLubj>)}(hhh]h)}(hXThis control turns the camera horizontally by the specified amount. The unit is undefined. A positive value moves the camera to the right (clockwise when viewed from above), a negative value to the left. A value of zero does not cause motion. This is a write-only control.h]hXThis control turns the camera horizontally by the specified amount. The unit is undefined. A positive value moves the camera to the right (clockwise when viewed from above), a negative value to the left. A value of zero does not cause motion. This is a write-only control.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKmhjgubah}(h]h ]h"]h$]h&]uh1j=hjLubeh}(h]h ]h"]h$]h&]uh1jhhhKqhjIubj)}(hX``V4L2_CID_TILT_RELATIVE (integer)`` This control turns the camera vertically by the specified amount. The unit is undefined. A positive value moves the camera up, a negative value down. A value of zero does not cause motion. This is a write-only control. h](j#)}(h$``V4L2_CID_TILT_RELATIVE (integer)``h]j))}(hjh]h V4L2_CID_TILT_RELATIVE (integer)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhKwhjubj>)}(hhh]h)}(hThis control turns the camera vertically by the specified amount. The unit is undefined. A positive value moves the camera up, a negative value down. A value of zero does not cause motion. This is a write-only control.h]hThis control turns the camera vertically by the specified amount. The unit is undefined. A positive value moves the camera up, a negative value down. A value of zero does not cause motion. This is a write-only control.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKthjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhKwhjIhhubj)}(hq``V4L2_CID_PAN_RESET (button)`` When this control is set, the camera moves horizontally to the default position. h](j#)}(h``V4L2_CID_PAN_RESET (button)``h]j))}(hjh]hV4L2_CID_PAN_RESET (button)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhK{hjubj>)}(hhh]h)}(hPWhen this control is set, the camera moves horizontally to the default position.h]hPWhen this control is set, the camera moves horizontally to the default position.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKzhjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhK{hjIhhubj)}(hp``V4L2_CID_TILT_RESET (button)`` When this control is set, the camera moves vertically to the default position. h](j#)}(h ``V4L2_CID_TILT_RESET (button)``h]j))}(hjh]hV4L2_CID_TILT_RESET (button)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhKhjubj>)}(hhh]h)}(hNWhen this control is set, the camera moves vertically to the default position.h]hNWhen this control is set, the camera moves vertically to the default position.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK~hjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjIhhubj)}(hXM``V4L2_CID_PAN_ABSOLUTE (integer)`` This control turns the camera horizontally to the specified position. Positive values move the camera to the right (clockwise when viewed from above), negative values to the left. Drivers should interpret the values as arc seconds, with valid values between -180 * 3600 and +180 * 3600 inclusive. h](j#)}(h#``V4L2_CID_PAN_ABSOLUTE (integer)``h]j))}(hj2h]hV4L2_CID_PAN_ABSOLUTE (integer)}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj0ubah}(h]h ]h"]h$]h&]uh1j"hhhKhj,ubj>)}(hhh]h)}(hX(This control turns the camera horizontally to the specified position. Positive values move the camera to the right (clockwise when viewed from above), negative values to the left. Drivers should interpret the values as arc seconds, with valid values between -180 * 3600 and +180 * 3600 inclusive.h]hX(This control turns the camera horizontally to the specified position. Positive values move the camera to the right (clockwise when viewed from above), negative values to the left. Drivers should interpret the values as arc seconds, with valid values between -180 * 3600 and +180 * 3600 inclusive.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjGubah}(h]h ]h"]h$]h&]uh1j=hj,ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjIhhubj)}(hX``V4L2_CID_TILT_ABSOLUTE (integer)`` This control turns the camera vertically to the specified position. Positive values move the camera up, negative values down. Drivers should interpret the values as arc seconds, with valid values between -180 * 3600 and +180 * 3600 inclusive. h](j#)}(h$``V4L2_CID_TILT_ABSOLUTE (integer)``h]j))}(hjjh]h V4L2_CID_TILT_ABSOLUTE (integer)}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjhubah}(h]h ]h"]h$]h&]uh1j"hhhKhjdubj>)}(hhh]h)}(hThis control turns the camera vertically to the specified position. Positive values move the camera up, negative values down. Drivers should interpret the values as arc seconds, with valid values between -180 * 3600 and +180 * 3600 inclusive.h]hThis control turns the camera vertically to the specified position. Positive values move the camera up, negative values down. Drivers should interpret the values as arc seconds, with valid values between -180 * 3600 and +180 * 3600 inclusive.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j=hjdubeh}(h]h ]h"]h$]h&]uh1jhhhKhjIhhubj)}(h``V4L2_CID_FOCUS_ABSOLUTE (integer)`` This control sets the focal point of the camera to the specified position. The unit is undefined. Positive values set the focus closer to the camera, negative values towards infinity. h](j#)}(h%``V4L2_CID_FOCUS_ABSOLUTE (integer)``h]j))}(hjh]h!V4L2_CID_FOCUS_ABSOLUTE (integer)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhKhjubj>)}(hhh]h)}(hThis control sets the focal point of the camera to the specified position. The unit is undefined. Positive values set the focus closer to the camera, negative values towards infinity.h]hThis control sets the focal point of the camera to the specified position. The unit is undefined. Positive values set the focus closer to the camera, negative values towards infinity.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjIhhubj)}(h``V4L2_CID_FOCUS_RELATIVE (integer)`` This control moves the focal point of the camera by the specified amount. The unit is undefined. Positive values move the focus closer to the camera, negative values towards infinity. This is a write-only control. h](j#)}(h%``V4L2_CID_FOCUS_RELATIVE (integer)``h]j))}(hjh]h!V4L2_CID_FOCUS_RELATIVE (integer)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhKhjubj>)}(hhh]h)}(hThis control moves the focal point of the camera by the specified amount. The unit is undefined. Positive values move the focus closer to the camera, negative values towards infinity. This is a write-only control.h]hThis control moves the focal point of the camera by the specified amount. The unit is undefined. Positive values move the focus closer to the camera, negative values towards infinity. This is a write-only control.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjIhhubj)}(h``V4L2_CID_FOCUS_AUTO (boolean)`` Enables continuous automatic focus adjustments. The effect of manual focus adjustments while this feature is enabled is undefined, drivers should ignore such requests. h](j#)}(h!``V4L2_CID_FOCUS_AUTO (boolean)``h]j))}(hjh]hV4L2_CID_FOCUS_AUTO (boolean)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhKhj ubj>)}(hhh]h)}(hEnables continuous automatic focus adjustments. The effect of manual focus adjustments while this feature is enabled is undefined, drivers should ignore such requests.h]hEnables continuous automatic focus adjustments. The effect of manual focus adjustments while this feature is enabled is undefined, drivers should ignore such requests.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj'ubah}(h]h ]h"]h$]h&]uh1j=hj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjIhhubj)}(h``V4L2_CID_AUTO_FOCUS_START (button)`` Starts single auto focus process. The effect of setting this control when ``V4L2_CID_FOCUS_AUTO`` is set to ``TRUE`` (1) is undefined, drivers should ignore such requests. h](j#)}(h&``V4L2_CID_AUTO_FOCUS_START (button)``h]j))}(hjJh]h"V4L2_CID_AUTO_FOCUS_START (button)}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjHubah}(h]h ]h"]h$]h&]uh1j"hhhKhjDubj>)}(hhh]h)}(hStarts single auto focus process. The effect of setting this control when ``V4L2_CID_FOCUS_AUTO`` is set to ``TRUE`` (1) is undefined, drivers should ignore such requests.h](hJStarts single auto focus process. The effect of setting this control when }(hjbhhhNhNubj))}(h``V4L2_CID_FOCUS_AUTO``h]hV4L2_CID_FOCUS_AUTO}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjbubh is set to }(hjbhhhNhNubj))}(h``TRUE``h]hTRUE}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjbubh7 (1) is undefined, drivers should ignore such requests.}(hjbhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj_ubah}(h]h ]h"]h$]h&]uh1j=hjDubeh}(h]h ]h"]h$]h&]uh1jhhhKhjIhhubj)}(h``V4L2_CID_AUTO_FOCUS_STOP (button)`` Aborts automatic focusing started with ``V4L2_CID_AUTO_FOCUS_START`` control. It is effective only when the continuous autofocus is disabled, that is when ``V4L2_CID_FOCUS_AUTO`` control is set to ``FALSE`` (0). h](j#)}(h%``V4L2_CID_AUTO_FOCUS_STOP (button)``h]j))}(hjh]h!V4L2_CID_AUTO_FOCUS_STOP (button)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhKhjubj>)}(hhh]h)}(hAborts automatic focusing started with ``V4L2_CID_AUTO_FOCUS_START`` control. It is effective only when the continuous autofocus is disabled, that is when ``V4L2_CID_FOCUS_AUTO`` control is set to ``FALSE`` (0).h](h'Aborts automatic focusing started with }(hjhhhNhNubj))}(h``V4L2_CID_AUTO_FOCUS_START``h]hV4L2_CID_AUTO_FOCUS_START}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubhW control. It is effective only when the continuous autofocus is disabled, that is when }(hjhhhNhNubj))}(h``V4L2_CID_FOCUS_AUTO``h]hV4L2_CID_FOCUS_AUTO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh control is set to }(hjhhhNhNubj))}(h ``FALSE``h]hFALSE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh (0).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjIhhubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubh)}(h.. _v4l2-auto-focus-status:h]h}(h]h ]h"]h$]h&]hԌv4l2-auto-focus-statusuh1hhKhjhhhhubj)}(hhh]j)}(h``V4L2_CID_AUTO_FOCUS_STATUS (bitmask)`` The automatic focus status. This is a read-only control. Setting ``V4L2_LOCK_FOCUS`` lock bit of the ``V4L2_CID_3A_LOCK`` control may stop updates of the ``V4L2_CID_AUTO_FOCUS_STATUS`` control value. h](j#)}(h(``V4L2_CID_AUTO_FOCUS_STATUS (bitmask)``h]j))}(hj( h]h$V4L2_CID_AUTO_FOCUS_STATUS (bitmask)}(hj* hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj& ubah}(h]h ]h"]h$]h&]uh1j"hhhKhj" ubj>)}(hhh](h)}(h8The automatic focus status. This is a read-only control.h]h8The automatic focus status. This is a read-only control.}(hj@ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj= ubh)}(hSetting ``V4L2_LOCK_FOCUS`` lock bit of the ``V4L2_CID_3A_LOCK`` control may stop updates of the ``V4L2_CID_AUTO_FOCUS_STATUS`` control value.h](hSetting }(hjN hhhNhNubj))}(h``V4L2_LOCK_FOCUS``h]hV4L2_LOCK_FOCUS}(hjV hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjN ubh lock bit of the }(hjN hhhNhNubj))}(h``V4L2_CID_3A_LOCK``h]hV4L2_CID_3A_LOCK}(hjh hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjN ubh! control may stop updates of the }(hjN hhhNhNubj))}(h``V4L2_CID_AUTO_FOCUS_STATUS``h]hV4L2_CID_AUTO_FOCUS_STATUS}(hjz hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjN ubh control value.}(hjN hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj= ubeh}(h]h ]h"]h$]h&]uh1j=hj" ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj ubah}(h]j ah ]h"]v4l2-auto-focus-statusah$]h&]uh1jhjhhhhhNj}j j sj }j j subj )}(hhh]h}(h]h ]h"]h$]h&]j|p{6.8cm}|p{10.7cm}|uh1j hhhKhjhhubj)}(hhh]j)}(hhh](j#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hj ubj#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hj ubj9)}(hhh](j>)}(hhh](jC)}(hhh]h)}(h``V4L2_AUTO_FOCUS_STATUS_IDLE``h]j))}(hj h]hV4L2_AUTO_FOCUS_STATUS_IDLE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jBhj ubjC)}(hhh]h)}(hAutomatic focus is not active.h]hAutomatic focus is not active.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jBhj ubeh}(h]h ]h"]h$]h&]uh1j=hj ubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_AUTO_FOCUS_STATUS_BUSY``h]j))}(hj h]hV4L2_AUTO_FOCUS_STATUS_BUSY}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jBhj ubjC)}(hhh]h)}(h"Automatic focusing is in progress.h]h"Automatic focusing is in progress.}(hj4 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj1 ubah}(h]h ]h"]h$]h&]uh1jBhj ubeh}(h]h ]h"]h$]h&]uh1j=hj ubj>)}(hhh](jC)}(hhh]h)}(h"``V4L2_AUTO_FOCUS_STATUS_REACHED``h]j))}(hjV h]hV4L2_AUTO_FOCUS_STATUS_REACHED}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjT ubah}(h]h ]h"]h$]h&]uh1hhhhKhjQ ubah}(h]h ]h"]h$]h&]uh1jBhjN ubjC)}(hhh]h)}(hFocus has been reached.h]hFocus has been reached.}(hjt hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjq ubah}(h]h ]h"]h$]h&]uh1jBhjN ubeh}(h]h ]h"]h$]h&]uh1j=hj ubj>)}(hhh](jC)}(hhh]h)}(h!``V4L2_AUTO_FOCUS_STATUS_FAILED``h]j))}(hj h]hV4L2_AUTO_FOCUS_STATUS_FAILED}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jBhj ubjC)}(hhh]h)}(hAutomatic focus has failed, the driver will not transition from this state until another action is performed by an application.h]hAutomatic focus has failed, the driver will not transition from this state until another action is performed by an application.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jBhj ubeh}(h]h ]h"]h$]h&]uh1j=hj ubeh}(h]h ]h"]h$]h&]uh1j8hj ubeh}(h]h ]h"]h$]h&]colsKuh1jhj ubah}(h]h ]h"]h$]h&]uh1jhjhhhNhNubh)}(h.. _v4l2-auto-focus-range:h]h}(h]h ]h"]h$]h&]hԌv4l2-auto-focus-rangeuh1hhKhjhhhhubj)}(hhh](j)}(h%``V4L2_CID_AUTO_FOCUS_RANGE`` (enum) h](j#)}(h``V4L2_CID_AUTO_FOCUS_RANGE``h]j))}(hj h]hV4L2_CID_AUTO_FOCUS_RANGE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1j"hhhKhj ubj>)}(hhh]h)}(h(enum)h]h(enum)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j=hj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj ubj)}(hbenum v4l2_auto_focus_range - Determines auto focus distance range for which lens may be adjusted. h](j#)}(henum v4l2_auto_focus_range -h]henum v4l2_auto_focus_range -}(hj+ hhhNhNubah}(h]h ]h"]h$]h&]uh1j"hhhKhj' ubj>)}(hhh]h)}(hDDetermines auto focus distance range for which lens may be adjusted.h]hDDetermines auto focus distance range for which lens may be adjusted.}(hj< hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj9 ubah}(h]h ]h"]h$]h&]uh1j=hj' ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj hhubeh}(h]j ah ]h"]v4l2-auto-focus-rangeah$]h&]uh1jhjhhhhhNj}jZ j sj }j j subj )}(hhh]h}(h]h ]h"]h$]h&]j|p{6.9cm}|p{10.6cm}|uh1j hhhKhjhhubj)}(hhh]j)}(hhh](j#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjl ubj#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjl ubj9)}(hhh](j>)}(hhh](jC)}(hhh]h)}(h``V4L2_AUTO_FOCUS_RANGE_AUTO``h]j))}(hj h]hV4L2_AUTO_FOCUS_RANGE_AUTO}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jBhj ubjC)}(hhh]h)}(h1The camera automatically selects the focus range.h]h1The camera automatically selects the focus range.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jBhj ubeh}(h]h ]h"]h$]h&]uh1j=hj ubj>)}(hhh](jC)}(hhh]h)}(h ``V4L2_AUTO_FOCUS_RANGE_NORMAL``h]j))}(hj h]hV4L2_AUTO_FOCUS_RANGE_NORMAL}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jBhj ubjC)}(hhh]h)}(hDNormal distance range, limited for best automatic focus performance.h]hDNormal distance range, limited for best automatic focus performance.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jBhj ubeh}(h]h ]h"]h$]h&]uh1j=hj ubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_AUTO_FOCUS_RANGE_MACRO``h]j))}(hj h]hV4L2_AUTO_FOCUS_RANGE_MACRO}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jBhj ubjC)}(hhh]h)}(h^Macro (close-up) auto focus. The camera will use its minimum possible distance for auto focus.h]h^Macro (close-up) auto focus. The camera will use its minimum possible distance for auto focus.}(hj, hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj) ubah}(h]h ]h"]h$]h&]uh1jBhj ubeh}(h]h ]h"]h$]h&]uh1j=hj ubj>)}(hhh](jC)}(hhh]h)}(h"``V4L2_AUTO_FOCUS_RANGE_INFINITY``h]j))}(hjN h]hV4L2_AUTO_FOCUS_RANGE_INFINITY}(hjP hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjL ubah}(h]h ]h"]h$]h&]uh1hhhhKhjI ubah}(h]h ]h"]h$]h&]uh1jBhjF ubjC)}(hhh]h)}(h;The lens is set to focus on an object at infinite distance.h]h;The lens is set to focus on an object at infinite distance.}(hjl hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhji ubah}(h]h ]h"]h$]h&]uh1jBhjF ubeh}(h]h ]h"]h$]h&]uh1j=hj ubeh}(h]h ]h"]h$]h&]uh1j8hjl ubeh}(h]h ]h"]h$]h&]colsKuh1jhji ubah}(h]h ]h"]h$]h&]uh1jhjhhhNhNubj)}(hhh](j)}(h``V4L2_CID_ZOOM_ABSOLUTE (integer)`` Specify the objective lens focal length as an absolute value. The zoom unit is driver-specific and its value should be a positive integer. h](j#)}(h$``V4L2_CID_ZOOM_ABSOLUTE (integer)``h]j))}(hj h]h V4L2_CID_ZOOM_ABSOLUTE (integer)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1j"hhhKhj ubj>)}(hhh]h)}(hSpecify the objective lens focal length as an absolute value. The zoom unit is driver-specific and its value should be a positive integer.h]hSpecify the objective lens focal length as an absolute value. The zoom unit is driver-specific and its value should be a positive integer.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j=hj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj ubj)}(hX*``V4L2_CID_ZOOM_RELATIVE (integer)`` Specify the objective lens focal length relatively to the current value. Positive values move the zoom lens group towards the telephoto direction, negative values towards the wide-angle direction. The zoom unit is driver-specific. This is a write-only control. h](j#)}(h$``V4L2_CID_ZOOM_RELATIVE (integer)``h]j))}(hj h]h V4L2_CID_ZOOM_RELATIVE (integer)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1j"hhhKhj ubj>)}(hhh]h)}(hXSpecify the objective lens focal length relatively to the current value. Positive values move the zoom lens group towards the telephoto direction, negative values towards the wide-angle direction. The zoom unit is driver-specific. This is a write-only control.h]hXSpecify the objective lens focal length relatively to the current value. Positive values move the zoom lens group towards the telephoto direction, negative values towards the wide-angle direction. The zoom unit is driver-specific. This is a write-only control.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j=hj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj hhubj)}(hX``V4L2_CID_ZOOM_CONTINUOUS (integer)`` Move the objective lens group at the specified speed until it reaches physical device limits or until an explicit request to stop the movement. A positive value moves the zoom lens group towards the telephoto direction. A value of zero stops the zoom lens group movement. A negative value moves the zoom lens group towards the wide-angle direction. The zoom speed unit is driver-specific. h](j#)}(h&``V4L2_CID_ZOOM_CONTINUOUS (integer)``h]j))}(hj h]h"V4L2_CID_ZOOM_CONTINUOUS (integer)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1j"hhhKhj ubj>)}(hhh]h)}(hXMove the objective lens group at the specified speed until it reaches physical device limits or until an explicit request to stop the movement. A positive value moves the zoom lens group towards the telephoto direction. A value of zero stops the zoom lens group movement. A negative value moves the zoom lens group towards the wide-angle direction. The zoom speed unit is driver-specific.h]hXMove the objective lens group at the specified speed until it reaches physical device limits or until an explicit request to stop the movement. A positive value moves the zoom lens group towards the telephoto direction. A value of zero stops the zoom lens group movement. A negative value moves the zoom lens group towards the wide-angle direction. The zoom speed unit is driver-specific.}(hj* hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj' ubah}(h]h ]h"]h$]h&]uh1j=hj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj hhubj)}(h``V4L2_CID_IRIS_ABSOLUTE (integer)`` This control sets the camera's aperture to the specified value. The unit is undefined. Larger values open the iris wider, smaller values close it. h](j#)}(h$``V4L2_CID_IRIS_ABSOLUTE (integer)``h]j))}(hjJ h]h V4L2_CID_IRIS_ABSOLUTE (integer)}(hjL hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjH ubah}(h]h ]h"]h$]h&]uh1j"hhhKhjD ubj>)}(hhh]h)}(hThis control sets the camera's aperture to the specified value. The unit is undefined. Larger values open the iris wider, smaller values close it.h]hThis control sets the camera’s aperture to the specified value. The unit is undefined. Larger values open the iris wider, smaller values close it.}(hjb hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj_ ubah}(h]h ]h"]h$]h&]uh1j=hjD ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj hhubj)}(h``V4L2_CID_IRIS_RELATIVE (integer)`` This control modifies the camera's aperture by the specified amount. The unit is undefined. Positive values open the iris one step further, negative values close it one step further. This is a write-only control. h](j#)}(h$``V4L2_CID_IRIS_RELATIVE (integer)``h]j))}(hj h]h V4L2_CID_IRIS_RELATIVE (integer)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1j"hhhKhj| ubj>)}(hhh]h)}(hThis control modifies the camera's aperture by the specified amount. The unit is undefined. Positive values open the iris one step further, negative values close it one step further. This is a write-only control.h]hThis control modifies the camera’s aperture by the specified amount. The unit is undefined. Positive values open the iris one step further, negative values close it one step further. This is a write-only control.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j=hj| ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj hhubj)}(hX``V4L2_CID_PRIVACY (boolean)`` Prevent video from being acquired by the camera. When this control is set to ``TRUE`` (1), no image can be captured by the camera. Common means to enforce privacy are mechanical obturation of the sensor and firmware image processing, but the device is not restricted to these methods. Devices that implement the privacy control must support read access and may support write access. h](j#)}(h``V4L2_CID_PRIVACY (boolean)``h]j))}(hj h]hV4L2_CID_PRIVACY (boolean)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubah}(h]h ]h"]h$]h&]uh1j"hhhMhj ubj>)}(hhh]h)}(hX~Prevent video from being acquired by the camera. When this control is set to ``TRUE`` (1), no image can be captured by the camera. Common means to enforce privacy are mechanical obturation of the sensor and firmware image processing, but the device is not restricted to these methods. Devices that implement the privacy control must support read access and may support write access.h](hMPrevent video from being acquired by the camera. When this control is set to }(hj hhhNhNubj))}(h``TRUE``h]hTRUE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj ubhX) (1), no image can be captured by the camera. Common means to enforce privacy are mechanical obturation of the sensor and firmware image processing, but the device is not restricted to these methods. Devices that implement the privacy control must support read access and may support write access.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j=hj ubeh}(h]h ]h"]h$]h&]uh1jhhhMhj hhubj)}(h``V4L2_CID_BAND_STOP_FILTER (integer)`` Switch the band-stop filter of a camera sensor on or off, or specify its strength. Such band-stop filters can be used, for example, to filter out the fluorescent light component. h](j#)}(h'``V4L2_CID_BAND_STOP_FILTER (integer)``h]j))}(hjh]h#V4L2_CID_BAND_STOP_FILTER (integer)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhM hj ubj>)}(hhh]h)}(hSwitch the band-stop filter of a camera sensor on or off, or specify its strength. Such band-stop filters can be used, for example, to filter out the fluorescent light component.h]hSwitch the band-stop filter of a camera sensor on or off, or specify its strength. Such band-stop filters can be used, for example, to filter out the fluorescent light component.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j=hj ubeh}(h]h ]h"]h$]h&]uh1jhhhM hj hhubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubh)}(h%.. _v4l2-auto-n-preset-white-balance:h]h}(h]h ]h"]h$]h&]hԌ v4l2-auto-n-preset-white-balanceuh1hhM hjhhhhubj)}(hhh](j)}(h0``V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE`` (enum) h](j#)}(h(``V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE``h]j))}(hjPh]h$V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjNubah}(h]h ]h"]h$]h&]uh1j"hhhMhjJubj>)}(hhh]h)}(h(enum)h]h(enum)}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjeubah}(h]h ]h"]h$]h&]uh1j=hjJubeh}(h]h ]h"]h$]h&]uh1jhhhMhjGubj)}(hXRenum v4l2_auto_n_preset_white_balance - Sets white balance to automatic, manual or a preset. The presets determine color temperature of the light as a hint to the camera for white balance adjustments resulting in most accurate color representation. The following white balance presets are listed in order of increasing color temperature. h](j#)}(h'enum v4l2_auto_n_preset_white_balance -h]h'enum v4l2_auto_n_preset_white_balance -}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j"hhhMhjubj>)}(hhh]h)}(hX)Sets white balance to automatic, manual or a preset. The presets determine color temperature of the light as a hint to the camera for white balance adjustments resulting in most accurate color representation. The following white balance presets are listed in order of increasing color temperature.h]hX)Sets white balance to automatic, manual or a preset. The presets determine color temperature of the light as a hint to the camera for white balance adjustments resulting in most accurate color representation. The following white balance presets are listed in order of increasing color temperature.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhMhjGhhubeh}(h]jFah ]h"] v4l2-auto-n-preset-white-balanceah$]h&]uh1jhjhhhhhNj}jj<sj }jFj<subj )}(hhh]h}(h]h ]h"]h$]h&]j|p{7.4cm}|p{10.1cm}|uh1j hhhMhjhhubj)}(hhh]j)}(hhh](j#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjubj#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjubj9)}(hhh](j>)}(hhh](jC)}(hhh]h)}(h``V4L2_WHITE_BALANCE_MANUAL``h]j))}(hjh]hV4L2_WHITE_BALANCE_MANUAL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hManual white balance.h]hManual white balance.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_WHITE_BALANCE_AUTO``h]j))}(hj)h]hV4L2_WHITE_BALANCE_AUTO}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj'ubah}(h]h ]h"]h$]h&]uh1hhhhMhj$ubah}(h]h ]h"]h$]h&]uh1jBhj!ubjC)}(hhh]h)}(h$Automatic white balance adjustments.h]h$Automatic white balance adjustments.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjDubah}(h]h ]h"]h$]h&]uh1jBhj!ubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h#``V4L2_WHITE_BALANCE_INCANDESCENT``h]j))}(hjih]hV4L2_WHITE_BALANCE_INCANDESCENT}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjgubah}(h]h ]h"]h$]h&]uh1hhhhM!hjdubah}(h]h ]h"]h$]h&]uh1jBhjaubjC)}(hhh]h)}(hWhite balance setting for incandescent (tungsten) lighting. It generally cools down the colors and corresponds approximately to 2500...3500 K color temperature range.h]hWhite balance setting for incandescent (tungsten) lighting. It generally cools down the colors and corresponds approximately to 2500...3500 K color temperature range.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM"hjubah}(h]h ]h"]h$]h&]uh1jBhjaubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h"``V4L2_WHITE_BALANCE_FLUORESCENT``h]j))}(hjh]hV4L2_WHITE_BALANCE_FLUORESCENT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhM%hjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hoWhite balance preset for fluorescent lighting. It corresponds approximately to 4000...5000 K color temperature.h]hoWhite balance preset for fluorescent lighting. It corresponds approximately to 4000...5000 K color temperature.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM&hjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h$``V4L2_WHITE_BALANCE_FLUORESCENT_H``h]j))}(hjh]h V4L2_WHITE_BALANCE_FLUORESCENT_H}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhM(hjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hHWith this setting the camera will compensate for fluorescent H lighting.h]hHWith this setting the camera will compensate for fluorescent H lighting.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM)hjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_WHITE_BALANCE_HORIZON``h]j))}(hj)h]hV4L2_WHITE_BALANCE_HORIZON}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj'ubah}(h]h ]h"]h$]h&]uh1hhhhM+hj$ubah}(h]h ]h"]h$]h&]uh1jBhj!ubjC)}(hhh]h)}(heWhite balance setting for horizon daylight. It corresponds approximately to 5000 K color temperature.h]heWhite balance setting for horizon daylight. It corresponds approximately to 5000 K color temperature.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM,hjDubah}(h]h ]h"]h$]h&]uh1jBhj!ubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_WHITE_BALANCE_DAYLIGHT``h]j))}(hjih]hV4L2_WHITE_BALANCE_DAYLIGHT}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjgubah}(h]h ]h"]h$]h&]uh1hhhhM.hjdubah}(h]h ]h"]h$]h&]uh1jBhjaubjC)}(hhh]h)}(htWhite balance preset for daylight (with clear sky). It corresponds approximately to 5000...6500 K color temperature.h]htWhite balance preset for daylight (with clear sky). It corresponds approximately to 5000...6500 K color temperature.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM/hjubah}(h]h ]h"]h$]h&]uh1jBhjaubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_WHITE_BALANCE_FLASH``h]j))}(hjh]hV4L2_WHITE_BALANCE_FLASH}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhM1hjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hWith this setting the camera will compensate for the flash light. It slightly warms up the colors and corresponds roughly to 5000...5500 K color temperature.h]hWith this setting the camera will compensate for the flash light. It slightly warms up the colors and corresponds roughly to 5000...5500 K color temperature.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM2hjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_WHITE_BALANCE_CLOUDY``h]j))}(hjh]hV4L2_WHITE_BALANCE_CLOUDY}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhM5hjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hWhite balance preset for moderately overcast sky. This option corresponds approximately to 6500...8000 K color temperature range.h]hWhite balance preset for moderately overcast sky. This option corresponds approximately to 6500...8000 K color temperature range.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM6hjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_WHITE_BALANCE_SHADE``h]j))}(hj)h]hV4L2_WHITE_BALANCE_SHADE}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj'ubah}(h]h ]h"]h$]h&]uh1hhhhM9hj$ubah}(h]h ]h"]h$]h&]uh1jBhj!ubjC)}(hhh]h)}(hyWhite balance preset for shade or heavily overcast sky. It corresponds approximately to 9000...10000 K color temperature.h]hyWhite balance preset for shade or heavily overcast sky. It corresponds approximately to 9000...10000 K color temperature.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM:hjDubah}(h]h ]h"]h$]h&]uh1jBhj!ubeh}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjhhhNhNubh)}(h.. _v4l2-wide-dynamic-range:h]h}(h]h ]h"]h$]h&]hԌv4l2-wide-dynamic-rangeuh1hhM?hjhhhhubj)}(hhh]j)}(hX``V4L2_CID_WIDE_DYNAMIC_RANGE (boolean)`` Enables or disables the camera's wide dynamic range feature. This feature allows to obtain clear images in situations where intensity of the illumination varies significantly throughout the scene, i.e. there are simultaneously very dark and very bright areas. It is most commonly realized in cameras by combining two subsequent frames with different exposure times. [#f1]_ h](j#)}(h)``V4L2_CID_WIDE_DYNAMIC_RANGE (boolean)``h]j))}(hjh]h%V4L2_CID_WIDE_DYNAMIC_RANGE (boolean)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhMGhjubj>)}(hhh]h)}(hXuEnables or disables the camera's wide dynamic range feature. This feature allows to obtain clear images in situations where intensity of the illumination varies significantly throughout the scene, i.e. there are simultaneously very dark and very bright areas. It is most commonly realized in cameras by combining two subsequent frames with different exposure times. [#f1]_h](hXqEnables or disables the camera’s wide dynamic range feature. This feature allows to obtain clear images in situations where intensity of the illumination varies significantly throughout the scene, i.e. there are simultaneously very dark and very bright areas. It is most commonly realized in cameras by combining two subsequent frames with different exposure times. }(hjhhhNhNubhfootnote_reference)}(h[#f1]_h]h1}(hjhhhNhNubah}(h]id1ah ]h"]h$]h&]autoKhԌf1docnamejguh1jhjresolvedKubeh}(h]h ]h"]h$]h&]uh1hhhhMBhjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhMGhjubah}(h]j~ah ]h"]v4l2-wide-dynamic-rangeah$]h&]uh1jhjhhhhhNj}jjtsj }j~jtsubh)}(h.. _v4l2-image-stabilization:h]h}(h]h ]h"]h$]h&]hԌv4l2-image-stabilizationuh1hhMIhjhhhhubj)}(hhh](j)}(hT``V4L2_CID_IMAGE_STABILIZATION (boolean)`` Enables or disables image stabilization. h](j#)}(h*``V4L2_CID_IMAGE_STABILIZATION (boolean)``h]j))}(hjh]h&V4L2_CID_IMAGE_STABILIZATION (boolean)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhMLhjubj>)}(hhh]h)}(h(Enables or disables image stabilization.h]h(Enables or disables image stabilization.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMLhjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhMLhjubj)}(hX``V4L2_CID_ISO_SENSITIVITY (integer menu)`` Determines ISO equivalent of an image sensor indicating the sensor's sensitivity to light. The numbers are expressed in arithmetic scale, as per :ref:`iso12232` standard, where doubling the sensor sensitivity is represented by doubling the numerical ISO value. Applications should interpret the values as standard ISO values multiplied by 1000, e.g. control value 800 stands for ISO 0.8. Drivers will usually support only a subset of standard ISO values. The effect of setting this control while the ``V4L2_CID_ISO_SENSITIVITY_AUTO`` control is set to a value other than ``V4L2_CID_ISO_SENSITIVITY_MANUAL`` is undefined, drivers should ignore such requests. h](j#)}(h+``V4L2_CID_ISO_SENSITIVITY (integer menu)``h]j))}(hj$h]h'V4L2_CID_ISO_SENSITIVITY (integer menu)}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj"ubah}(h]h ]h"]h$]h&]uh1j"hhhMYhjubj>)}(hhh]h)}(hXDetermines ISO equivalent of an image sensor indicating the sensor's sensitivity to light. The numbers are expressed in arithmetic scale, as per :ref:`iso12232` standard, where doubling the sensor sensitivity is represented by doubling the numerical ISO value. Applications should interpret the values as standard ISO values multiplied by 1000, e.g. control value 800 stands for ISO 0.8. Drivers will usually support only a subset of standard ISO values. The effect of setting this control while the ``V4L2_CID_ISO_SENSITIVITY_AUTO`` control is set to a value other than ``V4L2_CID_ISO_SENSITIVITY_MANUAL`` is undefined, drivers should ignore such requests.h](hDetermines ISO equivalent of an image sensor indicating the sensor’s sensitivity to light. The numbers are expressed in arithmetic scale, as per }(hj<hhhNhNubh)}(h:ref:`iso12232`h]jO)}(hjFh]hiso12232}(hjHhhhNhNubah}(h]h ](jZstdstd-refeh"]h$]h&]uh1jNhjDubah}(h]h ]h"]h$]h&]refdocjg refdomainjRreftyperef refexplicitrefwarnjmiso12232uh1hhhhMOhj<ubhXT standard, where doubling the sensor sensitivity is represented by doubling the numerical ISO value. Applications should interpret the values as standard ISO values multiplied by 1000, e.g. control value 800 stands for ISO 0.8. Drivers will usually support only a subset of standard ISO values. The effect of setting this control while the }(hj<hhhNhNubj))}(h!``V4L2_CID_ISO_SENSITIVITY_AUTO``h]hV4L2_CID_ISO_SENSITIVITY_AUTO}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj<ubh& control is set to a value other than }(hj<hhhNhNubj))}(h#``V4L2_CID_ISO_SENSITIVITY_MANUAL``h]hV4L2_CID_ISO_SENSITIVITY_MANUAL}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj<ubh3 is undefined, drivers should ignore such requests.}(hj<hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMOhj9ubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhMYhjhhubeh}(h]jah ]h"]v4l2-image-stabilizationah$]h&]uh1jhjhhhhhNj}jjsj }jjsubh)}(h#.. _v4l2-iso-sensitivity-auto-type:h]h}(h]h ]h"]h$]h&]hԌv4l2-iso-sensitivity-auto-typeuh1hhM[hjhhhhubj)}(hhh](j)}(h)``V4L2_CID_ISO_SENSITIVITY_AUTO`` (enum) h](j#)}(h!``V4L2_CID_ISO_SENSITIVITY_AUTO``h]j))}(hjh]hV4L2_CID_ISO_SENSITIVITY_AUTO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhM^hjubj>)}(hhh]h)}(h(enum)h]h(enum)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM^hjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhM^hjubj)}(h^enum v4l2_iso_sensitivity_type - Enables or disables automatic ISO sensitivity adjustments. h](j#)}(h enum v4l2_iso_sensitivity_type -h]h enum v4l2_iso_sensitivity_type -}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j"hhhMchjubj>)}(hhh]h)}(h:Enables or disables automatic ISO sensitivity adjustments.h]h:Enables or disables automatic ISO sensitivity adjustments.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMahjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhMchjhhubeh}(h]jah ]h"]v4l2-iso-sensitivity-auto-typeah$]h&]uh1jhjhhhhhNj}j jsj }jjsubj)}(hhh]j)}(hhh](j#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hj(ubj#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hj(ubj9)}(hhh](j>)}(hhh](jC)}(hhh]h)}(h#``V4L2_CID_ISO_SENSITIVITY_MANUAL``h]j))}(hjJh]hV4L2_CID_ISO_SENSITIVITY_MANUAL}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjHubah}(h]h ]h"]h$]h&]uh1hhhhMihjEubah}(h]h ]h"]h$]h&]uh1jBhjBubjC)}(hhh]h)}(hManual ISO sensitivity.h]hManual ISO sensitivity.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMjhjeubah}(h]h ]h"]h$]h&]uh1jBhjBubeh}(h]h ]h"]h$]h&]uh1j=hj?ubj>)}(hhh](jC)}(hhh]h)}(h!``V4L2_CID_ISO_SENSITIVITY_AUTO``h]j))}(hjh]hV4L2_CID_ISO_SENSITIVITY_AUTO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhMkhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(h&Automatic ISO sensitivity adjustments.h]h&Automatic ISO sensitivity adjustments.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMlhjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hj?ubeh}(h]h ]h"]h$]h&]uh1j8hj(ubeh}(h]h ]h"]h$]h&]colsKuh1jhj%ubah}(h]h ]h"]h$]h&]uh1jhjhhhNhNubh)}(h.. _v4l2-scene-mode:h]h}(h]h ]h"]h$]h&]hԌv4l2-scene-modeuh1hhMphjhhhhubj)}(hhh](j)}(h``V4L2_CID_SCENE_MODE`` (enum) h](j#)}(h``V4L2_CID_SCENE_MODE``h]j))}(hjh]hV4L2_CID_SCENE_MODE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhMshjubj>)}(hhh]h)}(h(enum)h]h(enum)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMshjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhMshjubj)}(hXlenum v4l2_scene_mode - This control allows to select scene programs as the camera automatic modes optimized for common shooting scenes. Within these modes the camera determines best exposure, aperture, focusing, light metering, white balance and equivalent sensitivity. The controls of those parameters are influenced by the scene mode control. An exact behavior in each mode is subject to the camera specification. When the scene mode feature is not used, this control should be set to ``V4L2_SCENE_MODE_NONE`` to make sure the other possibly related controls are accessible. The following scene programs are defined: h](j#)}(henum v4l2_scene_mode -h]henum v4l2_scene_mode -}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j"hhhMhjubj>)}(hhh](h)}(hXThis control allows to select scene programs as the camera automatic modes optimized for common shooting scenes. Within these modes the camera determines best exposure, aperture, focusing, light metering, white balance and equivalent sensitivity. The controls of those parameters are influenced by the scene mode control. An exact behavior in each mode is subject to the camera specification.h]hXThis control allows to select scene programs as the camera automatic modes optimized for common shooting scenes. Within these modes the camera determines best exposure, aperture, focusing, light metering, white balance and equivalent sensitivity. The controls of those parameters are influenced by the scene mode control. An exact behavior in each mode is subject to the camera specification.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMvhj-ubh)}(hWhen the scene mode feature is not used, this control should be set to ``V4L2_SCENE_MODE_NONE`` to make sure the other possibly related controls are accessible. The following scene programs are defined:h](hGWhen the scene mode feature is not used, this control should be set to }(hj>hhhNhNubj))}(h``V4L2_SCENE_MODE_NONE``h]hV4L2_SCENE_MODE_NONE}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj>ubhk to make sure the other possibly related controls are accessible. The following scene programs are defined:}(hj>hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM}hj-ubeh}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhMhjhhubeh}(h]jah ]h"]v4l2-scene-modeah$]h&]uh1jhjhhhhhNj}jnjsj }jjsubhraw)}(h\smallh]h\small}hjusbah}(h]h ]h"]h$]h&]formatlatexhhuh1jshhhMhjhhubj )}(hhh]h}(h]h ]h"]h$]h&]j|p{5.9cm}|p{11.6cm}|uh1j hhhMhjhhubj)}(hhh]j)}(hhh](j#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjubj#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjubj9)}(hhh](j>)}(hhh](jC)}(hhh]h)}(h``V4L2_SCENE_MODE_NONE``h]j))}(hjh]hV4L2_SCENE_MODE_NONE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(h#The scene mode feature is disabled.h]h#The scene mode feature is disabled.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_SCENE_MODE_BACKLIGHT``h]j))}(hjh]hV4L2_SCENE_MODE_BACKLIGHT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hBacklight. Compensates for dark shadows when light is coming from behind a subject, also by automatically turning on the flash.h]hBacklight. Compensates for dark shadows when light is coming from behind a subject, also by automatically turning on the flash.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_SCENE_MODE_BEACH_SNOW``h]j))}(hj4h]hV4L2_SCENE_MODE_BEACH_SNOW}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj2ubah}(h]h ]h"]h$]h&]uh1hhhhMhj/ubah}(h]h ]h"]h$]h&]uh1jBhj,ubjC)}(hhh]h)}(hXwBeach and snow. This mode compensates for all-white or bright scenes, which tend to look gray and low contrast, when camera's automatic exposure is based on an average scene brightness. To compensate, this mode automatically slightly overexposes the frames. The white balance may also be adjusted to compensate for the fact that reflected snow looks bluish rather than white.h]hXyBeach and snow. This mode compensates for all-white or bright scenes, which tend to look gray and low contrast, when camera’s automatic exposure is based on an average scene brightness. To compensate, this mode automatically slightly overexposes the frames. The white balance may also be adjusted to compensate for the fact that reflected snow looks bluish rather than white.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjOubah}(h]h ]h"]h$]h&]uh1jBhj,ubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_SCENE_MODE_CANDLELIGHT``h]j))}(hjth]hV4L2_SCENE_MODE_CANDLELIGHT}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjrubah}(h]h ]h"]h$]h&]uh1hhhhMhjoubah}(h]h ]h"]h$]h&]uh1jBhjlubjC)}(hhh]h)}(hCandle light. The camera generally raises the ISO sensitivity and lowers the shutter speed. This mode compensates for relatively close subject in the scene. The flash is disabled in order to preserve the ambiance of the light.h]hCandle light. The camera generally raises the ISO sensitivity and lowers the shutter speed. This mode compensates for relatively close subject in the scene. The flash is disabled in order to preserve the ambiance of the light.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjlubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_SCENE_MODE_DAWN_DUSK``h]j))}(hjh]hV4L2_SCENE_MODE_DAWN_DUSK}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hDawn and dusk. Preserves the colors seen in low natural light before dusk and after down. The camera may turn off the flash, and automatically focus at infinity. It will usually boost saturation and lower the shutter speed.h]hDawn and dusk. Preserves the colors seen in low natural light before dusk and after down. The camera may turn off the flash, and automatically focus at infinity. It will usually boost saturation and lower the shutter speed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_SCENE_MODE_FALL_COLORS``h]j))}(hjh]hV4L2_SCENE_MODE_FALL_COLORS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hFall colors. Increases saturation and adjusts white balance for color enhancement. Pictures of autumn leaves get saturated reds and yellows.h]hFall colors. Increases saturation and adjusts white balance for color enhancement. Pictures of autumn leaves get saturated reds and yellows.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_SCENE_MODE_FIREWORKS``h]j))}(hj4h]hV4L2_SCENE_MODE_FIREWORKS}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj2ubah}(h]h ]h"]h$]h&]uh1hhhhMhj/ubah}(h]h ]h"]h$]h&]uh1jBhj,ubjC)}(hhh]h)}(hFireworks. Long exposure times are used to capture the expanding burst of light from a firework. The camera may invoke image stabilization.h]hFireworks. Long exposure times are used to capture the expanding burst of light from a firework. The camera may invoke image stabilization.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjOubah}(h]h ]h"]h$]h&]uh1jBhj,ubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_SCENE_MODE_LANDSCAPE``h]j))}(hjth]hV4L2_SCENE_MODE_LANDSCAPE}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjrubah}(h]h ]h"]h$]h&]uh1hhhhMhjoubah}(h]h ]h"]h$]h&]uh1jBhjlubjC)}(hhh]h)}(hLandscape. The camera may choose a small aperture to provide deep depth of field and long exposure duration to help capture detail in dim light conditions. The focus is fixed at infinity. Suitable for distant and wide scenery.h]hLandscape. The camera may choose a small aperture to provide deep depth of field and long exposure duration to help capture detail in dim light conditions. The focus is fixed at infinity. Suitable for distant and wide scenery.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjlubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_SCENE_MODE_NIGHT``h]j))}(hjh]hV4L2_SCENE_MODE_NIGHT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hXfNight, also known as Night Landscape. Designed for low light conditions, it preserves detail in the dark areas without blowing out bright objects. The camera generally sets itself to a medium-to-high ISO sensitivity, with a relatively long exposure time, and turns flash off. As such, there will be increased image noise and the possibility of blurred image.h]hXfNight, also known as Night Landscape. Designed for low light conditions, it preserves detail in the dark areas without blowing out bright objects. The camera generally sets itself to a medium-to-high ISO sensitivity, with a relatively long exposure time, and turns flash off. As such, there will be increased image noise and the possibility of blurred image.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h ``V4L2_SCENE_MODE_PARTY_INDOOR``h]j))}(hjh]hV4L2_SCENE_MODE_PARTY_INDOOR}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hParty and indoor. Designed to capture indoor scenes that are lit by indoor background lighting as well as the flash. The camera usually increases ISO sensitivity, and adjusts exposure for the low light conditions.h]hParty and indoor. Designed to capture indoor scenes that are lit by indoor background lighting as well as the flash. The camera usually increases ISO sensitivity, and adjusts exposure for the low light conditions.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_SCENE_MODE_PORTRAIT``h]j))}(hj4h]hV4L2_SCENE_MODE_PORTRAIT}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj2ubah}(h]h ]h"]h$]h&]uh1hhhhMhj/ubah}(h]h ]h"]h$]h&]uh1jBhj,ubjC)}(hhh]h)}(hX;Portrait. The camera adjusts the aperture so that the depth of field is reduced, which helps to isolate the subject against a smooth background. Most cameras recognize the presence of faces in the scene and focus on them. The color hue is adjusted to enhance skin tones. The intensity of the flash is often reduced.h]hX;Portrait. The camera adjusts the aperture so that the depth of field is reduced, which helps to isolate the subject against a smooth background. Most cameras recognize the presence of faces in the scene and focus on them. The color hue is adjusted to enhance skin tones. The intensity of the flash is often reduced.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjOubah}(h]h ]h"]h$]h&]uh1jBhj,ubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_SCENE_MODE_SPORTS``h]j))}(hjth]hV4L2_SCENE_MODE_SPORTS}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjrubah}(h]h ]h"]h$]h&]uh1hhhhMhjoubah}(h]h ]h"]h$]h&]uh1jBhjlubjC)}(hhh]h)}(hSports. Significantly increases ISO and uses a fast shutter speed to freeze motion of rapidly-moving subjects. Increased image noise may be seen in this mode.h]hSports. Significantly increases ISO and uses a fast shutter speed to freeze motion of rapidly-moving subjects. Increased image noise may be seen in this mode.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjlubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_SCENE_MODE_SUNSET``h]j))}(hjh]hV4L2_SCENE_MODE_SUNSET}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hUSunset. Preserves deep hues seen in sunsets and sunrises. It bumps up the saturation.h]hUSunset. Preserves deep hues seen in sunsets and sunrises. It bumps up the saturation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_SCENE_MODE_TEXT``h]j))}(hjh]hV4L2_SCENE_MODE_TEXT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hText. It applies extra contrast and sharpness, it is typically a black-and-white mode optimized for readability. Automatic focus may be switched to close-up mode and this setting may also involve some lens-distortion correction.h]hText. It applies extra contrast and sharpness, it is typically a black-and-white mode optimized for readability. Automatic focus may be switched to close-up mode and this setting may also involve some lens-distortion correction.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ] longtableah"]h$]h&]uh1jhjhhhNhNubjt)}(h \normalsizeh]h \normalsize}hj@sbah}(h]h ]h"]h$]h&]formatlatexhhuh1jshhhMhjhhubj)}(hhh]j)}(hX``V4L2_CID_3A_LOCK (bitmask)`` This control locks or unlocks the automatic focus, exposure and white balance. The automatic adjustments can be paused independently by setting the corresponding lock bit to 1. The camera then retains the settings until the lock bit is cleared. The following lock bits are defined: When a given algorithm is not enabled, drivers should ignore requests to lock it and should return no error. An example might be an application setting bit ``V4L2_LOCK_WHITE_BALANCE`` when the ``V4L2_CID_AUTO_WHITE_BALANCE`` control is set to ``FALSE``. The value of this control may be changed by exposure, white balance or focus controls. h](j#)}(h``V4L2_CID_3A_LOCK (bitmask)``h]j))}(hjYh]hV4L2_CID_3A_LOCK (bitmask)}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjWubah}(h]h ]h"]h$]h&]uh1j"hhhMhjSubj>)}(hhh](h)}(hXThis control locks or unlocks the automatic focus, exposure and white balance. The automatic adjustments can be paused independently by setting the corresponding lock bit to 1. The camera then retains the settings until the lock bit is cleared. The following lock bits are defined:h]hXThis control locks or unlocks the automatic focus, exposure and white balance. The automatic adjustments can be paused independently by setting the corresponding lock bit to 1. The camera then retains the settings until the lock bit is cleared. The following lock bits are defined:}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjnubh)}(hXTWhen a given algorithm is not enabled, drivers should ignore requests to lock it and should return no error. An example might be an application setting bit ``V4L2_LOCK_WHITE_BALANCE`` when the ``V4L2_CID_AUTO_WHITE_BALANCE`` control is set to ``FALSE``. The value of this control may be changed by exposure, white balance or focus controls.h](hWhen a given algorithm is not enabled, drivers should ignore requests to lock it and should return no error. An example might be an application setting bit }(hjhhhNhNubj))}(h``V4L2_LOCK_WHITE_BALANCE``h]hV4L2_LOCK_WHITE_BALANCE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh when the }(hjhhhNhNubj))}(h``V4L2_CID_AUTO_WHITE_BALANCE``h]hV4L2_CID_AUTO_WHITE_BALANCE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubh control is set to }(hjhhhNhNubj))}(h ``FALSE``h]hFALSE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubhX. The value of this control may be changed by exposure, white balance or focus controls.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjnubeh}(h]h ]h"]h$]h&]uh1j=hjSubeh}(h]h ]h"]h$]h&]uh1jhhhMhjPubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hhh]j)}(hhh](j#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjubj#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjubj9)}(hhh](j>)}(hhh](jC)}(hhh]h)}(h``V4L2_LOCK_EXPOSURE``h]j))}(hjh]hV4L2_LOCK_EXPOSURE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(h$Automatic exposure adjustments lock.h]h$Automatic exposure adjustments lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_LOCK_WHITE_BALANCE``h]j))}(hj:h]hV4L2_LOCK_WHITE_BALANCE}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj8ubah}(h]h ]h"]h$]h&]uh1hhhhMhj5ubah}(h]h ]h"]h$]h&]uh1jBhj2ubjC)}(hhh]h)}(h)Automatic white balance adjustments lock.h]h)Automatic white balance adjustments lock.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjUubah}(h]h ]h"]h$]h&]uh1jBhj2ubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h``V4L2_LOCK_FOCUS``h]j))}(hjzh]hV4L2_LOCK_FOCUS}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjxubah}(h]h ]h"]h$]h&]uh1hhhhMhjuubah}(h]h ]h"]h$]h&]uh1jBhjrubjC)}(hhh]h)}(hAutomatic focus lock.h]hAutomatic focus lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjrubeh}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjhhhNhNubj)}(hhh](j)}(hX?``V4L2_CID_PAN_SPEED (integer)`` This control turns the camera horizontally at the specific speed. The unit is undefined. A positive value moves the camera to the right (clockwise when viewed from above), a negative value to the left. A value of zero stops the motion if one is in progress and has no effect otherwise. h](j#)}(h ``V4L2_CID_PAN_SPEED (integer)``h]j))}(hjh]hV4L2_CID_PAN_SPEED (integer)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhMhjubj>)}(hhh]h)}(hXThis control turns the camera horizontally at the specific speed. The unit is undefined. A positive value moves the camera to the right (clockwise when viewed from above), a negative value to the left. A value of zero stops the motion if one is in progress and has no effect otherwise.h]hXThis control turns the camera horizontally at the specific speed. The unit is undefined. A positive value moves the camera to the right (clockwise when viewed from above), a negative value to the left. A value of zero stops the motion if one is in progress and has no effect otherwise.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhMhjubj)}(hX ``V4L2_CID_TILT_SPEED (integer)`` This control turns the camera vertically at the specified speed. The unit is undefined. A positive value moves the camera up, a negative value down. A value of zero stops the motion if one is in progress and has no effect otherwise. h](j#)}(h!``V4L2_CID_TILT_SPEED (integer)``h]j))}(hjh]hV4L2_CID_TILT_SPEED (integer)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhMhjubj>)}(hhh]h)}(hThis control turns the camera vertically at the specified speed. The unit is undefined. A positive value moves the camera up, a negative value down. A value of zero stops the motion if one is in progress and has no effect otherwise.h]hThis control turns the camera vertically at the specified speed. The unit is undefined. A positive value moves the camera up, a negative value down. A value of zero stops the motion if one is in progress and has no effect otherwise.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhMhjhhubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubh)}(h#.. _v4l2-camera-sensor-orientation:h]h}(h]h ]h"]h$]h&]hԌv4l2-camera-sensor-orientationuh1hhMhjhhhhubj)}(hhh]j)}(hX``V4L2_CID_CAMERA_ORIENTATION (menu)`` This read-only control describes the camera orientation by reporting its mounting position on the device where the camera is installed. The control value is constant and not modifiable by software. This control is particularly meaningful for devices which have a well defined orientation, such as phones, laptops and portable devices since the control is expressed as a position relative to the device's intended usage orientation. For example, a camera installed on the user-facing side of a phone, a tablet or a laptop device is said to be have ``V4L2_CAMERA_ORIENTATION_FRONT`` orientation, while a camera installed on the opposite side of the front one is said to be have ``V4L2_CAMERA_ORIENTATION_BACK`` orientation. Camera sensors not directly attached to the device, or attached in a way that allows them to move freely, such as webcams and digital cameras, are said to have the ``V4L2_CAMERA_ORIENTATION_EXTERNAL`` orientation. h](j#)}(h&``V4L2_CID_CAMERA_ORIENTATION (menu)``h]j))}(hjRh]h"V4L2_CID_CAMERA_ORIENTATION (menu)}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjPubah}(h]h ]h"]h$]h&]uh1j"hhhMhjLubj>)}(hhh]h)}(hXThis read-only control describes the camera orientation by reporting its mounting position on the device where the camera is installed. The control value is constant and not modifiable by software. This control is particularly meaningful for devices which have a well defined orientation, such as phones, laptops and portable devices since the control is expressed as a position relative to the device's intended usage orientation. For example, a camera installed on the user-facing side of a phone, a tablet or a laptop device is said to be have ``V4L2_CAMERA_ORIENTATION_FRONT`` orientation, while a camera installed on the opposite side of the front one is said to be have ``V4L2_CAMERA_ORIENTATION_BACK`` orientation. Camera sensors not directly attached to the device, or attached in a way that allows them to move freely, such as webcams and digital cameras, are said to have the ``V4L2_CAMERA_ORIENTATION_EXTERNAL`` orientation.h](hX%This read-only control describes the camera orientation by reporting its mounting position on the device where the camera is installed. The control value is constant and not modifiable by software. This control is particularly meaningful for devices which have a well defined orientation, such as phones, laptops and portable devices since the control is expressed as a position relative to the device’s intended usage orientation. For example, a camera installed on the user-facing side of a phone, a tablet or a laptop device is said to be have }(hjjhhhNhNubj))}(h!``V4L2_CAMERA_ORIENTATION_FRONT``h]hV4L2_CAMERA_ORIENTATION_FRONT}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjjubh` orientation, while a camera installed on the opposite side of the front one is said to be have }(hjjhhhNhNubj))}(h ``V4L2_CAMERA_ORIENTATION_BACK``h]hV4L2_CAMERA_ORIENTATION_BACK}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjjubh orientation. Camera sensors not directly attached to the device, or attached in a way that allows them to move freely, such as webcams and digital cameras, are said to have the }(hjjhhhNhNubj))}(h$``V4L2_CAMERA_ORIENTATION_EXTERNAL``h]h V4L2_CAMERA_ORIENTATION_EXTERNAL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjjubh orientation.}(hjjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjgubah}(h]h ]h"]h$]h&]uh1j=hjLubeh}(h]h ]h"]h$]h&]uh1jhhhMhjIubah}(h]jHah ]h"]v4l2-camera-sensor-orientationah$]h&]uh1jhjhhhhhNj}jj>sj }jHj>subj )}(hhh]h}(h]h ]h"]h$]h&]j|p{7.7cm}|p{9.8cm}|uh1j hhhMhjhhubj)}(hhh]j)}(hhh](j#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjubj#)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1j"hjubj9)}(hhh](j>)}(hhh](jC)}(hhh]h)}(h!``V4L2_CAMERA_ORIENTATION_FRONT``h]j))}(hjh]hV4L2_CAMERA_ORIENTATION_FRONT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjubjC)}(hhh]h)}(hBThe camera is oriented towards the user facing side of the device.h]hBThe camera is oriented towards the user facing side of the device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jBhjubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h ``V4L2_CAMERA_ORIENTATION_BACK``h]j))}(hj2h]hV4L2_CAMERA_ORIENTATION_BACK}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj0ubah}(h]h ]h"]h$]h&]uh1hhhhMhj-ubah}(h]h ]h"]h$]h&]uh1jBhj*ubjC)}(hhh]h)}(hBThe camera is oriented towards the back facing side of the device.h]hBThe camera is oriented towards the back facing side of the device.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjMubah}(h]h ]h"]h$]h&]uh1jBhj*ubeh}(h]h ]h"]h$]h&]uh1j=hjubj>)}(hhh](jC)}(hhh]h)}(h$``V4L2_CAMERA_ORIENTATION_EXTERNAL``h]j))}(hjrh]h V4L2_CAMERA_ORIENTATION_EXTERNAL}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjpubah}(h]h ]h"]h$]h&]uh1hhhhMhjmubah}(h]h ]h"]h$]h&]uh1jBhjjubjC)}(hhh]h)}(hHThe camera is not directly attached to the device and is freely movable.h]hHThe camera is not directly attached to the device and is freely movable.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jBhjjubeh}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjhhhNhNubh)}(h .. _v4l2-camera-sensor-rotation:h]h}(h]h ]h"]h$]h&]hԌv4l2-camera-sensor-rotationuh1hhMhjhhhhubj)}(hhh]j)}(hXZ``V4L2_CID_CAMERA_SENSOR_ROTATION (integer)`` This read-only control describes the rotation correction in degrees in the counter-clockwise direction to be applied to the captured images once captured to memory to compensate for the camera sensor mounting rotation. For a precise definition of the sensor mounting rotation refer to the extensive description of the 'rotation' properties in the device tree bindings file 'video-interfaces.txt'. A few examples are below reported, using a shark swimming from left to right in front of the user as the example scene to capture. :: 0 X-axis 0 +-------------------------------------> ! ! ! ! |\____)\___ ! ) _____ __`< ! |/ )/ ! ! ! V Y-axis Example one - Webcam Assuming you can bring your laptop with you while swimming with sharks, the camera module of the laptop is installed on the user facing part of a laptop screen casing, and is typically used for video calls. The captured images are meant to be displayed in landscape mode (width > height) on the laptop screen. The camera is typically mounted upside-down to compensate the lens optical inversion effect. In this case the value of the V4L2_CID_CAMERA_SENSOR_ROTATION control is 0, no rotation is required to display images correctly to the user. If the camera sensor is not mounted upside-down it is required to compensate the lens optical inversion effect and the value of the V4L2_CID_CAMERA_SENSOR_ROTATION control is 180 degrees, as images will result rotated when captured to memory. :: +--------------------------------------+ ! ! ! ! ! ! ! __/(_____/| ! ! >.___ ____ ( ! ! \( \| ! ! ! ! ! ! ! +--------------------------------------+ A software rotation correction of 180 degrees has to be applied to correctly display the image on the user screen. :: +--------------------------------------+ ! ! ! ! ! ! ! |\____)\___ ! ! ) _____ __`< ! ! |/ )/ ! ! ! ! ! ! ! +--------------------------------------+ Example two - Phone camera It is more handy to go and swim with sharks with only your mobile phone with you and take pictures with the camera that is installed on the back side of the device, facing away from the user. The captured images are meant to be displayed in portrait mode (height > width) to match the device screen orientation and the device usage orientation used when taking the picture. The camera sensor is typically mounted with its pixel array longer side aligned to the device longer side, upside-down mounted to compensate for the lens optical inversion effect. The images once captured to memory will be rotated and the value of the V4L2_CID_CAMERA_SENSOR_ROTATION will report a 90 degree rotation. :: +-------------------------------------+ | _ _ | | \ / | | | | | | | | | | | > | | < | | | | | | | . | | V | +-------------------------------------+ A correction of 90 degrees in counter-clockwise direction has to be applied to correctly display the image in portrait mode on the device screen. :: +--------------------+ | | | | | | | | | | | | | |\____)\___ | | ) _____ __`< | | |/ )/ | | | | | | | | | | | +--------------------+ h](j#)}(h-``V4L2_CID_CAMERA_SENSOR_ROTATION (integer)``h]j))}(hjh]h)V4L2_CID_CAMERA_SENSOR_ROTATION (integer)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hjubah}(h]h ]h"]h$]h&]uh1j"hhhMhjubj>)}(hhh](h)}(hThis read-only control describes the rotation correction in degrees in the counter-clockwise direction to be applied to the captured images once captured to memory to compensate for the camera sensor mounting rotation.h]hThis read-only control describes the rotation correction in degrees in the counter-clockwise direction to be applied to the captured images once captured to memory to compensate for the camera sensor mounting rotation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM!hjubh)}(hFor a precise definition of the sensor mounting rotation refer to the extensive description of the 'rotation' properties in the device tree bindings file 'video-interfaces.txt'.h]hFor a precise definition of the sensor mounting rotation refer to the extensive description of the ‘rotation’ properties in the device tree bindings file ‘video-interfaces.txt’.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM%hjubh)}(hA few examples are below reported, using a shark swimming from left to right in front of the user as the example scene to capture. ::h]hA few examples are below reported, using a shark swimming from left to right in front of the user as the example scene to capture.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM)hjubh literal_block)}(h 0 X-axis 0 +-------------------------------------> ! ! ! ! |\____)\___ ! ) _____ __`< ! |/ )/ ! ! ! V Y-axish]h 0 X-axis 0 +-------------------------------------> ! ! ! ! |\____)\___ ! ) _____ __`< ! |/ )/ ! ! ! V Y-axis}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhM,hjubh)}(hExample one - Webcamh]hExample one - Webcam}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM:hjubh)}(hX5Assuming you can bring your laptop with you while swimming with sharks, the camera module of the laptop is installed on the user facing part of a laptop screen casing, and is typically used for video calls. The captured images are meant to be displayed in landscape mode (width > height) on the laptop screen.h]hX5Assuming you can bring your laptop with you while swimming with sharks, the camera module of the laptop is installed on the user facing part of a laptop screen casing, and is typically used for video calls. The captured images are meant to be displayed in landscape mode (width > height) on the laptop screen.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM<hjubh)}(hThe camera is typically mounted upside-down to compensate the lens optical inversion effect. In this case the value of the V4L2_CID_CAMERA_SENSOR_ROTATION control is 0, no rotation is required to display images correctly to the user.h]hThe camera is typically mounted upside-down to compensate the lens optical inversion effect. In this case the value of the V4L2_CID_CAMERA_SENSOR_ROTATION control is 0, no rotation is required to display images correctly to the user.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMBhjubh)}(hIf the camera sensor is not mounted upside-down it is required to compensate the lens optical inversion effect and the value of the V4L2_CID_CAMERA_SENSOR_ROTATION control is 180 degrees, as images will result rotated when captured to memory. ::h]hIf the camera sensor is not mounted upside-down it is required to compensate the lens optical inversion effect and the value of the V4L2_CID_CAMERA_SENSOR_ROTATION control is 180 degrees, as images will result rotated when captured to memory.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMGhjubj)}(hX+--------------------------------------+ ! ! ! ! ! ! ! __/(_____/| ! ! >.___ ____ ( ! ! \( \| ! ! ! ! ! ! ! +--------------------------------------+h]hX+--------------------------------------+ ! ! ! ! ! ! ! __/(_____/| ! ! >.___ ____ ( ! ! \( \| ! ! ! ! ! ! ! +--------------------------------------+}hj[sbah}(h]h ]h"]h$]h&]hhuh1jhhhMLhjubh)}(huA software rotation correction of 180 degrees has to be applied to correctly display the image on the user screen. ::h]hrA software rotation correction of 180 degrees has to be applied to correctly display the image on the user screen.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMXhjubj)}(hX+--------------------------------------+ ! ! ! ! ! ! ! |\____)\___ ! ! ) _____ __`< ! ! |/ )/ ! ! ! ! ! ! ! +--------------------------------------+h]hX+--------------------------------------+ ! ! ! ! ! ! ! |\____)\___ ! ! ) _____ __`< ! ! |/ )/ ! ! ! ! ! ! ! +--------------------------------------+}hjwsbah}(h]h ]h"]h$]h&]hhuh1jhhhM[hjubh)}(hExample two - Phone camerah]hExample two - Phone camera}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMghjubh)}(hXuIt is more handy to go and swim with sharks with only your mobile phone with you and take pictures with the camera that is installed on the back side of the device, facing away from the user. The captured images are meant to be displayed in portrait mode (height > width) to match the device screen orientation and the device usage orientation used when taking the picture.h]hXuIt is more handy to go and swim with sharks with only your mobile phone with you and take pictures with the camera that is installed on the back side of the device, facing away from the user. The captured images are meant to be displayed in portrait mode (height > width) to match the device screen orientation and the device usage orientation used when taking the picture.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMihjubh)}(hThe camera sensor is typically mounted with its pixel array longer side aligned to the device longer side, upside-down mounted to compensate for the lens optical inversion effect.h]hThe camera sensor is typically mounted with its pixel array longer side aligned to the device longer side, upside-down mounted to compensate for the lens optical inversion effect.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMohjubh)}(hThe images once captured to memory will be rotated and the value of the V4L2_CID_CAMERA_SENSOR_ROTATION will report a 90 degree rotation. ::h]hThe images once captured to memory will be rotated and the value of the V4L2_CID_CAMERA_SENSOR_ROTATION will report a 90 degree rotation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMshjubj)}(hX+-------------------------------------+ | _ _ | | \ / | | | | | | | | | | | > | | < | | | | | | | . | | V | +-------------------------------------+h]hX+-------------------------------------+ | _ _ | | \ / | | | | | | | | | | | > | | < | | | | | | | . | | V | +-------------------------------------+}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMwhjubh)}(hA correction of 90 degrees in counter-clockwise direction has to be applied to correctly display the image in portrait mode on the device screen. ::h]hA correction of 90 degrees in counter-clockwise direction has to be applied to correctly display the image in portrait mode on the device screen.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubj)}(hXo+--------------------+ | | | | | | | | | | | | | |\____)\___ | | ) _____ __`< | | |/ )/ | | | | | | | | | | | +--------------------+h]hXo+--------------------+ | | | | | | | | | | | | | |\____)\___ | | ) _____ __`< | | |/ )/ | | | | | | | | | | | +--------------------+}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhjubeh}(h]h ]h"]h$]h&]uh1j=hjubeh}(h]h ]h"]h$]h&]uh1jhhhMhjubah}(h]jah ]h"]v4l2-camera-sensor-rotationah$]h&]uh1jhjhhhhhNj}jjsj }jjsubhfootnote)}(h[This control may be changed to a menu control in the future, if more options are required. h](hlabel)}(hhh]h1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhNhNubh)}(hZThis control may be changed to a menu control in the future, if more options are required.h]hZThis control may be changed to a menu control in the future, if more options are required.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubeh}(h]jah ]h"]f1ah$]h&]jajKjjguh1jhhhMhjhhubj)}(hhh]j)}(hXc``V4L2_CID_HDR_SENSOR_MODE (menu)`` Change the sensor HDR mode. A HDR picture is obtained by merging two captures of the same scene using two different exposure periods. HDR mode describes the way these two captures are merged in the sensor. As modes differ for each sensor, menu items are not standardized by this control and are left to the programmer.h](j#)}(h#``V4L2_CID_HDR_SENSOR_MODE (menu)``h]j))}(hj/h]hV4L2_CID_HDR_SENSOR_MODE (menu)}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hj-ubah}(h]h ]h"]h$]h&]uh1j"hhhMhj)ubj>)}(hhh](h)}(hChange the sensor HDR mode. A HDR picture is obtained by merging two captures of the same scene using two different exposure periods. HDR mode describes the way these two captures are merged in the sensor.h]hChange the sensor HDR mode. A HDR picture is obtained by merging two captures of the same scene using two different exposure periods. HDR mode describes the way these two captures are merged in the sensor.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjDubh)}(hpAs modes differ for each sensor, menu items are not standardized by this control and are left to the programmer.h]hpAs modes differ for each sensor, menu items are not standardized by this control and are left to the programmer.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjDubeh}(h]h ]h"]h$]h&]uh1j=hj)ubeh}(h]h ]h"]h$]h&]uh1jhhhMhj&ubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h](camera-control-idsjeh ]h"](camera control idscamera-control-ideh$]h&]uh1hhhhhhhhKj}j{hsj }jhsubeh}(h](camera-control-referenceheh ]h"](camera control referencecamera-controlseh$]h&]uh1hhhhhhhhKj}jhsj }hhsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjBfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}f1]jasrefids}(h]haj]haj]jaj]jaj ]j aj ]j ajF]j<aj~]jtaj]jaj]jaj]jajH]j>aj]jaj]jaunameids}(jhjjj{jjzjwjjj jj j jZ j jjFjj~jjj jjnjjjHjjj#ju nametypes}(jjj{jzjj j jZ jjjj jnjjj#uh}(hhjhjjjwjjjjjj j j j jFjGj~jjjjjjjjjjHjIjjjju footnote_refs}j]jas citation_refs} autofootnotes]jaautofootnote_refs]jasymbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jKsRparse_messages]transform_messages](hsystem_message)}(hhh]h)}(hhh]h5Hyperlink target "camera-controls" is not referenced.}hj'sbah}(h]h ]h"]h$]h&]uh1hhj$ubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehnjlineKuh1j"ubj#)}(hhh]h)}(hhh]h7Hyperlink target "camera-control-id" is not referenced.}hjBsbah}(h]h ]h"]h$]h&]uh1hhj?ubah}(h]h ]h"]h$]h&]levelKtypej<sourcehnjlineKuh1j"ubj#)}(hhh]h)}(hhh]h=Hyperlink target "v4l2-exposure-auto-type" is not referenced.}hj\sbah}(h]h ]h"]h$]h&]uh1hhjYubah}(h]h ]h"]h$]h&]levelKtypej<sourcehnjlineKuh1j"ubj#)}(hhh]h)}(hhh]hHyperlink target "v4l2-image-stabilization" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypej<sourcehnjlineMIuh1j"ubj#)}(hhh]h)}(hhh]hDHyperlink target "v4l2-iso-sensitivity-auto-type" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypej<sourcehnjlineM[uh1j"ubj#)}(hhh]h)}(hhh]h5Hyperlink target "v4l2-scene-mode" is not referenced.}hj,sbah}(h]h ]h"]h$]h&]uh1hhj)ubah}(h]h ]h"]h$]h&]levelKtypej<sourcehnjlineMpuh1j"ubj#)}(hhh]h)}(hhh]hDHyperlink target "v4l2-camera-sensor-orientation" is not referenced.}hjFsbah}(h]h ]h"]h$]h&]uh1hhjCubah}(h]h ]h"]h$]h&]levelKtypej<sourcehnjlineMuh1j"ubj#)}(hhh]h)}(hhh]hAHyperlink target "v4l2-camera-sensor-rotation" is not referenced.}hj`sbah}(h]h ]h"]h$]h&]uh1hhj]ubah}(h]h ]h"]h$]h&]levelKtypej<sourcehnjlineMuh1j"ube transformerN include_log] decorationNhhub.