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
61 #define CTX(dpy) (((VADisplayContextP)dpy)->pDriverContext)
62 #define CHECK_DISPLAY(dpy) if( !vaDisplayIsValid(dpy) ) { return VA_STATUS_ERROR_INVALID_DISPLAY; }
63
vaGetEGLClientBufferFromSurface(VADisplay dpy,VASurfaceID surface,EGLClientBuffer * buffer)64 VAStatus vaGetEGLClientBufferFromSurface (
65 VADisplay dpy,
66 VASurfaceID surface,
67 EGLClientBuffer *buffer /* out*/
68 )
69 {
70 VADriverContextP ctx;
71 struct VADriverVTableEGL *va_egl;
72 CHECK_DISPLAY(dpy);
73 ctx = CTX(dpy);
74
75 va_egl = (struct VADriverVTableEGL *)ctx->vtable_egl;
76 if (va_egl && va_egl->vaGetEGLClientBufferFromSurface) {
77 return va_egl->vaGetEGLClientBufferFromSurface(ctx, surface, buffer);
78 } else
79 return VA_STATUS_ERROR_UNIMPLEMENTED;
80 }
81
82
83