Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit bf587eff authored by Hans Verkuil's avatar Hans Verkuil Committed by Mauro Carvalho Chehab
Browse files

[media] vidioc-queryctrl.rst: document V4L2_CTRL_FLAG_MODIFY_LAYOUT 



Document this new control flag.

Signed-off-by: default avatarHans Verkuil <hans.verkuil@cisco.com>
Acked-by: default avatarSakari Ailus <sakari.ailus@linux.intel.com>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent 0ac702d5

Documentation/media/uapi/v4l/vidioc-queryctrl.rst

+13 −0
Original line number Diff line number Diff line
@@ -507,6 +507,19 @@ See also the examples in :ref:`control`. 
	represents an action on the hardware. For example: clearing an

	error flag or triggering the flash. All the controls of the type

	``V4L2_CTRL_TYPE_BUTTON`` have this flag set.

    * .. _FLAG_MODIFY_LAYOUT:



      - ``V4L2_CTRL_FLAG_MODIFY_LAYOUT``

      - 0x0400

      - Changing this control value may modify the layout of the

        buffer (for video devices) or the media bus format (for sub-devices).



	A typical example would be the ``V4L2_CID_ROTATE`` control.



	Note that typically controls with this flag will also set the

	``V4L2_CTRL_FLAG_GRABBED`` flag when buffers are allocated or

	streaming is in progress since most drivers do not support changing

	the format in that case.





Return Value

Documentation/media/videodev2.h.rst.exceptions

+1 −0
Original line number Diff line number Diff line
@@ -341,6 +341,7 @@ replace define V4L2_CTRL_FLAG_WRITE_ONLY control-flags 
replace define V4L2_CTRL_FLAG_VOLATILE control-flags

replace define V4L2_CTRL_FLAG_HAS_PAYLOAD control-flags

replace define V4L2_CTRL_FLAG_EXECUTE_ON_WRITE control-flags

replace define V4L2_CTRL_FLAG_MODIFY_LAYOUT control-flags



replace define V4L2_CTRL_FLAG_NEXT_CTRL control

replace define V4L2_CTRL_FLAG_NEXT_COMPOUND control