/* ** Copyright 2007, The Android Open Source Project ** ** Licensed under the Apache License, Version 2.0 (the "License"); ** you may not use this file except in compliance with the License. ** You may obtain a copy of the License at ** ** http://www.apache.org/licenses/LICENSE-2.0 ** ** Unless required by applicable law or agreed to in writing, software ** distributed under the License is distributed on an "AS IS" BASIS, ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. ** See the License for the specific language governing permissions and ** limitations under the License. */ #define __STDC_LIMIT_MACROS 1 #define ATRACE_TAG ATRACE_TAG_GRAPHICS #include "egl_display.h" #include "../egl_impl.h" #include #include #include #include "Loader.h" #include "egl_angle_platform.h" #include "egl_cache.h" #include "egl_object.h" #include "egl_tls.h" #include #include #include #include #include using namespace android::hardware::configstore; using namespace android::hardware::configstore::V1_0; // ---------------------------------------------------------------------------- namespace android { // ---------------------------------------------------------------------------- static char const * const sVendorString = "Android"; static char const* const sVersionString14 = "1.4 Android META-EGL"; static char const* const sVersionString15 = "1.5 Android META-EGL"; static char const * const sClientApiString = "OpenGL_ES"; extern char const * const gBuiltinExtensionString; extern char const * const gExtensionString; extern void setGLHooksThreadSpecific(gl_hooks_t const *value); // ---------------------------------------------------------------------------- bool findExtension(const char* exts, const char* name, size_t nameLen) { if (exts) { if (!nameLen) { nameLen = strlen(name); } for (const char* match = strstr(exts, name); match; match = strstr(match + nameLen, name)) { if (match[nameLen] == '\0' || match[nameLen] == ' ') { return true; } } } return false; } bool needsAndroidPEglMitigation() { static const int32_t vndk_version = property_get_int32("ro.vndk.version", -1); return vndk_version <= 28; } int egl_get_init_count(EGLDisplay dpy) { egl_display_t* eglDisplay = egl_display_t::get(dpy); return eglDisplay ? eglDisplay->getRefsCount() : 0; } egl_display_t egl_display_t::sDisplay[NUM_DISPLAYS]; egl_display_t::egl_display_t() : magic('_dpy'), finishOnSwap(false), traceGpuCompletion(false), refs(0), eglIsInitialized(false) { } egl_display_t::~egl_display_t() { magic = 0; egl_cache_t::get()->terminate(); } egl_display_t* egl_display_t::get(EGLDisplay dpy) { if (uintptr_t(dpy) == 0) { return nullptr; } uintptr_t index = uintptr_t(dpy)-1U; if (index >= NUM_DISPLAYS || !sDisplay[index].isValid()) { return nullptr; } return &sDisplay[index]; } void egl_display_t::addObject(egl_object_t* object) { std::lock_guard _l(lock); objects.insert(object); } void egl_display_t::removeObject(egl_object_t* object) { std::lock_guard _l(lock); objects.erase(object); } bool egl_display_t::getObject(egl_object_t* object) const { std::lock_guard _l(lock); if (objects.find(object) != objects.end()) { if (object->getDisplay() == this) { object->incRef(); return true; } } return false; } EGLDisplay egl_display_t::getFromNativeDisplay(EGLNativeDisplayType disp, const EGLAttrib* attrib_list) { if (uintptr_t(disp) >= NUM_DISPLAYS) return nullptr; return sDisplay[uintptr_t(disp)].getPlatformDisplay(disp, attrib_list); } static bool addAnglePlatformAttributes(egl_connection_t* const cnx, std::vector& attrs) { intptr_t vendorEGL = (intptr_t)cnx->vendorEGL; attrs.reserve(4 * 2); attrs.push_back(EGL_PLATFORM_ANGLE_TYPE_ANGLE); attrs.push_back(cnx->angleBackend); switch (cnx->angleBackend) { case EGL_PLATFORM_ANGLE_TYPE_VULKAN_ANGLE: ALOGV("%s: Requesting Vulkan ANGLE back-end", __FUNCTION__); char prop[PROPERTY_VALUE_MAX]; property_get("debug.angle.validation", prop, "0"); attrs.push_back(EGL_PLATFORM_ANGLE_DEBUG_LAYERS_ENABLED_ANGLE); attrs.push_back(atoi(prop)); break; case EGL_PLATFORM_ANGLE_TYPE_DEFAULT_ANGLE: ALOGV("%s: Requesting Default ANGLE back-end", __FUNCTION__); break; case EGL_PLATFORM_ANGLE_TYPE_OPENGLES_ANGLE: ALOGV("%s: Requesting OpenGL ES ANGLE back-end", __FUNCTION__); // NOTE: This is only valid if the backend is OpenGL attrs.push_back(EGL_PLATFORM_ANGLE_EGL_HANDLE_ANGLE); attrs.push_back(vendorEGL); // Context virtualization is only available on GL back-end. // Needed to support threading with GL back-end attrs.push_back(EGL_PLATFORM_ANGLE_CONTEXT_VIRTUALIZATION_ANGLE); attrs.push_back(EGL_FALSE); break; default: ALOGE("%s: Requesting Unknown (%d) ANGLE back-end", __FUNCTION__, cnx->angleBackend); break; } return true; } static EGLDisplay getPlatformDisplayAngle(EGLNativeDisplayType display, egl_connection_t* const cnx, const EGLAttrib* attrib_list, EGLint* error) { EGLDisplay dpy = EGL_NO_DISPLAY; *error = EGL_NONE; if (cnx->egl.eglGetPlatformDisplay) { std::vector attrs; if (attrib_list) { for (const EGLAttrib* attr = attrib_list; *attr != EGL_NONE; attr += 2) { attrs.push_back(attr[0]); attrs.push_back(attr[1]); } } if (!addAnglePlatformAttributes(cnx, attrs)) { ALOGE("eglGetDisplay(%p) failed: Mismatch display request", display); *error = EGL_BAD_PARAMETER; return EGL_NO_DISPLAY; } attrs.push_back(EGL_NONE); dpy = cnx->egl.eglGetPlatformDisplay(EGL_PLATFORM_ANGLE_ANGLE, reinterpret_cast(EGL_DEFAULT_DISPLAY), attrs.data()); if (dpy == EGL_NO_DISPLAY) { ALOGE("eglGetPlatformDisplay failed!"); } else { if (!angle::initializeAnglePlatform(dpy)) { ALOGE("initializeAnglePlatform failed!"); } } } else { ALOGE("eglGetDisplay(%p) failed: Unable to look up eglGetPlatformDisplay from ANGLE", display); } return dpy; } EGLDisplay egl_display_t::getPlatformDisplay(EGLNativeDisplayType display, const EGLAttrib* attrib_list) { std::lock_guard _l(lock); ATRACE_CALL(); // get our driver loader Loader& loader(Loader::getInstance()); egl_connection_t* const cnx = &gEGLImpl; if (cnx->dso) { EGLDisplay dpy = EGL_NO_DISPLAY; if (cnx->useAngle) { EGLint error; dpy = getPlatformDisplayAngle(display, cnx, attrib_list, &error); if (error != EGL_NONE) { return setError(error, dpy); } } if (dpy == EGL_NO_DISPLAY) { // NOTE: eglGetPlatformDisplay with a empty attribute list // behaves the same as eglGetDisplay if (cnx->egl.eglGetPlatformDisplay) { dpy = cnx->egl.eglGetPlatformDisplay(EGL_PLATFORM_ANDROID_KHR, display, attrib_list); } // It is possible that eglGetPlatformDisplay does not have a // working implementation for Android platform; in that case, // one last fallback to eglGetDisplay if(dpy == EGL_NO_DISPLAY) { if (attrib_list) { ALOGW("getPlatformDisplay: unexpected attribute list, attributes ignored"); } dpy = cnx->egl.eglGetDisplay(display); } } disp.dpy = dpy; if (dpy == EGL_NO_DISPLAY) { loader.close(cnx); } } return EGLDisplay(uintptr_t(display) + 1U); } EGLBoolean egl_display_t::initialize(EGLint *major, EGLint *minor) { { // scope for refLock std::unique_lock _l(refLock); refs++; if (refs > 1) { // We don't know what to report until we know what the // driver supports. Make sure we are initialized before // returning the version info. while(!eglIsInitialized) { refCond.wait(_l); } egl_connection_t* const cnx = &gEGLImpl; // TODO: If device doesn't provide 1.4 or 1.5 then we'll be // changing the behavior from the past where we always advertise // version 1.4. May need to check that revision is valid // before using cnx->major & cnx->minor if (major != nullptr) *major = cnx->major; if (minor != nullptr) *minor = cnx->minor; return EGL_TRUE; } while(eglIsInitialized) { refCond.wait(_l); } } { // scope for lock std::lock_guard _l(lock); setGLHooksThreadSpecific(&gHooksNoContext); // initialize each EGL and // build our own extension string first, based on the extension we know // and the extension supported by our client implementation egl_connection_t* const cnx = &gEGLImpl; cnx->major = -1; cnx->minor = -1; if (cnx->dso) { EGLDisplay idpy = disp.dpy; if (cnx->egl.eglInitialize(idpy, &cnx->major, &cnx->minor)) { //ALOGD("initialized dpy=%p, ver=%d.%d, cnx=%p", // idpy, cnx->major, cnx->minor, cnx); // display is now initialized disp.state = egl_display_t::INITIALIZED; // get the query-strings for this display for each implementation disp.queryString.vendor = cnx->egl.eglQueryString(idpy, EGL_VENDOR); disp.queryString.version = cnx->egl.eglQueryString(idpy, EGL_VERSION); disp.queryString.extensions = cnx->egl.eglQueryString(idpy, EGL_EXTENSIONS); disp.queryString.clientApi = cnx->egl.eglQueryString(idpy, EGL_CLIENT_APIS); } else { ALOGW("eglInitialize(%p) failed (%s)", idpy, egl_tls_t::egl_strerror(cnx->egl.eglGetError())); } } if (cnx->minor == 5) { // full list in egl_entries.in if (!cnx->egl.eglCreateImage || !cnx->egl.eglDestroyImage || !cnx->egl.eglGetPlatformDisplay || !cnx->egl.eglCreatePlatformWindowSurface || !cnx->egl.eglCreatePlatformPixmapSurface || !cnx->egl.eglCreateSync || !cnx->egl.eglDestroySync || !cnx->egl.eglClientWaitSync || !cnx->egl.eglGetSyncAttrib || !cnx->egl.eglWaitSync) { ALOGE("Driver indicates EGL 1.5 support, but does not have " "a critical API"); cnx->minor = 4; } } // the query strings are per-display mVendorString = sVendorString; mVersionString.clear(); cnx->driverVersion = EGL_MAKE_VERSION(1, 4, 0); mVersionString = sVersionString14; if ((cnx->major == 1) && (cnx->minor == 5)) { mVersionString = sVersionString15; cnx->driverVersion = EGL_MAKE_VERSION(1, 5, 0); } if (mVersionString.empty()) { ALOGW("Unexpected driver version: %d.%d, want 1.4 or 1.5", cnx->major, cnx->minor); mVersionString = sVersionString14; } mClientApiString = sClientApiString; mExtensionString = gBuiltinExtensionString; hasColorSpaceSupport = findExtension(disp.queryString.extensions, "EGL_KHR_gl_colorspace"); // Note: CDD requires that devices supporting wide color and/or HDR color also support // the EGL_KHR_gl_colorspace extension. bool wideColorBoardConfig = getBool( false); // Add wide-color extensions if device can support wide-color if (wideColorBoardConfig && hasColorSpaceSupport) { mExtensionString.append( "EGL_EXT_gl_colorspace_scrgb EGL_EXT_gl_colorspace_scrgb_linear " "EGL_EXT_gl_colorspace_display_p3_linear EGL_EXT_gl_colorspace_display_p3 " "EGL_EXT_gl_colorspace_display_p3_passthrough "); } bool hasHdrBoardConfig = getBool(false); if (hasHdrBoardConfig && hasColorSpaceSupport) { // hasHDRBoardConfig indicates the system is capable of supporting HDR content. // Typically that means there is an HDR capable display attached, but could be // support for attaching an HDR display. In either case, advertise support for // HDR color spaces. mExtensionString.append( "EGL_EXT_gl_colorspace_bt2020_linear EGL_EXT_gl_colorspace_bt2020_pq "); } char const* start = gExtensionString; do { // length of the extension name size_t len = strcspn(start, " "); if (len) { // NOTE: we could avoid the copy if we had strnstr. const std::string ext(start, len); // Mitigation for Android P vendor partitions: Adreno 530 driver shipped on // some Android P vendor partitions this extension under the draft KHR name, // but during Khronos review it was decided to demote it to EXT. if (needsAndroidPEglMitigation() && ext == "EGL_EXT_image_gl_colorspace" && findExtension(disp.queryString.extensions, "EGL_KHR_image_gl_colorspace")) { mExtensionString.append("EGL_EXT_image_gl_colorspace "); } if (findExtension(disp.queryString.extensions, ext.c_str(), len)) { mExtensionString.append(ext + " "); } // advance to the next extension name, skipping the space. start += len; start += (*start == ' ') ? 1 : 0; } } while (*start != '\0'); egl_cache_t::get()->initialize(this); char value[PROPERTY_VALUE_MAX]; property_get("debug.egl.finish", value, "0"); if (atoi(value)) { finishOnSwap = true; } property_get("debug.egl.traceGpuCompletion", value, "0"); if (atoi(value)) { traceGpuCompletion = true; } // TODO: If device doesn't provide 1.4 or 1.5 then we'll be // changing the behavior from the past where we always advertise // version 1.4. May need to check that revision is valid // before using cnx->major & cnx->minor if (major != nullptr) *major = cnx->major; if (minor != nullptr) *minor = cnx->minor; } { // scope for refLock std::unique_lock _l(refLock); eglIsInitialized = true; refCond.notify_all(); } return EGL_TRUE; } EGLBoolean egl_display_t::terminate() { { // scope for refLock std::unique_lock _rl(refLock); if (refs == 0) { /* * From the EGL spec (3.2): * "Termination of a display that has already been terminated, * (...), is allowed, but the only effect of such a call is * to return EGL_TRUE (...) */ return EGL_TRUE; } // this is specific to Android, display termination is ref-counted. refs--; if (refs > 0) { return EGL_TRUE; } } EGLBoolean res = EGL_FALSE; { // scope for lock std::lock_guard _l(lock); egl_connection_t* const cnx = &gEGLImpl; if (cnx->dso && disp.state == egl_display_t::INITIALIZED) { // If we're using ANGLE reset any custom DisplayPlatform if (cnx->useAngle) { angle::resetAnglePlatform(disp.dpy); } if (cnx->egl.eglTerminate(disp.dpy) == EGL_FALSE) { ALOGW("eglTerminate(%p) failed (%s)", disp.dpy, egl_tls_t::egl_strerror(cnx->egl.eglGetError())); } // REVISIT: it's unclear what to do if eglTerminate() fails disp.state = egl_display_t::TERMINATED; res = EGL_TRUE; } // Reset the extension string since it will be regenerated if we get // reinitialized. mExtensionString.clear(); // Mark all objects remaining in the list as terminated, unless // there are no reference to them, it which case, we're free to // delete them. size_t count = objects.size(); ALOGW_IF(count, "eglTerminate() called w/ %zu objects remaining", count); for (auto o : objects) { o->destroy(); } // this marks all object handles are "terminated" objects.clear(); } { // scope for refLock std::unique_lock _rl(refLock); eglIsInitialized = false; refCond.notify_all(); } return res; } void egl_display_t::loseCurrent(egl_context_t * cur_c) { if (cur_c) { egl_display_t* display = cur_c->getDisplay(); if (display) { display->loseCurrentImpl(cur_c); } } } void egl_display_t::loseCurrentImpl(egl_context_t * cur_c) { // by construction, these are either 0 or valid (possibly terminated) // it should be impossible for these to be invalid ContextRef _cur_c(cur_c); SurfaceRef _cur_r(cur_c ? get_surface(cur_c->read) : nullptr); SurfaceRef _cur_d(cur_c ? get_surface(cur_c->draw) : nullptr); { // scope for the lock std::lock_guard _l(lock); cur_c->onLooseCurrent(); } // This cannot be called with the lock held because it might end-up // calling back into EGL (in particular when a surface is destroyed // it calls ANativeWindow::disconnect _cur_c.release(); _cur_r.release(); _cur_d.release(); } EGLBoolean egl_display_t::makeCurrent(egl_context_t* c, egl_context_t* cur_c, EGLSurface draw, EGLSurface read, EGLContext /*ctx*/, EGLSurface impl_draw, EGLSurface impl_read, EGLContext impl_ctx) { EGLBoolean result; // by construction, these are either 0 or valid (possibly terminated) // it should be impossible for these to be invalid ContextRef _cur_c(cur_c); SurfaceRef _cur_r(cur_c ? get_surface(cur_c->read) : nullptr); SurfaceRef _cur_d(cur_c ? get_surface(cur_c->draw) : nullptr); { // scope for the lock std::lock_guard _l(lock); if (c) { result = c->cnx->egl.eglMakeCurrent( disp.dpy, impl_draw, impl_read, impl_ctx); if (result == EGL_TRUE) { c->onMakeCurrent(draw, read); } } else { result = cur_c->cnx->egl.eglMakeCurrent( disp.dpy, impl_draw, impl_read, impl_ctx); if (result == EGL_TRUE) { cur_c->onLooseCurrent(); } } } if (result == EGL_TRUE) { // This cannot be called with the lock held because it might end-up // calling back into EGL (in particular when a surface is destroyed // it calls ANativeWindow::disconnect _cur_c.release(); _cur_r.release(); _cur_d.release(); } return result; } bool egl_display_t::haveExtension(const char* name, size_t nameLen) const { if (!nameLen) { nameLen = strlen(name); } return findExtension(mExtensionString.c_str(), name, nameLen); } // ---------------------------------------------------------------------------- }; // namespace android // ----------------------------------------------------------------------------