From: Jonathan Bian <jonathan.bian@intel.com>
Date: Thu, 6 Sep 2012 23:07:31 +0000 (-0700)
Subject: Added new surface attributes to enable VA surface creation from external buffers.
X-Git-Tag: accepted/2.0/20130307.024053~27
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=e97317ac41907d7f5fe8ca74f1d94a404de04387;p=profile%2Fivi%2Flibva.git

Added new surface attributes to enable VA surface creation from external buffers.
---

diff --git a/va/va.h b/va/va.h
index 316b2ae..c498dc8 100644
--- a/va/va.h
+++ b/va/va.h
@@ -646,7 +646,7 @@ typedef enum {
      * zero and drops the \c VA_SURFACE_ATTRIB_SETTABLE flag.
      */
     VASurfaceAttribPixelFormat,
-    /** \brief Minimal width in pixels (int, read/write). */
+    /** \brief Minimal width in pixels (int, read-only). */
     VASurfaceAttribMinWidth,
     /** \brief Maximal width in pixels (int, read-only). */
     VASurfaceAttribMaxWidth,
@@ -654,6 +654,10 @@ typedef enum {
     VASurfaceAttribMinHeight,
     /** \brief Maximal height in pixels (int, read-only). */
     VASurfaceAttribMaxHeight,
+    /** \brief Surface memory type in fourcc (int, read/write). */
+    VASurfaceAttribMemoryType,
+    /** \brief External buffer descriptor (pointer, write). */
+    VASurfaceAttribExternalBufferDescriptor,
     /** \brief Number of surface attributes. */
     VASurfaceAttribCount
 } VASurfaceAttribType;
@@ -668,6 +672,51 @@ typedef struct _VASurfaceAttrib {
     VAGenericValue      value;
 } VASurfaceAttrib;
 
+/** @name VASurfaceAttribMemoryType values in fourcc */
+/**@{*/
+/** \brief VA memory type (default) is supported. VAVA in fourcc */
+#define VA_SURFACE_ATTRIB_MEM_TYPE_VA			0x41564156
+/** \brief V4L2 buffer memory type is supported. V4L2 in fourcc */
+#define VA_SURFACE_ATTRIB_MEM_TYPE_V4L2			0x324C3456
+/** \brief User pointer memory type is supported. UPTR in fourcc */
+#define VA_SURFACE_ATTRIB_MEM_TYPE_USER_PTR		0x52545055
+/**@}*/
+
+/** 
+ * \brief VASurfaceAttribExternalBuffers structure for 
+ * the VASurfaceAttribExternalBufferDescriptor attribute.
+ */
+typedef struct _VASurfaceAttribExternalBuffers {
+    /** \brief pixel format in fourcc. */
+    unsigned int pixel_format;
+    /** \brief width in pixels. */
+    unsigned int width;
+    /** \brief height in pixels. */
+    unsigned int height;
+    /** \brief total size of the buffer in bytes. */
+    unsigned int data_size;
+    /** \brief number of planes for planar layout */
+    unsigned int num_planes;
+    /** \brief pitch for each plane in bytes */
+    unsigned int pitches[4];
+    /** \brief offset for each plane in bytes */
+    unsigned int offsets[4];
+    /** \brief buffer handles or user pointers */
+    unsigned long *buffers;
+    /** \brief number of elements in the "buffers" array */
+    unsigned int num_buffers;
+    /** \brief flags. See "Surface external buffer descriptor flags". */
+    unsigned int flags;
+    /** \brief reserved for passing private data */
+    void *private_data;
+} VASurfaceAttribExternalBuffers;
+
+/** @name VASurfaceAttribExternalBuffers flags */
+/**@{*/
+/** \brief Enable memory tiling */
+#define VA_SURFACE_EXTBUF_DESC_ENABLE_TILING	0x00000001
+/**@}*/
+
 /**
  * \brief Get surface attributes for the supplied config.
  *
diff --git a/va/va_android.h b/va/va_android.h
index ca73b84..a9a8e52 100644
--- a/va/va_android.h
+++ b/va/va_android.h
@@ -26,6 +26,9 @@
 
 #include <va/va.h>
 
+/** \brief Android Gralloc buffer memory type "AGRA" in fourcc */
+#define VA_SURFACE_ATTRIB_MEM_TYPE_ANDROID_GRALLOC	0x41524741
+
 #ifdef __cplusplus
 extern "C" {
 #endif
diff --git a/va/va_drmcommon.h b/va/va_drmcommon.h
index bb00fd4..47dd371 100644
--- a/va/va_drmcommon.h
+++ b/va/va_drmcommon.h
@@ -68,4 +68,9 @@ struct drm_state {
     int         auth_type;
 };
 
+/** \brief Kernel DRM buffer memory type "KDRM" in fourcc */
+#define VA_SURFACE_ATTRIB_MEM_TYPE_KERNEL_DRM		0x4D52444B
+/** \brief DRM PRIME memory type "DPRI" in fourcc */
+#define VA_SURFACE_ATTRIB_MEM_TYPE_DRM_PRIME		0x49525044
+
 #endif /* VA_DRM_COMMON_H */