2 * Mesa 3-D graphics library
4 * Copyright (C) 2010-2011 Chia-I Wu <olvaffe@gmail.com>
5 * Copyright (C) 2010-2011 LunarG Inc.
7 * Based on platform_x11, which has
9 * Copyright © 2011 Intel Corporation
11 * Permission is hereby granted, free of charge, to any person obtaining a
12 * copy of this software and associated documentation files (the "Software"),
13 * to deal in the Software without restriction, including without limitation
14 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
15 * and/or sell copies of the Software, and to permit persons to whom the
16 * Software is furnished to do so, subject to the following conditions:
18 * The above copyright notice and this permission notice shall be included
19 * in all copies or substantial portions of the Software.
21 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
24 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
25 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
26 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
27 * DEALINGS IN THE SOFTWARE.
35 #include <sync/sync.h>
39 #include "egl_dri2_fallbacks.h"
40 #include "gralloc_drm.h"
42 #define ALIGN(val, align) (((val) + (align) - 1) & ~((align) - 1))
44 struct droid_yuv_format
{
46 int native
; /* HAL_PIXEL_FORMAT_ */
47 int is_ycrcb
; /* 0 if chroma order is {Cb, Cr}, 1 if {Cr, Cb} */
48 int chroma_step
; /* Distance in bytes between subsequent chroma pixels. */
51 int fourcc
; /* __DRI_IMAGE_FOURCC_ */
54 /* The following table is used to look up a DRI image FourCC based
55 * on native format and information contained in android_ycbcr struct. */
56 static const struct droid_yuv_format droid_yuv_formats
[] = {
57 /* Native format, YCrCb, Chroma step, DRI image FourCC */
58 { HAL_PIXEL_FORMAT_YCbCr_420_888
, 0, 2, __DRI_IMAGE_FOURCC_NV12
},
59 { HAL_PIXEL_FORMAT_YCbCr_420_888
, 0, 1, __DRI_IMAGE_FOURCC_YUV420
},
60 { HAL_PIXEL_FORMAT_YCbCr_420_888
, 1, 1, __DRI_IMAGE_FOURCC_YVU420
},
61 { HAL_PIXEL_FORMAT_YV12
, 1, 1, __DRI_IMAGE_FOURCC_YVU420
},
65 get_fourcc_yuv(int native
, int is_ycrcb
, int chroma_step
)
67 for (int i
= 0; i
< ARRAY_SIZE(droid_yuv_formats
); ++i
)
68 if (droid_yuv_formats
[i
].native
== native
&&
69 droid_yuv_formats
[i
].is_ycrcb
== is_ycrcb
&&
70 droid_yuv_formats
[i
].chroma_step
== chroma_step
)
71 return droid_yuv_formats
[i
].fourcc
;
79 for (int i
= 0; i
< ARRAY_SIZE(droid_yuv_formats
); ++i
)
80 if (droid_yuv_formats
[i
].native
== native
)
87 get_format_bpp(int native
)
92 case HAL_PIXEL_FORMAT_RGBA_8888
:
93 case HAL_PIXEL_FORMAT_RGBX_8888
:
94 case HAL_PIXEL_FORMAT_BGRA_8888
:
97 case HAL_PIXEL_FORMAT_RGB_565
:
108 /* createImageFromFds requires fourcc format */
109 static int get_fourcc(int native
)
112 case HAL_PIXEL_FORMAT_RGB_565
: return __DRI_IMAGE_FOURCC_RGB565
;
113 case HAL_PIXEL_FORMAT_BGRA_8888
: return __DRI_IMAGE_FOURCC_ARGB8888
;
114 case HAL_PIXEL_FORMAT_RGBA_8888
: return __DRI_IMAGE_FOURCC_ABGR8888
;
115 case HAL_PIXEL_FORMAT_RGBX_8888
: return __DRI_IMAGE_FOURCC_XBGR8888
;
117 _eglLog(_EGL_WARNING
, "unsupported native buffer format 0x%x", native
);
122 static int get_format(int format
)
125 case HAL_PIXEL_FORMAT_BGRA_8888
: return __DRI_IMAGE_FORMAT_ARGB8888
;
126 case HAL_PIXEL_FORMAT_RGB_565
: return __DRI_IMAGE_FORMAT_RGB565
;
127 case HAL_PIXEL_FORMAT_RGBA_8888
: return __DRI_IMAGE_FORMAT_ABGR8888
;
128 case HAL_PIXEL_FORMAT_RGBX_8888
: return __DRI_IMAGE_FORMAT_XBGR8888
;
130 _eglLog(_EGL_WARNING
, "unsupported native buffer format 0x%x", format
);
136 get_native_buffer_fd(struct ANativeWindowBuffer
*buf
)
138 native_handle_t
*handle
= (native_handle_t
*)buf
->handle
;
140 * Various gralloc implementations exist, but the dma-buf fd tends
141 * to be first. Access it directly to avoid a dependency on specific
144 return (handle
&& handle
->numFds
) ? handle
->data
[0] : -1;
148 get_native_buffer_name(struct ANativeWindowBuffer
*buf
)
150 return gralloc_drm_get_gem_handle(buf
->handle
);
154 droid_window_dequeue_buffer(struct dri2_egl_surface
*dri2_surf
)
158 if (dri2_surf
->window
->dequeueBuffer(dri2_surf
->window
, &dri2_surf
->buffer
,
162 /* If access to the buffer is controlled by a sync fence, then block on the
165 * It may be more performant to postpone blocking until there is an
166 * immediate need to write to the buffer. But doing so would require adding
167 * hooks to the DRI2 loader.
169 * From the ANativeWindow::dequeueBuffer documentation:
171 * The libsync fence file descriptor returned in the int pointed to by
172 * the fenceFd argument will refer to the fence that must signal
173 * before the dequeued buffer may be written to. A value of -1
174 * indicates that the caller may access the buffer immediately without
175 * waiting on a fence. If a valid file descriptor is returned (i.e.
176 * any value except -1) then the caller is responsible for closing the
180 /* From the SYNC_IOC_WAIT documentation in <linux/sync.h>:
182 * Waits indefinitely if timeout < 0.
185 sync_wait(fence_fd
, timeout
);
189 dri2_surf
->buffer
->common
.incRef(&dri2_surf
->buffer
->common
);
191 /* Record all the buffers created by ANativeWindow and update back buffer
192 * for updating buffer's age in swap_buffers.
194 EGLBoolean updated
= EGL_FALSE
;
195 for (int i
= 0; i
< ARRAY_SIZE(dri2_surf
->color_buffers
); i
++) {
196 if (!dri2_surf
->color_buffers
[i
].buffer
) {
197 dri2_surf
->color_buffers
[i
].buffer
= dri2_surf
->buffer
;
199 if (dri2_surf
->color_buffers
[i
].buffer
== dri2_surf
->buffer
) {
200 dri2_surf
->back
= &dri2_surf
->color_buffers
[i
];
207 /* In case of all the buffers were recreated by ANativeWindow, reset
210 for (int i
= 0; i
< ARRAY_SIZE(dri2_surf
->color_buffers
); i
++) {
211 dri2_surf
->color_buffers
[i
].buffer
= NULL
;
212 dri2_surf
->color_buffers
[i
].age
= 0;
214 dri2_surf
->color_buffers
[0].buffer
= dri2_surf
->buffer
;
215 dri2_surf
->back
= &dri2_surf
->color_buffers
[0];
222 droid_window_enqueue_buffer(_EGLDisplay
*disp
, struct dri2_egl_surface
*dri2_surf
)
224 struct dri2_egl_display
*dri2_dpy
= dri2_egl_display(disp
);
226 /* To avoid blocking other EGL calls, release the display mutex before
227 * we enter droid_window_enqueue_buffer() and re-acquire the mutex upon
230 mtx_unlock(&disp
->Mutex
);
232 /* Queue the buffer without a sync fence. This informs the ANativeWindow
233 * that it may access the buffer immediately.
235 * From ANativeWindow::dequeueBuffer:
237 * The fenceFd argument specifies a libsync fence file descriptor for
238 * a fence that must signal before the buffer can be accessed. If
239 * the buffer can be accessed immediately then a value of -1 should
240 * be used. The caller must not use the file descriptor after it
241 * is passed to queueBuffer, and the ANativeWindow implementation
242 * is responsible for closing it.
245 dri2_surf
->window
->queueBuffer(dri2_surf
->window
, dri2_surf
->buffer
,
248 dri2_surf
->buffer
->common
.decRef(&dri2_surf
->buffer
->common
);
249 dri2_surf
->buffer
= NULL
;
250 dri2_surf
->back
= NULL
;
252 mtx_lock(&disp
->Mutex
);
254 if (dri2_surf
->dri_image_back
) {
255 dri2_dpy
->image
->destroyImage(dri2_surf
->dri_image_back
);
256 dri2_surf
->dri_image_back
= NULL
;
263 droid_window_cancel_buffer(struct dri2_egl_surface
*dri2_surf
)
267 ret
= dri2_surf
->window
->cancelBuffer(dri2_surf
->window
, dri2_surf
->buffer
, -1);
269 _eglLog(_EGL_WARNING
, "ANativeWindow::cancelBuffer failed");
270 dri2_surf
->base
.Lost
= EGL_TRUE
;
275 droid_alloc_local_buffer(struct dri2_egl_surface
*dri2_surf
,
276 unsigned int att
, unsigned int format
)
278 struct dri2_egl_display
*dri2_dpy
=
279 dri2_egl_display(dri2_surf
->base
.Resource
.Display
);
281 if (att
>= ARRAY_SIZE(dri2_surf
->local_buffers
))
284 if (!dri2_surf
->local_buffers
[att
]) {
285 dri2_surf
->local_buffers
[att
] =
286 dri2_dpy
->dri2
->allocateBuffer(dri2_dpy
->dri_screen
, att
, format
,
287 dri2_surf
->base
.Width
, dri2_surf
->base
.Height
);
290 return dri2_surf
->local_buffers
[att
];
294 droid_free_local_buffers(struct dri2_egl_surface
*dri2_surf
)
296 struct dri2_egl_display
*dri2_dpy
=
297 dri2_egl_display(dri2_surf
->base
.Resource
.Display
);
299 for (int i
= 0; i
< ARRAY_SIZE(dri2_surf
->local_buffers
); i
++) {
300 if (dri2_surf
->local_buffers
[i
]) {
301 dri2_dpy
->dri2
->releaseBuffer(dri2_dpy
->dri_screen
,
302 dri2_surf
->local_buffers
[i
]);
303 dri2_surf
->local_buffers
[i
] = NULL
;
309 droid_create_surface(_EGLDriver
*drv
, _EGLDisplay
*disp
, EGLint type
,
310 _EGLConfig
*conf
, void *native_window
,
311 const EGLint
*attrib_list
)
313 __DRIcreateNewDrawableFunc createNewDrawable
;
314 struct dri2_egl_display
*dri2_dpy
= dri2_egl_display(disp
);
315 struct dri2_egl_config
*dri2_conf
= dri2_egl_config(conf
);
316 struct dri2_egl_surface
*dri2_surf
;
317 struct ANativeWindow
*window
= native_window
;
318 const __DRIconfig
*config
;
320 dri2_surf
= calloc(1, sizeof *dri2_surf
);
322 _eglError(EGL_BAD_ALLOC
, "droid_create_surface");
326 if (!_eglInitSurface(&dri2_surf
->base
, disp
, type
, conf
, attrib_list
))
327 goto cleanup_surface
;
329 if (type
== EGL_WINDOW_BIT
) {
332 if (window
->common
.magic
!= ANDROID_NATIVE_WINDOW_MAGIC
) {
333 _eglError(EGL_BAD_NATIVE_WINDOW
, "droid_create_surface");
334 goto cleanup_surface
;
336 if (window
->query(window
, NATIVE_WINDOW_FORMAT
, &format
)) {
337 _eglError(EGL_BAD_NATIVE_WINDOW
, "droid_create_surface");
338 goto cleanup_surface
;
341 if (format
!= dri2_conf
->base
.NativeVisualID
) {
342 _eglLog(_EGL_WARNING
, "Native format mismatch: 0x%x != 0x%x",
343 format
, dri2_conf
->base
.NativeVisualID
);
346 window
->query(window
, NATIVE_WINDOW_WIDTH
, &dri2_surf
->base
.Width
);
347 window
->query(window
, NATIVE_WINDOW_HEIGHT
, &dri2_surf
->base
.Height
);
350 config
= dri2_get_dri_config(dri2_conf
, type
,
351 dri2_surf
->base
.GLColorspace
);
353 goto cleanup_surface
;
355 if (dri2_dpy
->image_driver
)
356 createNewDrawable
= dri2_dpy
->image_driver
->createNewDrawable
;
358 createNewDrawable
= dri2_dpy
->dri2
->createNewDrawable
;
360 dri2_surf
->dri_drawable
= (*createNewDrawable
)(dri2_dpy
->dri_screen
, config
,
362 if (dri2_surf
->dri_drawable
== NULL
) {
363 _eglError(EGL_BAD_ALLOC
, "createNewDrawable");
364 goto cleanup_surface
;
368 window
->common
.incRef(&window
->common
);
369 dri2_surf
->window
= window
;
372 return &dri2_surf
->base
;
381 droid_create_window_surface(_EGLDriver
*drv
, _EGLDisplay
*disp
,
382 _EGLConfig
*conf
, void *native_window
,
383 const EGLint
*attrib_list
)
385 return droid_create_surface(drv
, disp
, EGL_WINDOW_BIT
, conf
,
386 native_window
, attrib_list
);
390 droid_create_pbuffer_surface(_EGLDriver
*drv
, _EGLDisplay
*disp
,
391 _EGLConfig
*conf
, const EGLint
*attrib_list
)
393 return droid_create_surface(drv
, disp
, EGL_PBUFFER_BIT
, conf
,
398 droid_destroy_surface(_EGLDriver
*drv
, _EGLDisplay
*disp
, _EGLSurface
*surf
)
400 struct dri2_egl_display
*dri2_dpy
= dri2_egl_display(disp
);
401 struct dri2_egl_surface
*dri2_surf
= dri2_egl_surface(surf
);
403 droid_free_local_buffers(dri2_surf
);
405 if (dri2_surf
->base
.Type
== EGL_WINDOW_BIT
) {
406 if (dri2_surf
->buffer
)
407 droid_window_cancel_buffer(dri2_surf
);
409 dri2_surf
->window
->common
.decRef(&dri2_surf
->window
->common
);
412 if (dri2_surf
->dri_image_back
) {
413 _eglLog(_EGL_DEBUG
, "%s : %d : destroy dri_image_back", __func__
, __LINE__
);
414 dri2_dpy
->image
->destroyImage(dri2_surf
->dri_image_back
);
415 dri2_surf
->dri_image_back
= NULL
;
418 if (dri2_surf
->dri_image_front
) {
419 _eglLog(_EGL_DEBUG
, "%s : %d : destroy dri_image_front", __func__
, __LINE__
);
420 dri2_dpy
->image
->destroyImage(dri2_surf
->dri_image_front
);
421 dri2_surf
->dri_image_front
= NULL
;
424 dri2_dpy
->core
->destroyDrawable(dri2_surf
->dri_drawable
);
432 update_buffers(struct dri2_egl_surface
*dri2_surf
)
434 if (dri2_surf
->base
.Lost
)
437 if (dri2_surf
->base
.Type
!= EGL_WINDOW_BIT
)
440 /* try to dequeue the next back buffer */
441 if (!dri2_surf
->buffer
&& !droid_window_dequeue_buffer(dri2_surf
)) {
442 _eglLog(_EGL_WARNING
, "Could not dequeue buffer from native window");
443 dri2_surf
->base
.Lost
= EGL_TRUE
;
447 /* free outdated buffers and update the surface size */
448 if (dri2_surf
->base
.Width
!= dri2_surf
->buffer
->width
||
449 dri2_surf
->base
.Height
!= dri2_surf
->buffer
->height
) {
450 droid_free_local_buffers(dri2_surf
);
451 dri2_surf
->base
.Width
= dri2_surf
->buffer
->width
;
452 dri2_surf
->base
.Height
= dri2_surf
->buffer
->height
;
459 get_front_bo(struct dri2_egl_surface
*dri2_surf
, unsigned int format
)
461 struct dri2_egl_display
*dri2_dpy
=
462 dri2_egl_display(dri2_surf
->base
.Resource
.Display
);
464 if (dri2_surf
->dri_image_front
)
467 if (dri2_surf
->base
.Type
== EGL_WINDOW_BIT
) {
468 /* According current EGL spec, front buffer rendering
469 * for window surface is not supported now.
470 * and mesa doesn't have the implementation of this case.
471 * Add warning message, but not treat it as error.
473 _eglLog(_EGL_DEBUG
, "DRI driver requested unsupported front buffer for window surface");
474 } else if (dri2_surf
->base
.Type
== EGL_PBUFFER_BIT
) {
475 dri2_surf
->dri_image_front
=
476 dri2_dpy
->image
->createImage(dri2_dpy
->dri_screen
,
477 dri2_surf
->base
.Width
,
478 dri2_surf
->base
.Height
,
482 if (!dri2_surf
->dri_image_front
) {
483 _eglLog(_EGL_WARNING
, "dri2_image_front allocation failed");
492 get_back_bo(struct dri2_egl_surface
*dri2_surf
)
494 struct dri2_egl_display
*dri2_dpy
=
495 dri2_egl_display(dri2_surf
->base
.Resource
.Display
);
499 if (dri2_surf
->dri_image_back
)
502 if (dri2_surf
->base
.Type
== EGL_WINDOW_BIT
) {
503 if (!dri2_surf
->buffer
) {
504 _eglLog(_EGL_WARNING
, "Could not get native buffer");
508 fd
= get_native_buffer_fd(dri2_surf
->buffer
);
510 _eglLog(_EGL_WARNING
, "Could not get native buffer FD");
514 fourcc
= get_fourcc(dri2_surf
->buffer
->format
);
516 pitch
= dri2_surf
->buffer
->stride
*
517 get_format_bpp(dri2_surf
->buffer
->format
);
519 if (fourcc
== -1 || pitch
== 0) {
520 _eglLog(_EGL_WARNING
, "Invalid buffer fourcc(%x) or pitch(%d)",
525 dri2_surf
->dri_image_back
=
526 dri2_dpy
->image
->createImageFromFds(dri2_dpy
->dri_screen
,
527 dri2_surf
->base
.Width
,
528 dri2_surf
->base
.Height
,
535 if (!dri2_surf
->dri_image_back
) {
536 _eglLog(_EGL_WARNING
, "failed to create DRI image from FD");
539 } else if (dri2_surf
->base
.Type
== EGL_PBUFFER_BIT
) {
540 /* The EGL 1.5 spec states that pbuffers are single-buffered. Specifically,
541 * the spec states that they have a back buffer but no front buffer, in
542 * contrast to pixmaps, which have a front buffer but no back buffer.
544 * Single-buffered surfaces with no front buffer confuse Mesa; so we deviate
545 * from the spec, following the precedent of Mesa's EGL X11 platform. The
546 * X11 platform correctly assigns pbuffers to single-buffered configs, but
547 * assigns the pbuffer a front buffer instead of a back buffer.
549 * Pbuffers in the X11 platform mostly work today, so let's just copy its
550 * behavior instead of trying to fix (and hence potentially breaking) the
553 _eglLog(_EGL_DEBUG
, "DRI driver requested unsupported back buffer for pbuffer surface");
559 /* Some drivers will pass multiple bits in buffer_mask.
560 * For such case, will go through all the bits, and
561 * will not return error when unsupported buffer is requested, only
562 * return error when the allocation for supported buffer failed.
565 droid_image_get_buffers(__DRIdrawable
*driDrawable
,
569 uint32_t buffer_mask
,
570 struct __DRIimageList
*images
)
572 struct dri2_egl_surface
*dri2_surf
= loaderPrivate
;
574 images
->image_mask
= 0;
575 images
->front
= NULL
;
578 if (update_buffers(dri2_surf
) < 0)
581 if (buffer_mask
& __DRI_IMAGE_BUFFER_FRONT
) {
582 if (get_front_bo(dri2_surf
, format
) < 0)
585 if (dri2_surf
->dri_image_front
) {
586 images
->front
= dri2_surf
->dri_image_front
;
587 images
->image_mask
|= __DRI_IMAGE_BUFFER_FRONT
;
591 if (buffer_mask
& __DRI_IMAGE_BUFFER_BACK
) {
592 if (get_back_bo(dri2_surf
) < 0)
595 if (dri2_surf
->dri_image_back
) {
596 images
->back
= dri2_surf
->dri_image_back
;
597 images
->image_mask
|= __DRI_IMAGE_BUFFER_BACK
;
605 droid_query_buffer_age(_EGLDriver
*drv
,
606 _EGLDisplay
*disp
, _EGLSurface
*surface
)
608 struct dri2_egl_surface
*dri2_surf
= dri2_egl_surface(surface
);
610 if (update_buffers(dri2_surf
) < 0) {
611 _eglError(EGL_BAD_ALLOC
, "droid_query_buffer_age");
615 return dri2_surf
->back
? dri2_surf
->back
->age
: 0;
619 droid_swap_buffers(_EGLDriver
*drv
, _EGLDisplay
*disp
, _EGLSurface
*draw
)
621 struct dri2_egl_display
*dri2_dpy
= dri2_egl_display(disp
);
622 struct dri2_egl_surface
*dri2_surf
= dri2_egl_surface(draw
);
624 if (dri2_surf
->base
.Type
!= EGL_WINDOW_BIT
)
627 for (int i
= 0; i
< ARRAY_SIZE(dri2_surf
->color_buffers
); i
++) {
628 if (dri2_surf
->color_buffers
[i
].age
> 0)
629 dri2_surf
->color_buffers
[i
].age
++;
632 /* "XXX: we don't use get_back_bo() since it causes regressions in
633 * several dEQP tests.
636 dri2_surf
->back
->age
= 1;
638 dri2_flush_drawable_for_swapbuffers(disp
, draw
);
640 /* dri2_surf->buffer can be null even when no error has occured. For
641 * example, if the user has called no GL rendering commands since the
642 * previous eglSwapBuffers, then the driver may have not triggered
643 * a callback to ANativeWindow::dequeueBuffer, in which case
644 * dri2_surf->buffer remains null.
646 if (dri2_surf
->buffer
)
647 droid_window_enqueue_buffer(disp
, dri2_surf
);
649 dri2_dpy
->flush
->invalidate(dri2_surf
->dri_drawable
);
654 #if ANDROID_API_LEVEL >= 23
656 droid_set_damage_region(_EGLDriver
*drv
,
658 _EGLSurface
*draw
, const EGLint
* rects
, EGLint n_rects
)
660 struct dri2_egl_display
*dri2_dpy
= dri2_egl_display(disp
);
661 struct dri2_egl_surface
*dri2_surf
= dri2_egl_surface(draw
);
662 android_native_rect_t
* droid_rects
= NULL
;
668 droid_rects
= malloc(n_rects
* sizeof(android_native_rect_t
));
669 if (droid_rects
== NULL
)
670 return _eglError(EGL_BAD_ALLOC
, "eglSetDamageRegionKHR");
672 for (EGLint num_drects
= 0; num_drects
< n_rects
; num_drects
++) {
673 EGLint i
= num_drects
* 4;
674 droid_rects
[num_drects
].left
= rects
[i
];
675 droid_rects
[num_drects
].bottom
= rects
[i
+ 1];
676 droid_rects
[num_drects
].right
= rects
[i
] + rects
[i
+ 2];
677 droid_rects
[num_drects
].top
= rects
[i
+ 1] + rects
[i
+ 3];
681 * XXX/TODO: Need to check for other return values
684 ret
= native_window_set_surface_damage(dri2_surf
->window
, droid_rects
, n_rects
);
687 return ret
== 0 ? EGL_TRUE
: EGL_FALSE
;
692 droid_create_image_from_prime_fd_yuv(_EGLDisplay
*disp
, _EGLContext
*ctx
,
693 struct ANativeWindowBuffer
*buf
, int fd
)
695 struct dri2_egl_display
*dri2_dpy
= dri2_egl_display(disp
);
696 struct android_ycbcr ycbcr
;
703 if (!dri2_dpy
->gralloc
->lock_ycbcr
) {
704 _eglLog(_EGL_WARNING
, "Gralloc does not support lock_ycbcr");
708 memset(&ycbcr
, 0, sizeof(ycbcr
));
709 ret
= dri2_dpy
->gralloc
->lock_ycbcr(dri2_dpy
->gralloc
, buf
->handle
,
710 0, 0, 0, 0, 0, &ycbcr
);
712 _eglLog(_EGL_WARNING
, "gralloc->lock_ycbcr failed: %d", ret
);
715 dri2_dpy
->gralloc
->unlock(dri2_dpy
->gralloc
, buf
->handle
);
717 /* When lock_ycbcr's usage argument contains no SW_READ/WRITE flags
718 * it will return the .y/.cb/.cr pointers based on a NULL pointer,
719 * so they can be interpreted as offsets. */
720 offsets
[0] = (size_t)ycbcr
.y
;
721 /* We assume here that all the planes are located in one DMA-buf. */
722 is_ycrcb
= (size_t)ycbcr
.cr
< (size_t)ycbcr
.cb
;
724 offsets
[1] = (size_t)ycbcr
.cr
;
725 offsets
[2] = (size_t)ycbcr
.cb
;
727 offsets
[1] = (size_t)ycbcr
.cb
;
728 offsets
[2] = (size_t)ycbcr
.cr
;
731 /* .ystride is the line length (in bytes) of the Y plane,
732 * .cstride is the line length (in bytes) of any of the remaining
733 * Cb/Cr/CbCr planes, assumed to be the same for Cb and Cr for fully
735 pitches
[0] = ycbcr
.ystride
;
736 pitches
[1] = pitches
[2] = ycbcr
.cstride
;
738 /* .chroma_step is the byte distance between the same chroma channel
739 * values of subsequent pixels, assumed to be the same for Cb and Cr. */
740 fourcc
= get_fourcc_yuv(buf
->format
, is_ycrcb
, ycbcr
.chroma_step
);
742 _eglLog(_EGL_WARNING
, "unsupported YUV format, native = %x, is_ycrcb = %d, chroma_step = %d",
743 buf
->format
, is_ycrcb
, ycbcr
.chroma_step
);
747 if (ycbcr
.chroma_step
== 2) {
748 /* Semi-planar Y + CbCr or Y + CrCb format. */
749 const EGLint attr_list_2plane
[] = {
750 EGL_WIDTH
, buf
->width
,
751 EGL_HEIGHT
, buf
->height
,
752 EGL_LINUX_DRM_FOURCC_EXT
, fourcc
,
753 EGL_DMA_BUF_PLANE0_FD_EXT
, fd
,
754 EGL_DMA_BUF_PLANE0_PITCH_EXT
, pitches
[0],
755 EGL_DMA_BUF_PLANE0_OFFSET_EXT
, offsets
[0],
756 EGL_DMA_BUF_PLANE1_FD_EXT
, fd
,
757 EGL_DMA_BUF_PLANE1_PITCH_EXT
, pitches
[1],
758 EGL_DMA_BUF_PLANE1_OFFSET_EXT
, offsets
[1],
762 return dri2_create_image_dma_buf(disp
, ctx
, NULL
, attr_list_2plane
);
764 /* Fully planar Y + Cb + Cr or Y + Cr + Cb format. */
765 const EGLint attr_list_3plane
[] = {
766 EGL_WIDTH
, buf
->width
,
767 EGL_HEIGHT
, buf
->height
,
768 EGL_LINUX_DRM_FOURCC_EXT
, fourcc
,
769 EGL_DMA_BUF_PLANE0_FD_EXT
, fd
,
770 EGL_DMA_BUF_PLANE0_PITCH_EXT
, pitches
[0],
771 EGL_DMA_BUF_PLANE0_OFFSET_EXT
, offsets
[0],
772 EGL_DMA_BUF_PLANE1_FD_EXT
, fd
,
773 EGL_DMA_BUF_PLANE1_PITCH_EXT
, pitches
[1],
774 EGL_DMA_BUF_PLANE1_OFFSET_EXT
, offsets
[1],
775 EGL_DMA_BUF_PLANE2_FD_EXT
, fd
,
776 EGL_DMA_BUF_PLANE2_PITCH_EXT
, pitches
[2],
777 EGL_DMA_BUF_PLANE2_OFFSET_EXT
, offsets
[2],
781 return dri2_create_image_dma_buf(disp
, ctx
, NULL
, attr_list_3plane
);
786 droid_create_image_from_prime_fd(_EGLDisplay
*disp
, _EGLContext
*ctx
,
787 struct ANativeWindowBuffer
*buf
, int fd
)
791 if (is_yuv(buf
->format
))
792 return droid_create_image_from_prime_fd_yuv(disp
, ctx
, buf
, fd
);
794 const int fourcc
= get_fourcc(buf
->format
);
796 _eglError(EGL_BAD_PARAMETER
, "eglCreateEGLImageKHR");
800 pitch
= buf
->stride
* get_format_bpp(buf
->format
);
802 _eglError(EGL_BAD_PARAMETER
, "eglCreateEGLImageKHR");
806 const EGLint attr_list
[] = {
807 EGL_WIDTH
, buf
->width
,
808 EGL_HEIGHT
, buf
->height
,
809 EGL_LINUX_DRM_FOURCC_EXT
, fourcc
,
810 EGL_DMA_BUF_PLANE0_FD_EXT
, fd
,
811 EGL_DMA_BUF_PLANE0_PITCH_EXT
, pitch
,
812 EGL_DMA_BUF_PLANE0_OFFSET_EXT
, 0,
816 return dri2_create_image_dma_buf(disp
, ctx
, NULL
, attr_list
);
820 droid_create_image_from_name(_EGLDisplay
*disp
, _EGLContext
*ctx
,
821 struct ANativeWindowBuffer
*buf
)
823 struct dri2_egl_display
*dri2_dpy
= dri2_egl_display(disp
);
824 struct dri2_egl_image
*dri2_img
;
828 name
= get_native_buffer_name(buf
);
830 _eglError(EGL_BAD_PARAMETER
, "eglCreateEGLImageKHR");
834 format
= get_format(buf
->format
);
838 dri2_img
= calloc(1, sizeof(*dri2_img
));
840 _eglError(EGL_BAD_ALLOC
, "droid_create_image_mesa_drm");
844 _eglInitImage(&dri2_img
->base
, disp
);
846 dri2_img
->dri_image
=
847 dri2_dpy
->image
->createImageFromName(dri2_dpy
->dri_screen
,
854 if (!dri2_img
->dri_image
) {
856 _eglError(EGL_BAD_ALLOC
, "droid_create_image_mesa_drm");
860 return &dri2_img
->base
;
864 droid_query_surface(_EGLDriver
*drv
, _EGLDisplay
*dpy
, _EGLSurface
*surf
,
865 EGLint attribute
, EGLint
*value
)
867 struct dri2_egl_surface
*dri2_surf
= dri2_egl_surface(surf
);
870 if (dri2_surf
->base
.Type
== EGL_WINDOW_BIT
&& dri2_surf
->window
) {
871 dri2_surf
->window
->query(dri2_surf
->window
,
872 NATIVE_WINDOW_DEFAULT_WIDTH
, value
);
877 if (dri2_surf
->base
.Type
== EGL_WINDOW_BIT
&& dri2_surf
->window
) {
878 dri2_surf
->window
->query(dri2_surf
->window
,
879 NATIVE_WINDOW_DEFAULT_HEIGHT
, value
);
886 return _eglQuerySurface(drv
, dpy
, surf
, attribute
, value
);
890 dri2_create_image_android_native_buffer(_EGLDisplay
*disp
,
892 struct ANativeWindowBuffer
*buf
)
897 /* From the EGL_ANDROID_image_native_buffer spec:
899 * * If <target> is EGL_NATIVE_BUFFER_ANDROID and <ctx> is not
900 * EGL_NO_CONTEXT, the error EGL_BAD_CONTEXT is generated.
902 _eglError(EGL_BAD_CONTEXT
, "eglCreateEGLImageKHR: for "
903 "EGL_NATIVE_BUFFER_ANDROID, the context must be "
908 if (!buf
|| buf
->common
.magic
!= ANDROID_NATIVE_BUFFER_MAGIC
||
909 buf
->common
.version
!= sizeof(*buf
)) {
910 _eglError(EGL_BAD_PARAMETER
, "eglCreateEGLImageKHR");
914 fd
= get_native_buffer_fd(buf
);
916 return droid_create_image_from_prime_fd(disp
, ctx
, buf
, fd
);
918 return droid_create_image_from_name(disp
, ctx
, buf
);
922 droid_create_image_khr(_EGLDriver
*drv
, _EGLDisplay
*disp
,
923 _EGLContext
*ctx
, EGLenum target
,
924 EGLClientBuffer buffer
, const EGLint
*attr_list
)
927 case EGL_NATIVE_BUFFER_ANDROID
:
928 return dri2_create_image_android_native_buffer(disp
, ctx
,
929 (struct ANativeWindowBuffer
*) buffer
);
931 return dri2_create_image_khr(drv
, disp
, ctx
, target
, buffer
, attr_list
);
936 droid_flush_front_buffer(__DRIdrawable
* driDrawable
, void *loaderPrivate
)
941 droid_get_buffers_parse_attachments(struct dri2_egl_surface
*dri2_surf
,
942 unsigned int *attachments
, int count
)
946 /* fill dri2_surf->buffers */
947 for (int i
= 0; i
< count
* 2; i
+= 2) {
948 __DRIbuffer
*buf
, *local
;
950 assert(num_buffers
< ARRAY_SIZE(dri2_surf
->buffers
));
951 buf
= &dri2_surf
->buffers
[num_buffers
];
953 switch (attachments
[i
]) {
954 case __DRI_BUFFER_BACK_LEFT
:
955 if (dri2_surf
->base
.Type
== EGL_WINDOW_BIT
) {
956 buf
->attachment
= attachments
[i
];
957 buf
->name
= get_native_buffer_name(dri2_surf
->buffer
);
958 buf
->cpp
= get_format_bpp(dri2_surf
->buffer
->format
);
959 buf
->pitch
= dri2_surf
->buffer
->stride
* buf
->cpp
;
967 /* fall through for pbuffers */
968 case __DRI_BUFFER_DEPTH
:
969 case __DRI_BUFFER_STENCIL
:
970 case __DRI_BUFFER_ACCUM
:
971 case __DRI_BUFFER_DEPTH_STENCIL
:
972 case __DRI_BUFFER_HIZ
:
973 local
= droid_alloc_local_buffer(dri2_surf
,
974 attachments
[i
], attachments
[i
+ 1]);
981 case __DRI_BUFFER_FRONT_LEFT
:
982 case __DRI_BUFFER_FRONT_RIGHT
:
983 case __DRI_BUFFER_FAKE_FRONT_LEFT
:
984 case __DRI_BUFFER_FAKE_FRONT_RIGHT
:
985 case __DRI_BUFFER_BACK_RIGHT
:
987 /* no front or right buffers */
996 droid_get_buffers_with_format(__DRIdrawable
* driDrawable
,
997 int *width
, int *height
,
998 unsigned int *attachments
, int count
,
999 int *out_count
, void *loaderPrivate
)
1001 struct dri2_egl_surface
*dri2_surf
= loaderPrivate
;
1003 if (update_buffers(dri2_surf
) < 0)
1006 *out_count
= droid_get_buffers_parse_attachments(dri2_surf
, attachments
, count
);
1009 *width
= dri2_surf
->base
.Width
;
1011 *height
= dri2_surf
->base
.Height
;
1013 return dri2_surf
->buffers
;
1017 droid_get_capability(void *loaderPrivate
, enum dri_loader_cap cap
)
1019 /* Note: loaderPrivate is _EGLDisplay* */
1021 case DRI_LOADER_CAP_RGBA_ORDERING
:
1029 droid_add_configs_for_visuals(_EGLDriver
*drv
, _EGLDisplay
*dpy
)
1031 struct dri2_egl_display
*dri2_dpy
= dri2_egl_display(dpy
);
1032 static const struct {
1034 unsigned int rgba_masks
[4];
1036 { HAL_PIXEL_FORMAT_RGBA_8888
, { 0x000000ff, 0x0000ff00, 0x00ff0000, 0xff000000 } },
1037 { HAL_PIXEL_FORMAT_RGBX_8888
, { 0x000000ff, 0x0000ff00, 0x00ff0000, 0x00000000 } },
1038 { HAL_PIXEL_FORMAT_RGB_565
, { 0x0000f800, 0x000007e0, 0x0000001f, 0x00000000 } },
1039 { HAL_PIXEL_FORMAT_BGRA_8888
, { 0x00ff0000, 0x0000ff00, 0x000000ff, 0xff000000 } },
1042 unsigned int format_count
[ARRAY_SIZE(visuals
)] = { 0 };
1043 int config_count
= 0;
1045 /* The nesting of loops is significant here. Also significant is the order
1046 * of the HAL pixel formats. Many Android apps (such as Google's official
1047 * NDK GLES2 example app), and even portions the core framework code (such
1048 * as SystemServiceManager in Nougat), incorrectly choose their EGLConfig.
1049 * They neglect to match the EGLConfig's EGL_NATIVE_VISUAL_ID against the
1050 * window's native format, and instead choose the first EGLConfig whose
1051 * channel sizes match those of the native window format while ignoring the
1052 * channel *ordering*.
1054 * We can detect such buggy clients in logcat when they call
1055 * eglCreateSurface, by detecting the mismatch between the EGLConfig's
1056 * format and the window's format.
1058 * As a workaround, we generate EGLConfigs such that all EGLConfigs for HAL
1059 * pixel format i precede those for HAL pixel format i+1. In my
1060 * (chadversary) testing on Android Nougat, this was good enough to pacify
1061 * the buggy clients.
1063 for (int i
= 0; i
< ARRAY_SIZE(visuals
); i
++) {
1064 for (int j
= 0; dri2_dpy
->driver_configs
[j
]; j
++) {
1065 const EGLint surface_type
= EGL_WINDOW_BIT
| EGL_PBUFFER_BIT
;
1067 const EGLint config_attrs
[] = {
1068 EGL_NATIVE_VISUAL_ID
, visuals
[i
].format
,
1069 EGL_NATIVE_VISUAL_TYPE
, visuals
[i
].format
,
1070 EGL_FRAMEBUFFER_TARGET_ANDROID
, EGL_TRUE
,
1071 EGL_RECORDABLE_ANDROID
, EGL_TRUE
,
1075 struct dri2_egl_config
*dri2_conf
=
1076 dri2_add_config(dpy
, dri2_dpy
->driver_configs
[j
],
1077 config_count
+ 1, surface_type
, config_attrs
,
1078 visuals
[i
].rgba_masks
);
1080 if (dri2_conf
->base
.ConfigID
== config_count
+ 1)
1087 for (int i
= 0; i
< ARRAY_SIZE(format_count
); i
++) {
1088 if (!format_count
[i
]) {
1089 _eglLog(_EGL_DEBUG
, "No DRI config supports native format 0x%x",
1094 return (config_count
!= 0);
1098 droid_open_device(struct dri2_egl_display
*dri2_dpy
)
1100 int fd
= -1, err
= -EINVAL
;
1102 if (dri2_dpy
->gralloc
->perform
)
1103 err
= dri2_dpy
->gralloc
->perform(dri2_dpy
->gralloc
,
1104 GRALLOC_MODULE_PERFORM_GET_DRM_FD
,
1106 if (err
|| fd
< 0) {
1107 _eglLog(_EGL_WARNING
, "fail to get drm fd");
1111 return (fd
>= 0) ? fcntl(fd
, F_DUPFD_CLOEXEC
, 3) : -1;
1114 static const struct dri2_egl_display_vtbl droid_display_vtbl
= {
1115 .authenticate
= NULL
,
1116 .create_window_surface
= droid_create_window_surface
,
1117 .create_pixmap_surface
= dri2_fallback_create_pixmap_surface
,
1118 .create_pbuffer_surface
= droid_create_pbuffer_surface
,
1119 .destroy_surface
= droid_destroy_surface
,
1120 .create_image
= droid_create_image_khr
,
1121 .swap_interval
= dri2_fallback_swap_interval
,
1122 .swap_buffers
= droid_swap_buffers
,
1123 .swap_buffers_with_damage
= dri2_fallback_swap_buffers_with_damage
,
1124 .swap_buffers_region
= dri2_fallback_swap_buffers_region
,
1125 #if ANDROID_API_LEVEL >= 23
1126 .set_damage_region
= droid_set_damage_region
,
1128 .set_damage_region
= dri2_fallback_set_damage_region
,
1130 .post_sub_buffer
= dri2_fallback_post_sub_buffer
,
1131 .copy_buffers
= dri2_fallback_copy_buffers
,
1132 .query_buffer_age
= droid_query_buffer_age
,
1133 .query_surface
= droid_query_surface
,
1134 .create_wayland_buffer_from_image
= dri2_fallback_create_wayland_buffer_from_image
,
1135 .get_sync_values
= dri2_fallback_get_sync_values
,
1136 .get_dri_drawable
= dri2_surface_get_dri_drawable
,
1139 static const __DRIdri2LoaderExtension droid_dri2_loader_extension
= {
1140 .base
= { __DRI_DRI2_LOADER
, 4 },
1143 .flushFrontBuffer
= droid_flush_front_buffer
,
1144 .getBuffersWithFormat
= droid_get_buffers_with_format
,
1145 .getCapability
= droid_get_capability
,
1148 static const __DRIimageLoaderExtension droid_image_loader_extension
= {
1149 .base
= { __DRI_IMAGE_LOADER
, 2 },
1151 .getBuffers
= droid_image_get_buffers
,
1152 .flushFrontBuffer
= droid_flush_front_buffer
,
1153 .getCapability
= droid_get_capability
,
1156 static const __DRIextension
*droid_dri2_loader_extensions
[] = {
1157 &droid_dri2_loader_extension
.base
,
1158 &image_lookup_extension
.base
,
1159 &use_invalidate
.base
,
1163 static const __DRIextension
*droid_image_loader_extensions
[] = {
1164 &droid_image_loader_extension
.base
,
1165 &image_lookup_extension
.base
,
1166 &use_invalidate
.base
,
1171 dri2_initialize_android(_EGLDriver
*drv
, _EGLDisplay
*dpy
)
1173 struct dri2_egl_display
*dri2_dpy
;
1177 loader_set_logger(_eglLog
);
1179 dri2_dpy
= calloc(1, sizeof(*dri2_dpy
));
1181 return _eglError(EGL_BAD_ALLOC
, "eglInitialize");
1184 ret
= hw_get_module(GRALLOC_HARDWARE_MODULE_ID
,
1185 (const hw_module_t
**)&dri2_dpy
->gralloc
);
1187 err
= "DRI2: failed to get gralloc module";
1191 dpy
->DriverData
= (void *) dri2_dpy
;
1193 dri2_dpy
->fd
= droid_open_device(dri2_dpy
);
1194 if (dri2_dpy
->fd
< 0) {
1195 err
= "DRI2: failed to open device";
1199 dri2_dpy
->driver_name
= loader_get_driver_for_fd(dri2_dpy
->fd
);
1200 if (dri2_dpy
->driver_name
== NULL
) {
1201 err
= "DRI2: failed to get driver name";
1205 dri2_dpy
->is_render_node
= drmGetNodeTypeFromFd(dri2_dpy
->fd
) == DRM_NODE_RENDER
;
1207 /* render nodes cannot use Gem names, and thus do not support
1208 * the __DRI_DRI2_LOADER extension */
1209 if (!dri2_dpy
->is_render_node
) {
1210 dri2_dpy
->loader_extensions
= droid_dri2_loader_extensions
;
1211 if (!dri2_load_driver(dpy
)) {
1212 err
= "DRI2: failed to load driver";
1216 dri2_dpy
->loader_extensions
= droid_image_loader_extensions
;
1217 if (!dri2_load_driver_dri3(dpy
)) {
1218 err
= "DRI3: failed to load driver";
1223 if (!dri2_create_screen(dpy
)) {
1224 err
= "DRI2: failed to create screen";
1228 if (!dri2_setup_extensions(dpy
)) {
1229 err
= "DRI2: failed to setup extensions";
1233 dri2_setup_screen(dpy
);
1235 if (!droid_add_configs_for_visuals(drv
, dpy
)) {
1236 err
= "DRI2: failed to add configs";
1240 dpy
->Extensions
.ANDROID_framebuffer_target
= EGL_TRUE
;
1241 dpy
->Extensions
.ANDROID_image_native_buffer
= EGL_TRUE
;
1242 dpy
->Extensions
.ANDROID_recordable
= EGL_TRUE
;
1243 dpy
->Extensions
.EXT_buffer_age
= EGL_TRUE
;
1244 #if ANDROID_API_LEVEL >= 23
1245 dpy
->Extensions
.KHR_partial_update
= EGL_TRUE
;
1248 /* Fill vtbl last to prevent accidentally calling virtual function during
1251 dri2_dpy
->vtbl
= &droid_display_vtbl
;
1256 dri2_display_destroy(dpy
);
1257 return _eglError(EGL_NOT_INITIALIZED
, err
);