[media] v4l: Add V4L2_SEL_TGT_NATIVE_SIZE selection target

The V4L2_SEL_TGT_NATIVE_SIZE target is used to denote e.g. the size of a
sensor's pixel array.

Signed-off-by: Sakari Ailus <sakari.ailus@iki.fi>
Acked-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>

2 files changed, 18 insertions, 0 deletions

diff --git a/Documentation/DocBook/media/v4l/selections-common.xml b/Documentation/DocBook/media/v4l/selections-common.xml
index 7502f784b8cc..d6d56fb6f9c0 100644
--- a/Documentation/DocBook/media/v4l/selections-common.xml
+++ b/Documentation/DocBook/media/v4l/selections-common.xml
@@ -63,6 +63,22 @@
             <entry>Yes</entry>
           </row>
           <row>
+            <entry><constant>V4L2_SEL_TGT_NATIVE_SIZE</constant></entry>
+            <entry>0x0003</entry>
+            <entry>The native size of the device, e.g. a sensor's
+            pixel array. <structfield>left</structfield> and
+            <structfield>top</structfield> 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.
+            </entry>
+            <entry>Yes</entry>
+            <entry>Yes</entry>
+          </row>
+          <row>
             <entry><constant>V4L2_SEL_TGT_COMPOSE</constant></entry>
             <entry>0x0100</entry>
             <entry>Compose rectangle. Used to configure scaling
diff --git a/include/uapi/linux/v4l2-common.h b/include/uapi/linux/v4l2-common.h
index 2f6f8cafe773..15273987093e 100644
--- a/include/uapi/linux/v4l2-common.h
+++ b/include/uapi/linux/v4l2-common.h
@@ -43,6 +43,8 @@
 #define V4L2_SEL_TGT_CROP_DEFAULT       0x0001
 /* Cropping bounds */
 #define V4L2_SEL_TGT_CROP_BOUNDS        0x0002
+/* Native frame size */
+#define V4L2_SEL_TGT_NATIVE_SIZE        0x0003
 /* Current composing area */
 #define V4L2_SEL_TGT_COMPOSE            0x0100
 /* Default composing area */