OSDN Git Service

API: add support for raw DRM.
[android-x86/hardware-intel-common-libva.git] / va / va_backend.h
index cd6201e..b6b651c 100644 (file)
 #define _VA_BACKEND_H_
 
 #include <va/va.h>
-#include <X11/Xlib.h>
 #include <linux/videodev2.h>
-#include <ui/Surface.h>
-
-class Surface;
 
 typedef struct VADriverContext *VADriverContextP;
 typedef struct VADisplayContext *VADisplayContextP;
 
+/** \brief VA display types. */
+enum {
+    /** \brief Mask to major identifier for VA display type. */
+    VA_DISPLAY_MAJOR_MASK = 0xf0,
+
+    /** \brief VA/X11 API is used, through vaGetDisplay() entry-point. */
+    VA_DISPLAY_X11      = 0x10,
+    /** \brief VA/GLX API is used, through vaGetDisplayGLX() entry-point. */
+    VA_DISPLAY_GLX      = (VA_DISPLAY_X11 | (1 << 0)),
+    /** \brief VA/Android API is used, through vaGetDisplay() entry-point. */
+    VA_DISPLAY_ANDROID  = 0x20,
+    /** \brief VA/DRM API is used, through vaGetDisplayDRM() entry-point. */
+    VA_DISPLAY_DRM      = 0x30,
+};
+
 struct VADriverVTable
 {
        VAStatus (*vaTerminate) ( VADriverContextP ctx );
@@ -179,10 +190,17 @@ struct VADriverVTable
                VASurfaceStatus *status /* out */
        );
 
+       VAStatus (*vaQuerySurfaceError) (
+               VADriverContextP ctx,
+               VASurfaceID render_target,
+                VAStatus error_status,
+                void **error_info /*out*/
+       );
+
        VAStatus (*vaPutSurface) (
                VADriverContextP ctx,
                VASurfaceID surface,
-               Surface* draw, /* X Drawable */
+               void* draw, /* Drawable of window system */
                short srcx,
                short srcy,
                unsigned short srcw,
@@ -339,33 +357,17 @@ struct VADriverVTable
                 int num_attributes
         );
 
-        /* device specific */
-       VAStatus (*vaCreateSurfaceFromCIFrame) (
-               VADriverContextP ctx,
-               unsigned long frame_id,
-               VASurfaceID *surface            /* out */
-       );
-    
-    
-        VAStatus (*vaCreateSurfaceFromV4L2Buf) (
-               VADriverContextP ctx,
-                int v4l2_fd,         /* file descriptor of V4L2 device */
-                struct v4l2_format *v4l2_fmt,       /* format of V4L2 */
-                struct v4l2_buffer *v4l2_buf,       /* V4L2 buffer */
-                VASurfaceID *surface              /* out */
-        );
-
+        /* used by va trace */        
         VAStatus (*vaBufferInfo) (
-                   VADriverContextP ctx,
-                   VAContextID context, /* in */
-                   VABufferID buf_id, /* in */
-                   VABufferType *type,    /* out */
-                   unsigned int *size,    /* out */
+                   VADriverContextP ctx,      /* in */
+                   VABufferID buf_id,         /* in */
+                   VABufferType *type,        /* out */
+                   unsigned int *size,        /* out */
                    unsigned int *num_elements /* out */
         );
 
-    
-        VAStatus (*vaCopySurfaceToBuffer) (
+        /* lock/unlock surface for external access */    
+        VAStatus (*vaLockSurface) (
                VADriverContextP ctx,
                 VASurfaceID surface,
                 unsigned int *fourcc, /* out  for follow argument */
@@ -375,14 +377,57 @@ struct VADriverVTable
                 unsigned int *luma_offset,
                 unsigned int *chroma_u_offset,
                 unsigned int *chroma_v_offset,
-                void **buffer
+                unsigned int *buffer_name, /* if it is not NULL, assign the low lever
+                                            * surface buffer name
+                                            */
+                void **buffer /* if it is not NULL, map the surface buffer for
+                                * CPU access
+                                */
+        );
+    
+        VAStatus (*vaUnlockSurface) (
+               VADriverContextP ctx,
+                VASurfaceID surface
         );
 };
 
 struct VADriverContext
 {
     void *pDriverData;
-    struct VADriverVTable vtable;
+
+    /**
+     * The core VA implementation hooks.
+     *
+     * This structure is allocated from libva with calloc().
+     */
+    struct VADriverVTable *vtable;
+
+    /**
+     * The VA/GLX implementation hooks.
+     *
+     * This structure is intended for drivers that implement the
+     * VA/GLX API. The driver implementation is responsible for the
+     * allocation and deallocation of this structure.
+     */
+    struct VADriverVTableGLX *vtable_glx;
+
+    /**
+     * The VA/EGL implementation hooks.
+     *
+     * This structure is intended for drivers that implement the
+     * VA/EGL API. The driver implementation is responsible for the
+     * allocation and deallocation of this structure.
+     */
+    struct VADriverVTableEGL *vtable_egl;
+
+    /**
+     * The third-party/private implementation hooks.
+     *
+     * This structure is intended for drivers that implement the
+     * private API. The driver implementation is responsible for the
+     * allocation and deallocation of this structure.
+     */
+    void *vtable_tpi;
 
     void *native_dpy;
     int x11_screen;
@@ -397,8 +442,27 @@ struct VADriverContext
     const char *str_vendor;
 
     void *handle;                      /* dlopen handle */
-    
-    void *dri_state;
+
+    /**
+     * \brief DRM state.
+     *
+     * This field holds driver specific data for DRM-based
+     * drivers. This structure is allocated from libva with
+     * calloc(). Do not deallocate from within VA driver
+     * implementations.
+     *
+     * All structures shall be derived from struct drm_state. So, for
+     * instance, this field holds a dri_state structure for VA/X11
+     * drivers that use the DRM protocol.
+     */
+    void *drm_state;
+
+    void *glx;                         /* opaque for GLX code */
+
+    /** \brief VA display type. */
+    unsigned long display_type;
+
+    unsigned long reserved[44];         /* reserve for future add-ins, decrease the subscript accordingly */
 };
 
 #define VA_DISPLAY_MAGIC 0x56414430 /* VAD0 */
@@ -421,11 +485,12 @@ struct VADisplayContext
        VADisplayContextP ctx,
        char **driver_name
     );
+
+    void *opaque; /* opaque for display extensions (e.g. GLX) */
 };
 
 typedef VAStatus (*VADriverInit) (
     VADriverContextP driver_context
 );
 
-
 #endif /* _VA_BACKEND_H_ */