src/egl/drivers/dri2/egl_dri2.h

   1 /*
   2  * Copyright © 2011 Intel Corporation
   3  *
   4  * Permission is hereby granted, free of charge, to any person obtaining a
   5  * copy of this software and associated documentation files (the "Software"),
   6  * to deal in the Software without restriction, including without limitation
   7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   8  * and/or sell copies of the Software, and to permit persons to whom the
   9  * Software is furnished to do so, subject to the following conditions:
  10  *
  11  * The above copyright notice and this permission notice (including the next
  12  * paragraph) shall be included in all copies or substantial portions of the
  13  * Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  16  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  17  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  18  * NONINFRINGEMENT.  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
  19  * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  20  * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  22  * DEALINGS IN THE SOFTWARE.
  23  *
  24  * Authors:
  25  *    Kristian Høgsberg <krh@bitplanet.net>
  26  */
  27
  28 #ifndef EGL_DRI2_INCLUDED
  29 #define EGL_DRI2_INCLUDED
  30
  31 #include <stdbool.h>
  32 #include <stdint.h>
  33
  34 #ifdef HAVE_X11_PLATFORM
  35 #include <xcb/xcb.h>
  36 #include <xcb/dri2.h>
  37 #include <xcb/xfixes.h>
  38 #include <X11/Xlib-xcb.h>
  39
  40 #ifdef HAVE_DRI3
  41 #include "loader_dri3_helper.h"
  42 #endif
  43 #endif
  44
  45 #ifdef HAVE_WAYLAND_PLATFORM
  46 #include <wayland-client.h>
  47 #include "wayland-egl-backend.h"
  48 /* forward declarations of protocol elements */
  49 struct zwp_linux_dmabuf_v1;
  50 #endif
  51
  52 #include <GL/gl.h>
  53 #include <GL/internal/dri_interface.h>
  54
  55 #ifdef HAVE_DRM_PLATFORM
  56 #include <gbm_driint.h>
  57 #endif
  58
  59 #ifdef HAVE_ANDROID_PLATFORM
  60 #define LOG_TAG "EGL-DRI2"
  61
  62 #include <system/window.h>
  63 #include <hardware/gralloc.h>
  64 #include <gralloc_drm_handle.h>
  65
  66 #endif /* HAVE_ANDROID_PLATFORM */
  67
  68 #include "eglconfig.h"
  69 #include "eglcontext.h"
  70 #include "egldisplay.h"
  71 #include "egldriver.h"
  72 #include "eglcurrent.h"
  73 #include "egllog.h"
  74 #include "eglsurface.h"
  75 #include "eglimage.h"
  76 #include "eglsync.h"
  77
  78 #include "util/u_vector.h"
  79
  80 struct wl_buffer;
  81
  82 struct dri2_egl_display_vtbl {
  83    int (*authenticate)(_EGLDisplay *disp, uint32_t id);
  84
  85    _EGLSurface* (*create_window_surface)(_EGLDriver *drv, _EGLDisplay *dpy,
  86                                          _EGLConfig *config,
  87                                          void *native_window,
  88                                          const EGLint *attrib_list);
  89
  90    _EGLSurface* (*create_pixmap_surface)(_EGLDriver *drv, _EGLDisplay *dpy,
  91                                          _EGLConfig *config,
  92                                          void *native_pixmap,
  93                                          const EGLint *attrib_list);
  94
  95    _EGLSurface* (*create_pbuffer_surface)(_EGLDriver *drv, _EGLDisplay *dpy,
  96                                           _EGLConfig *config,
  97                                           const EGLint *attrib_list);
  98
  99    EGLBoolean (*destroy_surface)(_EGLDriver *drv, _EGLDisplay *dpy,
 100                                  _EGLSurface *surface);
 101
 102    EGLBoolean (*swap_interval)(_EGLDriver *drv, _EGLDisplay *dpy,
 103                                _EGLSurface *surf, EGLint interval);
 104
 105    _EGLImage* (*create_image)(_EGLDriver *drv, _EGLDisplay *dpy,
 106                               _EGLContext *ctx, EGLenum target,
 107                               EGLClientBuffer buffer,
 108                               const EGLint *attr_list);
 109
 110    EGLBoolean (*swap_buffers)(_EGLDriver *drv, _EGLDisplay *dpy,
 111                               _EGLSurface *surf);
 112
 113    EGLBoolean (*swap_buffers_with_damage)(_EGLDriver *drv, _EGLDisplay *dpy,
 114                                           _EGLSurface *surface,
 115                                           const EGLint *rects, EGLint n_rects);
 116
 117    EGLBoolean (*set_damage_region)(_EGLDriver *drv, _EGLDisplay *dpy,
 118                                    _EGLSurface *surface,
 119                                    const EGLint *rects, EGLint n_rects);
 120
 121    EGLBoolean (*swap_buffers_region)(_EGLDriver *drv, _EGLDisplay *dpy,
 122                                      _EGLSurface *surf, EGLint numRects,
 123                                      const EGLint *rects);
 124
 125    EGLBoolean (*post_sub_buffer)(_EGLDriver *drv, _EGLDisplay *dpy,
 126                                  _EGLSurface *surf,
 127                                  EGLint x, EGLint y,
 128                                  EGLint width, EGLint height);
 129
 130    EGLBoolean (*copy_buffers)(_EGLDriver *drv, _EGLDisplay *dpy,
 131                               _EGLSurface *surf, void *native_pixmap_target);
 132
 133    EGLint (*query_buffer_age)(_EGLDriver *drv, _EGLDisplay *dpy,
 134                               _EGLSurface *surf);
 135
 136    EGLBoolean (*query_surface)(_EGLDriver *drv, _EGLDisplay *dpy,
 137                                _EGLSurface *surf, EGLint attribute,
 138                                EGLint *value);
 139
 140    struct wl_buffer* (*create_wayland_buffer_from_image)(
 141                         _EGLDriver *drv, _EGLDisplay *dpy, _EGLImage *img);
 142
 143    EGLBoolean (*get_sync_values)(_EGLDisplay *display, _EGLSurface *surface,
 144                                  EGLuint64KHR *ust, EGLuint64KHR *msc,
 145                                  EGLuint64KHR *sbc);
 146
 147    __DRIdrawable *(*get_dri_drawable)(_EGLSurface *surf);
 148
 149    void (*close_screen_notify)(_EGLDisplay *dpy);
 150 };
 151
 152 struct dri2_egl_display
 153 {
 154    const struct dri2_egl_display_vtbl *vtbl;
 155
 156    int                       dri2_major;
 157    int                       dri2_minor;
 158    __DRIscreen              *dri_screen;
 159    bool                      own_dri_screen;
 160    const __DRIconfig       **driver_configs;
 161    void                     *driver;
 162    const __DRIcoreExtension       *core;
 163    const __DRIimageDriverExtension *image_driver;
 164    const __DRIdri2Extension       *dri2;
 165    const __DRIswrastExtension     *swrast;
 166    const __DRI2flushExtension     *flush;
 167    const __DRI2flushControlExtension *flush_control;
 168    const __DRItexBufferExtension  *tex_buffer;
 169    const __DRIimageExtension      *image;
 170    const __DRIrobustnessExtension *robustness;
 171    const __DRInoErrorExtension    *no_error;
 172    const __DRI2configQueryExtension *config;
 173    const __DRI2fenceExtension *fence;
 174    const __DRI2blobExtension *blob;
 175    const __DRI2rendererQueryExtension *rendererQuery;
 176    const __DRI2interopExtension *interop;
 177    int                       fd;
 178
 179    /* dri2_initialize/dri2_terminate increment/decrement this count, so does
 180     * dri2_make_current (tracks if there are active contexts/surfaces). */
 181    int                       ref_count;
 182
 183    bool                      own_device;
 184    bool                      invalidate_available;
 185    int                       min_swap_interval;
 186    int                       max_swap_interval;
 187    int                       default_swap_interval;
 188 #ifdef HAVE_DRM_PLATFORM
 189    struct gbm_dri_device    *gbm_dri;
 190 #endif
 191
 192    char                     *driver_name;
 193
 194    const __DRIextension    **loader_extensions;
 195    const __DRIextension    **driver_extensions;
 196
 197 #ifdef HAVE_X11_PLATFORM
 198    xcb_connection_t         *conn;
 199    xcb_screen_t             *screen;
 200    bool                     swap_available;
 201 #ifdef HAVE_DRI3
 202    struct loader_dri3_extensions loader_dri3_ext;
 203 #endif
 204 #endif
 205
 206 #ifdef HAVE_WAYLAND_PLATFORM
 207    struct wl_display        *wl_dpy;
 208    struct wl_display        *wl_dpy_wrapper;
 209    struct wl_registry       *wl_registry;
 210    struct wl_drm            *wl_server_drm;
 211    struct wl_drm            *wl_drm;
 212    struct wl_shm            *wl_shm;
 213    struct wl_event_queue    *wl_queue;
 214    struct zwp_linux_dmabuf_v1 *wl_dmabuf;
 215    struct {
 216       struct u_vector        xrgb2101010;
 217       struct u_vector        argb2101010;
 218       struct u_vector        xrgb8888;
 219       struct u_vector        argb8888;
 220       struct u_vector        rgb565;
 221    } wl_modifiers;
 222    bool                      authenticated;
 223    int                       formats;
 224    uint32_t                  capabilities;
 225    char                     *device_name;
 226 #endif
 227
 228 #ifdef HAVE_ANDROID_PLATFORM
 229    const gralloc_module_t *gralloc;
 230 #endif
 231
 232    bool                      is_render_node;
 233    bool                      is_different_gpu;
 234 };
 235
 236 struct dri2_egl_context
 237 {
 238    _EGLContext   base;
 239    __DRIcontext *dri_context;
 240 };
 241
 242 #ifdef HAVE_WAYLAND_PLATFORM
 243 enum wayland_buffer_type {
 244    WL_BUFFER_FRONT,
 245    WL_BUFFER_BACK,
 246    WL_BUFFER_THIRD,
 247    WL_BUFFER_COUNT
 248 };
 249 #endif
 250
 251 struct dri2_egl_surface
 252 {
 253    _EGLSurface          base;
 254    __DRIdrawable       *dri_drawable;
 255    __DRIbuffer          buffers[5];
 256    bool                 have_fake_front;
 257
 258 #ifdef HAVE_X11_PLATFORM
 259    xcb_drawable_t       drawable;
 260    xcb_xfixes_region_t  region;
 261    int                  depth;
 262    int                  bytes_per_pixel;
 263    xcb_gcontext_t       gc;
 264    xcb_gcontext_t       swapgc;
 265 #endif
 266
 267 #ifdef HAVE_WAYLAND_PLATFORM
 268    struct wl_egl_window  *wl_win;
 269    int                    dx;
 270    int                    dy;
 271    struct wl_event_queue *wl_queue;
 272    struct wl_surface     *wl_surface_wrapper;
 273    struct wl_display     *wl_dpy_wrapper;
 274    struct wl_drm         *wl_drm_wrapper;
 275    struct wl_callback    *throttle_callback;
 276    int                    format;
 277 #endif
 278
 279 #ifdef HAVE_DRM_PLATFORM
 280    struct gbm_dri_surface *gbm_surf;
 281 #endif
 282
 283    /* EGL-owned buffers */
 284    __DRIbuffer           *local_buffers[__DRI_BUFFER_COUNT];
 285
 286 #if defined(HAVE_WAYLAND_PLATFORM) || defined(HAVE_DRM_PLATFORM)
 287    struct {
 288 #ifdef HAVE_WAYLAND_PLATFORM
 289       struct wl_buffer   *wl_buffer;
 290       __DRIimage         *dri_image;
 291       /* for is_different_gpu case. NULL else */
 292       __DRIimage         *linear_copy;
 293       /* for swrast */
 294       void *data;
 295       int data_size;
 296 #endif
 297 #ifdef HAVE_DRM_PLATFORM
 298       struct gbm_bo       *bo;
 299 #endif
 300       bool                locked;
 301       int                 age;
 302    } color_buffers[4], *back, *current;
 303 #endif
 304
 305 #ifdef HAVE_ANDROID_PLATFORM
 306    struct ANativeWindow *window;
 307    struct ANativeWindowBuffer *buffer;
 308    __DRIimage *dri_image_back;
 309    __DRIimage *dri_image_front;
 310
 311    /* Used to record all the buffers created by ANativeWindow and their ages.
 312     * Usually Android uses at most triple buffers in ANativeWindow
 313     * so hardcode the number of color_buffers to 3.
 314     */
 315    struct {
 316       struct ANativeWindowBuffer *buffer;
 317       int age;
 318    } color_buffers[3], *back;
 319 #endif
 320
 321 #if defined(HAVE_SURFACELESS_PLATFORM)
 322       __DRIimage           *front;
 323       unsigned int         visual;
 324 #endif
 325    int out_fence_fd;
 326    EGLBoolean enable_out_fence;
 327 };
 328
 329 struct dri2_egl_config
 330 {
 331    _EGLConfig         base;
 332    const __DRIconfig *dri_config[2][2];
 333 };
 334
 335 struct dri2_egl_image
 336 {
 337    _EGLImage   base;
 338    __DRIimage *dri_image;
 339 };
 340
 341 struct dri2_egl_sync {
 342    _EGLSync base;
 343    mtx_t mutex;
 344    cnd_t cond;
 345    int refcount;
 346    void *fence;
 347 };
 348
 349 /* From xmlpool/options.h, user exposed so should be stable */
 350 #define DRI_CONF_VBLANK_NEVER 0
 351 #define DRI_CONF_VBLANK_DEF_INTERVAL_0 1
 352 #define DRI_CONF_VBLANK_DEF_INTERVAL_1 2
 353 #define DRI_CONF_VBLANK_ALWAYS_SYNC 3
 354
 355 /* standard typecasts */
 356 _EGL_DRIVER_STANDARD_TYPECASTS(dri2_egl)
 357 _EGL_DRIVER_TYPECAST(dri2_egl_image, _EGLImage, obj)
 358 _EGL_DRIVER_TYPECAST(dri2_egl_sync, _EGLSync, obj)
 359
 360 extern const __DRIimageLookupExtension image_lookup_extension;
 361 extern const __DRIuseInvalidateExtension use_invalidate;
 362 extern const __DRIbackgroundCallableExtension background_callable_extension;
 363
 364 EGLBoolean
 365 dri2_load_driver(_EGLDisplay *disp);
 366
 367 /* Helper for platforms not using dri2_create_screen */
 368 void
 369 dri2_setup_screen(_EGLDisplay *disp);
 370
 371 void
 372 dri2_setup_swap_interval(_EGLDisplay *disp, int max_swap_interval);
 373
 374 EGLBoolean
 375 dri2_load_driver_swrast(_EGLDisplay *disp);
 376
 377 EGLBoolean
 378 dri2_load_driver_dri3(_EGLDisplay *disp);
 379
 380 EGLBoolean
 381 dri2_create_screen(_EGLDisplay *disp);
 382
 383 EGLBoolean
 384 dri2_setup_extensions(_EGLDisplay *disp);
 385
 386 __DRIdrawable *
 387 dri2_surface_get_dri_drawable(_EGLSurface *surf);
 388
 389 __DRIimage *
 390 dri2_lookup_egl_image(__DRIscreen *screen, void *image, void *data);
 391
 392 struct dri2_egl_config *
 393 dri2_add_config(_EGLDisplay *disp, const __DRIconfig *dri_config, int id,
 394                 EGLint surface_type, const EGLint *attr_list,
 395                 const unsigned int *rgba_masks);
 396
 397 _EGLImage *
 398 dri2_create_image_khr(_EGLDriver *drv, _EGLDisplay *disp,
 399                       _EGLContext *ctx, EGLenum target,
 400                       EGLClientBuffer buffer, const EGLint *attr_list);
 401
 402 _EGLImage *
 403 dri2_create_image_dma_buf(_EGLDisplay *disp, _EGLContext *ctx,
 404                           EGLClientBuffer buffer, const EGLint *attr_list);
 405
 406 #ifdef HAVE_X11_PLATFORM
 407 EGLBoolean
 408 dri2_initialize_x11(_EGLDriver *drv, _EGLDisplay *disp);
 409 void
 410 dri2_teardown_x11(struct dri2_egl_display *dri2_dpy);
 411 #else
 412 static inline EGLBoolean
 413 dri2_initialize_x11(_EGLDriver *drv, _EGLDisplay *disp)
 414 {
 415    return _eglError(EGL_NOT_INITIALIZED, "X11 platform not built");
 416 }
 417 static inline void
 418 dri2_teardown_x11(struct dri2_egl_display *dri2_dpy) {}
 419 #endif
 420
 421 #ifdef HAVE_DRM_PLATFORM
 422 EGLBoolean
 423 dri2_initialize_drm(_EGLDriver *drv, _EGLDisplay *disp);
 424 void
 425 dri2_teardown_drm(struct dri2_egl_display *dri2_dpy);
 426 #else
 427 static inline EGLBoolean
 428 dri2_initialize_drm(_EGLDriver *drv, _EGLDisplay *disp)
 429 {
 430    return _eglError(EGL_NOT_INITIALIZED, "GBM/DRM platform not built");
 431 }
 432 static inline void
 433 dri2_teardown_drm(struct dri2_egl_display *dri2_dpy) {}
 434 #endif
 435
 436 #ifdef HAVE_WAYLAND_PLATFORM
 437 EGLBoolean
 438 dri2_initialize_wayland(_EGLDriver *drv, _EGLDisplay *disp);
 439 void
 440 dri2_teardown_wayland(struct dri2_egl_display *dri2_dpy);
 441 #else
 442 static inline EGLBoolean
 443 dri2_initialize_wayland(_EGLDriver *drv, _EGLDisplay *disp)
 444 {
 445    return _eglError(EGL_NOT_INITIALIZED, "Wayland platform not built");
 446 }
 447 static inline void
 448 dri2_teardown_wayland(struct dri2_egl_display *dri2_dpy) {}
 449 #endif
 450
 451 #ifdef HAVE_ANDROID_PLATFORM
 452 EGLBoolean
 453 dri2_initialize_android(_EGLDriver *drv, _EGLDisplay *disp);
 454 #else
 455 static inline EGLBoolean
 456 dri2_initialize_android(_EGLDriver *drv, _EGLDisplay *disp)
 457 {
 458    return _eglError(EGL_NOT_INITIALIZED, "Android platform not built");
 459 }
 460 #endif
 461
 462 #ifdef HAVE_SURFACELESS_PLATFORM
 463 EGLBoolean
 464 dri2_initialize_surfaceless(_EGLDriver *drv, _EGLDisplay *disp);
 465 #else
 466 static inline EGLBoolean
 467 dri2_initialize_surfaceless(_EGLDriver *drv, _EGLDisplay *disp)
 468 {
 469    return _eglError(EGL_NOT_INITIALIZED, "Surfaceless platform not built");
 470 }
 471 #endif
 472
 473 void
 474 dri2_flush_drawable_for_swapbuffers(_EGLDisplay *disp, _EGLSurface *draw);
 475
 476 const __DRIconfig *
 477 dri2_get_dri_config(struct dri2_egl_config *conf, EGLint surface_type,
 478                     EGLenum colorspace);
 479
 480 static inline void
 481 dri2_set_WL_bind_wayland_display(_EGLDriver *drv, _EGLDisplay *disp)
 482 {
 483 #ifdef HAVE_WAYLAND_PLATFORM
 484    struct dri2_egl_display *dri2_dpy = dri2_egl_display(disp);
 485
 486    (void) drv;
 487
 488    if (dri2_dpy->device_name && dri2_dpy->image) {
 489        if (dri2_dpy->image->base.version >= 10 &&
 490            dri2_dpy->image->getCapabilities != NULL) {
 491            int capabilities;
 492
 493            capabilities =
 494                dri2_dpy->image->getCapabilities(dri2_dpy->dri_screen);
 495            disp->Extensions.WL_bind_wayland_display =
 496                (capabilities & __DRI_IMAGE_CAP_GLOBAL_NAMES) != 0;
 497        } else {
 498            disp->Extensions.WL_bind_wayland_display = EGL_TRUE;
 499        }
 500    }
 501 #endif
 502 }
 503
 504 void
 505 dri2_display_destroy(_EGLDisplay *disp);
 506
 507 __DRIbuffer *
 508 dri2_egl_surface_alloc_local_buffer(struct dri2_egl_surface *dri2_surf,
 509                                     unsigned int att, unsigned int format);
 510
 511 void
 512 dri2_egl_surface_free_local_buffers(struct dri2_egl_surface *dri2_surf);
 513
 514 EGLBoolean
 515 dri2_init_surface(_EGLSurface *surf, _EGLDisplay *dpy, EGLint type,
 516         _EGLConfig *conf, const EGLint *attrib_list, EGLBoolean enable_out_fence);
 517
 518 void
 519 dri2_fini_surface(_EGLSurface *surf);
 520
 521 #endif /* EGL_DRI2_INCLUDED */