[libcamera-devel,v3,12/13] libcamera: v4l2_device: Update documentation

Message ID 20200424215304.558317-13-jacopo@jmondi.org
State Superseded
Headers show
Series
  • libcamera: Add CameraSensorInfo
Related show

Commit Message

Jacopo Mondi April 24, 2020, 9:53 p.m. UTC
Compound controls are now supported, but they're still listed as
unsupported in some parts of the V4L2Device class documentation.
Fix this by removing those parts.

Signed-off-by: Jacopo Mondi <jacopo@jmondi.org>
---
 src/libcamera/v4l2_device.cpp | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

Comments

Laurent Pinchart April 25, 2020, 9:05 p.m. UTC | #1
Hi Jacopo,

Thank you for the patch.

On Fri, Apr 24, 2020 at 11:53:03PM +0200, Jacopo Mondi wrote:
> Compound controls are now supported, but they're still listed as
> unsupported in some parts of the V4L2Device class documentation.
> Fix this by removing those parts.
> 
> Signed-off-by: Jacopo Mondi <jacopo@jmondi.org>

Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>

(and can be merged already)

> ---
>  src/libcamera/v4l2_device.cpp | 19 +++++++++----------
>  1 file changed, 9 insertions(+), 10 deletions(-)
> 
> diff --git a/src/libcamera/v4l2_device.cpp b/src/libcamera/v4l2_device.cpp
> index 9d67e0f63b1e..da7eb2bc5849 100644
> --- a/src/libcamera/v4l2_device.cpp
> +++ b/src/libcamera/v4l2_device.cpp
> @@ -153,9 +153,9 @@ void V4L2Device::close()
>   * their values in the corresponding \a ctrls entry.
>   *
>   * If any control in \a ctrls is not supported by the device, is disabled (i.e.
> - * has the V4L2_CTRL_FLAG_DISABLED flag set), is a compound control, or if any
> - * other error occurs during validation of the requested controls, no control is
> - * read and this method returns -EINVAL.
> + * has the V4L2_CTRL_FLAG_DISABLED flag set), or if any other error occurs
> + * during validation of the requested controls, no control is read and this
> + * method returns -EINVAL.
>   *
>   * If an error occurs while reading the controls, the index of the first control
>   * that couldn't be read is returned. The value of all controls below that index
> @@ -262,10 +262,9 @@ int V4L2Device::getControls(ControlList *ctrls)
>   * \a ctrls entry.
>   *
>   * If any control in \a ctrls is not supported by the device, is disabled (i.e.
> - * has the V4L2_CTRL_FLAG_DISABLED flag set), is read-only, is a
> - * compound control, or if any other error occurs during validation of
> - * the requested controls, no control is written and this method returns
> - * -EINVAL.
> + * has the V4L2_CTRL_FLAG_DISABLED flag set), is read-only, if any other error
> + * occurs during validation of the requested controls, no control is written and
> + * this method returns -EINVAL.
>   *
>   * If an error occurs while writing the controls, the index of the first
>   * control that couldn't be written is returned. All controls below that index
> @@ -395,7 +394,7 @@ void V4L2Device::listControls()
>  	ControlInfoMap::Map ctrls;
>  	struct v4l2_query_ext_ctrl ctrl = {};
>  
> -	/* \todo Add support for menu and compound controls. */
> +	/* \todo Add support for menu controls. */
>  	while (1) {
>  		ctrl.id |= V4L2_CTRL_FLAG_NEXT_CTRL |
>  			   V4L2_CTRL_FLAG_NEXT_COMPOUND;
> @@ -468,8 +467,8 @@ void V4L2Device::updateControls(ControlList *ctrls,
>  
>  		default:
>  			/*
> -			 * \todo To be changed when support for string and
> -			 * compound controls will be added.
> +			 * \todo To be changed when support for string controls
> +			 * will be added.
>  			 */
>  			value.set<int32_t>(v4l2Ctrl->value);
>  			break;

Patch

diff --git a/src/libcamera/v4l2_device.cpp b/src/libcamera/v4l2_device.cpp
index 9d67e0f63b1e..da7eb2bc5849 100644
--- a/src/libcamera/v4l2_device.cpp
+++ b/src/libcamera/v4l2_device.cpp
@@ -153,9 +153,9 @@  void V4L2Device::close()
  * their values in the corresponding \a ctrls entry.
  *
  * If any control in \a ctrls is not supported by the device, is disabled (i.e.
- * has the V4L2_CTRL_FLAG_DISABLED flag set), is a compound control, or if any
- * other error occurs during validation of the requested controls, no control is
- * read and this method returns -EINVAL.
+ * has the V4L2_CTRL_FLAG_DISABLED flag set), or if any other error occurs
+ * during validation of the requested controls, no control is read and this
+ * method returns -EINVAL.
  *
  * If an error occurs while reading the controls, the index of the first control
  * that couldn't be read is returned. The value of all controls below that index
@@ -262,10 +262,9 @@  int V4L2Device::getControls(ControlList *ctrls)
  * \a ctrls entry.
  *
  * If any control in \a ctrls is not supported by the device, is disabled (i.e.
- * has the V4L2_CTRL_FLAG_DISABLED flag set), is read-only, is a
- * compound control, or if any other error occurs during validation of
- * the requested controls, no control is written and this method returns
- * -EINVAL.
+ * has the V4L2_CTRL_FLAG_DISABLED flag set), is read-only, if any other error
+ * occurs during validation of the requested controls, no control is written and
+ * this method returns -EINVAL.
  *
  * If an error occurs while writing the controls, the index of the first
  * control that couldn't be written is returned. All controls below that index
@@ -395,7 +394,7 @@  void V4L2Device::listControls()
 	ControlInfoMap::Map ctrls;
 	struct v4l2_query_ext_ctrl ctrl = {};
 
-	/* \todo Add support for menu and compound controls. */
+	/* \todo Add support for menu controls. */
 	while (1) {
 		ctrl.id |= V4L2_CTRL_FLAG_NEXT_CTRL |
 			   V4L2_CTRL_FLAG_NEXT_COMPOUND;
@@ -468,8 +467,8 @@  void V4L2Device::updateControls(ControlList *ctrls,
 
 		default:
 			/*
-			 * \todo To be changed when support for string and
-			 * compound controls will be added.
+			 * \todo To be changed when support for string controls
+			 * will be added.
 			 */
 			value.set<int32_t>(v4l2Ctrl->value);
 			break;