va/egl/va_egl.c

   1 /*
   2  * Copyright (c) 2007 Intel Corporation. All Rights Reserved.
   3  *
   4  * Permission is hereby granted, free of charge, to any person obtaining a
   5  * copy of this software and associated documentation files (the
   6  * "Software"), to deal in the Software without restriction, including
   7  * without limitation the rights to use, copy, modify, merge, publish,
   8  * distribute, sub license, and/or sell copies of the Software, and to
   9  * permit persons to whom the Software is furnished to do so, subject to
  10  * the following conditions:
  11  *
  12  * The above copyright notice and this permission notice (including the
  13  * next paragraph) shall be included in all copies or substantial portions
  14  * of the Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  17  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  18  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
  19  * IN NO EVENT SHALL PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR
  20  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
  21  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
  22  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  23  */
  24
  25 /*
  26  * Initial EGL backend, and subject to change
  27  *
  28  * Gstreamer gst-gltexture has a framework to support associating a buffer
  29  * to a texture via EGL_KHR_image_base and GL_OES_EGL_image_external.
  30  *
  31  * EGL_KHR_image_base:
  32  *   EGLImageKHR eglCreateImageKHR(
  33  *                           EGLDisplay dpy,
  34  *                           EGLContext ctx,
  35  *                           EGLenum target,
  36  *                           EGLClientBuffer buffer,
  37  *                           const EGLint *attrib_list)
  38  *
  39  * GL_OES_EGL_image_external:
  40  * This extension provides a mechanism for creating EGLImage texture targets
  41  * from EGLImages.  This extension defines a new texture target TEXTURE_EXTERNAL_OES.
  42  * This texture target can only be specified using an EGLImage.
  43  * The first eglCreateImageKHR will create an EGLImage from an EGLClientBufferm, and with
  44  * an EGLImage, gst-gltexture can use GL_OES_EGL_image_external extension to create textures.
  45  *
  46  * eglCreateImageKHR and GL_OES_EGL_image_external are all called directly from gst-gltexture,
  47  * thus the simplest way to support gst-gltexture is defining a new API to pass EGLClientBuffer
  48  * to gst-gltexture.
  49  *
  50  * EGLClientBuffer is gfx/video driver implementation specific (?). It means we need to pass up
  51  * the low-level buffer ID (or handle) of the decoded surface to gst-gltexture, and gst-gltexture
  52  * then pass down it to gfx driver.
  53  *
  54  * Bellow API vaGetEGLClientBufferFromSurface is for this purpose
  55  */
  56
  57 #include "va.h"
  58 #include "va_backend_egl.h"
  59 #include "va_egl.h"
  60 #include "va_internal.h"
  61
  62
  63 VAStatus vaGetEGLClientBufferFromSurface (
  64     VADisplay dpy,
  65     VASurfaceID surface,
  66     EGLClientBuffer *buffer /* out*/
  67 )
  68 {
  69   VADriverContextP ctx;
  70   struct VADriverVTableEGL *va_egl;
  71   CHECK_DISPLAY(dpy);
  72   ctx = CTX(dpy);
  73
  74   va_egl = (struct VADriverVTableEGL *)ctx->vtable_egl;
  75   if (va_egl && va_egl->vaGetEGLClientBufferFromSurface) {
  76       return va_egl->vaGetEGLClientBufferFromSurface(ctx, surface, buffer);
  77   } else
  78       return VA_STATUS_ERROR_UNIMPLEMENTED;
  79 }
  80
  81