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.ai...@iki.fi>
---
since v2:
- Add a note on s_selection support for native selection target on mem2mem
  devices only.
- Reverse the order or left and top fields, i.e. make it the same as in
  struct v4l2_rect.

 Documentation/DocBook/media/v4l/selections-common.xml |   16 ++++++++++++++++
 include/uapi/linux/v4l2-common.h                      |    2 ++
 2 files changed, 18 insertions(+)

diff --git a/Documentation/DocBook/media/v4l/selections-common.xml 
b/Documentation/DocBook/media/v4l/selections-common.xml
index 7502f78..d6d56fb 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 2f6f8ca..1527398 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 */
-- 
1.7.10.4

--
To unsubscribe from this list: send the line "unsubscribe linux-media" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to