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
338 	these controls have to be retrieved from a request or tried/set for
347 	(see :ref:`ctrl-class`). In that case all controls have to
362       - The number of controls in the controls array. May also be zero.
373 	Before controls are read from/written to hardware a validation
374 	step takes place: this checks if all controls in the list are
375 	valid controls, if no attempt is made to write to a read-only
395 	``error_idx`` is less than ``count`` and only the controls up to
397 	the remaining controls is undefined.
420       - ``controls``
438       - The class containing user controls. These controls are described
439 	in :ref:`control`. All controls that can be set using the
445       - The class containing stateful codec controls. These controls are
446 	described in :ref:`codec-controls`.
449       - The class containing camera controls. These controls are described
450 	in :ref:`camera-controls`.
453       - The class containing FM Transmitter (FM TX) controls. These
454 	controls are described in :ref:`fm-tx-controls`.
457       - The class containing flash device controls. These controls are
458 	described in :ref:`flash-controls`.
461       - The class containing JPEG compression controls. These controls are
462 	described in :ref:`jpeg-controls`.
465       - The class containing image source controls. These controls are
466 	described in :ref:`image-source-controls`.
469       - The class containing image processing controls. These controls are
470 	described in :ref:`image-process-controls`.
473       - The class containing FM Receiver (FM RX) controls. These controls
474 	are described in :ref:`fm-rx-controls`.
477       - The class containing RF tuner controls. These controls are
478 	described in :ref:`rf-tuner-controls`.
481       - The class containing motion or object detection controls. These controls
482         are described in :ref:`detect-controls`.
485       - The class containing stateless codec controls. These controls are
486 	described in :ref:`codec-stateless-controls`.
489       - The class containing colorimetry controls. These controls are
490 	described in :ref:`colorimetry-controls`.