[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>

diff --git a/Documentation/DocBook/media/v4l/selections-common.xml b/Documentation/DocBook/media/v4l/selections-common.xml
index 7502f78..d6d56fb 100644 (file)
--- a/Documentation/DocBook/media/v4l/selections-common.xml
+++ b/Documentation/DocBook/media/v4l/selections-common.xml
@@ -62,6 +62,22 @@
            <entry>Yes</entry>
            <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>

diff --git a/include/uapi/linux/v4l2-common.h b/include/uapi/linux/v4l2-common.h
index 2f6f8ca..1527398 100644 (file)
--- 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 */