src/egl/main/egldriver.h

   1 /**************************************************************************
   2  *
   3  * Copyright 2008 VMware, Inc.
   4  * Copyright 2009-2010 Chia-I Wu <olvaffe@gmail.com>
   5  * Copyright 2010-2011 LunarG, Inc.
   6  * All Rights Reserved.
   7  *
   8  * Permission is hereby granted, free of charge, to any person obtaining a
   9  * copy of this software and associated documentation files (the
  10  * "Software"), to deal in the Software without restriction, including
  11  * without limitation the rights to use, copy, modify, merge, publish,
  12  * distribute, sub license, and/or sell copies of the Software, and to
  13  * permit persons to whom the Software is furnished to do so, subject to
  14  * the following conditions:
  15  *
  16  * The above copyright notice and this permission notice (including the
  17  * next paragraph) shall be included in all copies or substantial portions
  18  * of the Software.
  19  *
  20  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  21  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  22  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  23  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  24  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  25  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  26  * DEALINGS IN THE SOFTWARE.
  27  *
  28  **************************************************************************/
  29
  30
  31 #ifndef EGLDRIVER_INCLUDED
  32 #define EGLDRIVER_INCLUDED
  33
  34
  35 #include "c99_compat.h"
  36
  37 #include "egltypedefs.h"
  38 #include <stdbool.h>
  39 #include <stddef.h>
  40
  41
  42 #ifdef __cplusplus
  43 extern "C" {
  44 #endif
  45
  46 /**
  47  * Define an inline driver typecast function.
  48  *
  49  * Note that this macro defines a function and should not be ended with a
  50  * semicolon when used.
  51  */
  52 #define _EGL_DRIVER_TYPECAST(drvtype, egltype, code)           \
  53    static inline struct drvtype *drvtype(const egltype *obj)   \
  54    { return (struct drvtype *) code; }
  55
  56
  57 /**
  58  * Define the driver typecast functions for _EGLDisplay,
  59  * _EGLContext, _EGLSurface, and _EGLConfig.
  60  *
  61  * Note that this macro defines several functions and should not be ended with
  62  * a semicolon when used.
  63  */
  64 #define _EGL_DRIVER_STANDARD_TYPECASTS(drvname)                            \
  65    /* note that this is not a direct cast */                               \
  66    _EGL_DRIVER_TYPECAST(drvname ## _display, _EGLDisplay, obj->DriverData) \
  67    _EGL_DRIVER_TYPECAST(drvname ## _context, _EGLContext, obj)             \
  68    _EGL_DRIVER_TYPECAST(drvname ## _surface, _EGLSurface, obj)             \
  69    _EGL_DRIVER_TYPECAST(drvname ## _config, _EGLConfig, obj)
  70
  71 /**
  72  * A generic function ptr type
  73  */
  74 typedef void (*_EGLProc)(void);
  75
  76 struct wl_display;
  77 struct mesa_glinterop_device_info;
  78 struct mesa_glinterop_export_in;
  79 struct mesa_glinterop_export_out;
  80
  81 /**
  82  * The API dispatcher jumps through these functions
  83  */
  84 struct _egl_driver
  85 {
  86    /* driver funcs */
  87    EGLBoolean (*Initialize)(_EGLDisplay *disp);
  88    EGLBoolean (*Terminate)(_EGLDisplay *disp);
  89    const char *(*QueryDriverName)(_EGLDisplay *disp);
  90    char *(*QueryDriverConfig)(_EGLDisplay *disp);
  91
  92    /* context funcs */
  93    _EGLContext *(*CreateContext)(_EGLDisplay *disp, _EGLConfig *config,
  94                                  _EGLContext *share_list, const EGLint *attrib_list);
  95    EGLBoolean (*DestroyContext)(_EGLDisplay *disp, _EGLContext *ctx);
  96    /* this is the only function (other than Initialize) that may be called
  97     * with an uninitialized display
  98     */
  99    EGLBoolean (*MakeCurrent)(_EGLDisplay *disp,
 100                              _EGLSurface *draw, _EGLSurface *read,
 101                              _EGLContext *ctx);
 102
 103    /* surface funcs */
 104    _EGLSurface *(*CreateWindowSurface)(_EGLDisplay *disp, _EGLConfig *config,
 105                                        void *native_window, const EGLint *attrib_list);
 106    _EGLSurface *(*CreatePixmapSurface)(_EGLDisplay *disp, _EGLConfig *config,
 107                                        void *native_pixmap, const EGLint *attrib_list);
 108    _EGLSurface *(*CreatePbufferSurface)(_EGLDisplay *disp, _EGLConfig *config,
 109                                         const EGLint *attrib_list);
 110    EGLBoolean (*DestroySurface)(_EGLDisplay *disp, _EGLSurface *surface);
 111    EGLBoolean (*QuerySurface)(_EGLDisplay *disp, _EGLSurface *surface,
 112                               EGLint attribute, EGLint *value);
 113    EGLBoolean (*BindTexImage)(_EGLDisplay *disp, _EGLSurface *surface,
 114                               EGLint buffer);
 115    EGLBoolean (*ReleaseTexImage)(_EGLDisplay *disp, _EGLSurface *surface,
 116                                  EGLint buffer);
 117    EGLBoolean (*SwapInterval)(_EGLDisplay *disp, _EGLSurface *surf,
 118                               EGLint interval);
 119    EGLBoolean (*SwapBuffers)(_EGLDisplay *disp, _EGLSurface *draw);
 120    EGLBoolean (*CopyBuffers)(_EGLDisplay *disp, _EGLSurface *surface,
 121                              void *native_pixmap_target);
 122    EGLBoolean (*SetDamageRegion)(_EGLDisplay *disp, _EGLSurface *surface,
 123                                  EGLint *rects, EGLint n_rects);
 124
 125    /* misc functions */
 126    EGLBoolean (*WaitClient)(_EGLDisplay *disp, _EGLContext *ctx);
 127    EGLBoolean (*WaitNative)(EGLint engine);
 128
 129    /* this function may be called from multiple threads at the same time */
 130    _EGLProc (*GetProcAddress)(const char *procname);
 131
 132    _EGLImage *(*CreateImageKHR)(_EGLDisplay *disp, _EGLContext *ctx,
 133                                 EGLenum target, EGLClientBuffer buffer,
 134                                 const EGLint *attr_list);
 135    EGLBoolean (*DestroyImageKHR)(_EGLDisplay *disp, _EGLImage *image);
 136
 137    _EGLSync *(*CreateSyncKHR)(_EGLDisplay *disp, EGLenum type,
 138                               const EGLAttrib *attrib_list);
 139    EGLBoolean (*DestroySyncKHR)(_EGLDisplay *disp, _EGLSync *sync);
 140    EGLint (*ClientWaitSyncKHR)(_EGLDisplay *disp, _EGLSync *sync,
 141                                EGLint flags, EGLTime timeout);
 142    EGLint (*WaitSyncKHR)(_EGLDisplay *disp, _EGLSync *sync);
 143    EGLBoolean (*SignalSyncKHR)(_EGLDisplay *disp, _EGLSync *sync, EGLenum mode);
 144    EGLint (*DupNativeFenceFDANDROID)(_EGLDisplay *disp, _EGLSync *sync);
 145
 146    EGLBoolean (*SwapBuffersRegionNOK)(_EGLDisplay *disp, _EGLSurface *surf,
 147                                       EGLint numRects, const EGLint *rects);
 148
 149    _EGLImage *(*CreateDRMImageMESA)(_EGLDisplay *disp, const EGLint *attr_list);
 150    EGLBoolean (*ExportDRMImageMESA)(_EGLDisplay *disp, _EGLImage *img,
 151                                     EGLint *name, EGLint *handle,
 152                                     EGLint *stride);
 153
 154    EGLBoolean (*BindWaylandDisplayWL)(_EGLDisplay *disp, struct wl_display *display);
 155    EGLBoolean (*UnbindWaylandDisplayWL)(_EGLDisplay *disp, struct wl_display *display);
 156    EGLBoolean (*QueryWaylandBufferWL)(_EGLDisplay *displ, struct wl_resource *buffer,
 157                                       EGLint attribute, EGLint *value);
 158    struct wl_buffer *(*CreateWaylandBufferFromImageWL)(_EGLDisplay *disp, _EGLImage *img);
 159
 160    EGLBoolean (*SwapBuffersWithDamageEXT)(_EGLDisplay *disp, _EGLSurface *surface,
 161                                           const EGLint *rects, EGLint n_rects);
 162
 163    EGLBoolean (*PostSubBufferNV)(_EGLDisplay *disp, _EGLSurface *surface,
 164                                  EGLint x, EGLint y, EGLint width, EGLint height);
 165
 166    EGLint (*QueryBufferAge)(_EGLDisplay *disp, _EGLSurface *surface);
 167    EGLBoolean (*GetSyncValuesCHROMIUM)(_EGLDisplay *disp, _EGLSurface *surface,
 168                                        EGLuint64KHR *ust, EGLuint64KHR *msc,
 169                                        EGLuint64KHR *sbc);
 170
 171    EGLBoolean (*ExportDMABUFImageQueryMESA)(_EGLDisplay *disp, _EGLImage *img,
 172                                             EGLint *fourcc, EGLint *nplanes,
 173                                             EGLuint64KHR *modifiers);
 174    EGLBoolean (*ExportDMABUFImageMESA)(_EGLDisplay *disp, _EGLImage *img,
 175                                        EGLint *fds, EGLint *strides,
 176                                        EGLint *offsets);
 177
 178    int (*GLInteropQueryDeviceInfo)(_EGLDisplay *disp, _EGLContext *ctx,
 179                                    struct mesa_glinterop_device_info *out);
 180    int (*GLInteropExportObject)(_EGLDisplay *disp, _EGLContext *ctx,
 181                                 struct mesa_glinterop_export_in *in,
 182                                 struct mesa_glinterop_export_out *out);
 183
 184    EGLBoolean (*QueryDmaBufFormatsEXT)(_EGLDisplay *disp,
 185                                        EGLint max_formats, EGLint *formats,
 186                                        EGLint *num_formats);
 187    EGLBoolean (*QueryDmaBufModifiersEXT)(_EGLDisplay *disp, EGLint format,
 188                                          EGLint max_modifiers, EGLuint64KHR *modifiers,
 189                                          EGLBoolean *external_only,
 190                                          EGLint *num_modifiers);
 191
 192    void (*SetBlobCacheFuncsANDROID)(_EGLDisplay *disp,
 193                                     EGLSetBlobFuncANDROID set,
 194                                     EGLGetBlobFuncANDROID get);
 195 };
 196
 197
 198 extern bool
 199 _eglInitializeDisplay(_EGLDisplay *disp);
 200
 201
 202 #ifdef __cplusplus
 203 }
 204 #endif
 205
 206
 207 #endif /* EGLDRIVER_INCLUDED */