X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=Documentation%2FDocBook%2Fmedia%2Fv4l%2Fpixfmt.xml;h=75882a4b4d3d44fa03dde584a4d652dfa47b42ad;hb=52839bfb0c4b56b5c2688c96ce656df4034b2c87;hp=72d72bd67d0a9eb00836b5495a0b9e6c4821d5f3;hpb=7b77d161ce7e480a660692cab079712fc0268ba2;p=platform%2Fadaptation%2Frenesas_rcar%2Frenesas_kernel.git
diff --git a/Documentation/DocBook/media/v4l/pixfmt.xml b/Documentation/DocBook/media/v4l/pixfmt.xml
index 72d72bd..75882a4 100644
--- a/Documentation/DocBook/media/v4l/pixfmt.xml
+++ b/Documentation/DocBook/media/v4l/pixfmt.xml
@@ -103,9 +103,34 @@ see .
__u32priv
- Reserved for custom (driver defined) additional
-information about formats. When not used drivers and applications must
-set this field to zero.
+ This field indicates whether the remaining fields of the
+v4l2_pix_format structure, also called the extended
+fields, are valid. When set to V4L2_PIX_FMT_PRIV_MAGIC, it
+indicates that the extended fields have been correctly initialized. When set to
+any other value it indicates that the extended fields contain undefined values.
+
+Applications that wish to use the pixel format extended fields must first
+ensure that the feature is supported by querying the device for the
+V4L2_CAP_EXT_PIX_FORMAT
+capability. If the capability isn't set the pixel format extended fields are not
+supported and using the extended fields will lead to undefined results.
+To use the extended fields, applications must set the
+priv field to
+V4L2_PIX_FMT_PRIV_MAGIC, initialize all the extended fields
+and zero the unused bytes of the v4l2_format
+raw_data field.
+When the priv field isn't set to
+V4L2_PIX_FMT_PRIV_MAGIC drivers must act as if all the
+extended fields were set to zero. On return drivers must set the
+priv field to
+V4L2_PIX_FMT_PRIV_MAGIC and all the extended field to
+applicable values.
+
+
+ __u32
+ flags
+ Flags set by the application or driver, see .
@@ -192,9 +217,15 @@ codes can be used.
and the number of valid entries in the
plane_fmt array.
+
+ __u8
+ flags
+ Flags set by the application or driver, see .
+ __u8
- reserved[11]
+ reserved[10]Reserved for future extensions. Should be zeroed by the
application.
@@ -1040,4 +1071,18 @@ concatenated to form the JPEG stream.
+
+
+ Format Flags
+
+ &cs-def;
+
+
+ V4L2_PIX_FMT_FLAG_PREMUL_ALPHA
+ 0x00000001
+ The pixel values are premultiplied by the alpha channel value.
+
+
+
+