media/v4l/vidioc-g-ext-ctrls.rst

13 …OC_S_EXT_CTRLS - VIDIOC_TRY_EXT_CTRLS - Get or set the value of several controls, try control valu…
42 These ioctls allow the caller to get or set multiple controls
44 :ref:`ctrl-class`) and all controls in the control array must belong
47 Applications must always fill in the ``count``, ``which``, ``controls``
51 by the ``controls`` fields.
53 To get the current value of a set of controls applications initialize
56 :ref:`VIDIOC_G_EXT_CTRLS <VIDIOC_G_EXT_CTRLS>` ioctl. String controls must also set the
57 ``string`` field. Controls of compound types
61 relevant for pointer-type controls like strings), then the driver will
75 To change the value of a set of controls applications initialize the
78 the :ref:`VIDIOC_S_EXT_CTRLS <VIDIOC_G_EXT_CTRLS>` ioctl. The controls will only be set if *all*
81 To check if a set of controls have correct values applications
99 then the controls are not applied immediately when calling
112 values of the controls at the time of request completion.
116 The driver will only set/get these controls if all control values are
117 correct. This prevents the situation where only some of the controls
143 	controls this should be set to the size of the memory that contains
152 	   For string controls, this ``size`` field should
356 	control types support this. For controls with compound types, the
363 	(see :ref:`ctrl-class`). In that case all controls have to
378       - The number of controls in the controls array. May also be zero.
389 	Before controls are read from/written to hardware a validation
390 	step takes place: this checks if all controls in the list are
391 	valid controls, if no attempt is made to write to a read-only
411 	``error_idx`` is less than ``count`` and only the controls up to
413 	the remaining controls is undefined.
436       - ``controls``
454       - The class containing user controls. These controls are described
455 	in :ref:`control`. All controls that can be set using the
461       - The class containing stateful codec controls. These controls are
462 	described in :ref:`codec-controls`.
465       - The class containing camera controls. These controls are described
466 	in :ref:`camera-controls`.
469       - The class containing FM Transmitter (FM TX) controls. These
470 	controls are described in :ref:`fm-tx-controls`.
473       - The class containing flash device controls. These controls are
474 	described in :ref:`flash-controls`.
477       - The class containing JPEG compression controls. These controls are
478 	described in :ref:`jpeg-controls`.
481       - The class containing image source controls. These controls are
482 	described in :ref:`image-source-controls`.
485       - The class containing image processing controls. These controls are
486 	described in :ref:`image-process-controls`.
489       - The class containing FM Receiver (FM RX) controls. These controls
490 	are described in :ref:`fm-rx-controls`.
493       - The class containing RF tuner controls. These controls are
494 	described in :ref:`rf-tuner-controls`.
497       - The class containing motion or object detection controls. These controls
498         are described in :ref:`detect-controls`.
501       - The class containing stateless codec controls. These controls are
502 	described in :ref:`codec-stateless-controls`.
505       - The class containing colorimetry controls. These controls are
506 	described in :ref:`colorimetry-controls`.