Skip to contentSkip to conversation

v4l: uAPI doc: Simplify NATIVE_SIZE selection target documentation

PATCH In review Sakari Ailus 2 participants 2 messages Nov 8, 2018

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 v4l: uAPI doc: Simplify NATIVE_SIZE selection target documentation

The NATIVE_SIZE target is documented for mem2mem devices but no driver has ever apparently used it. It may be never needed; remove it for now.

---
 Documentation/media/uapi/v4l/v4l2-selection-targets.rst | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)
Documentation/media/uapi/v4l/v4l2-selection-targets.rst +1 -6
index 87433ec76c6b..bee31611947e 100644
@@ -42,12 +42,7 @@ of the two interfaces they are used.
     * - ``V4L2_SEL_TGT_NATIVE_SIZE``
       - 0x0003
       - The native size of the device, e.g. a sensor's pixel array.
-	``left`` and ``top`` fields are zero for this target. Setting the
-	native size will generally only make sense for memory to memory
-	devices where the software can create a canvas of a given size in
-	which for example a video frame can be composed. In that case
-	V4L2_SEL_TGT_NATIVE_SIZE can be used to configure the size of
-	that canvas.
+	``left`` and ``top`` fields are zero for this target.
       - Yes
       - Yes
     * - ``V4L2_SEL_TGT_COMPOSE``
Signature · 1 line
2.11.0
Acked-by on v1 1/1
#1 lore raw
Quoted 5 lines · Sakari Ailus

The NATIVE_SIZE target is documented for mem2mem devices but no driver has ever apparently used it. It may be never needed; remove it for now.

Thanks,

Hans

Quoted 23 lines
---
 Documentation/media/uapi/v4l/v4l2-selection-targets.rst | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)
Documentation/media/uapi/v4l/v4l2-selection-targets.rst +1 -6
index 87433ec76c6b..bee31611947e 100644
@@ -42,12 +42,7 @@ of the two interfaces they are used.
     * - ``V4L2_SEL_TGT_NATIVE_SIZE``
       - 0x0003
       - The native size of the device, e.g. a sensor's pixel array.
-	``left`` and ``top`` fields are zero for this target. Setting the
-	native size will generally only make sense for memory to memory
-	devices where the software can create a canvas of a given size in
-	which for example a video frame can be composed. In that case
-	V4L2_SEL_TGT_NATIVE_SIZE can be used to configure the size of
-	that canvas.
+	``left`` and ``top`` fields are zero for this target.
       - Yes
       - Yes
     * - ``V4L2_SEL_TGT_COMPOSE``