|  | /* | 
|  | * Copyright (C) 2009 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. | 
|  | */ | 
|  |  | 
|  |  | 
|  | #ifndef ANDROID_UI_EGLUTILS_H | 
|  | #define ANDROID_UI_EGLUTILS_H | 
|  |  | 
|  | #include <stdint.h> | 
|  | #include <stdlib.h> | 
|  | #include <vector> | 
|  |  | 
|  | #include <EGL/egl.h> | 
|  | #include <EGL/eglext.h> | 
|  | #include <GLES2/gl2.h> | 
|  | #include <system/window.h> | 
|  | #include <utils/Errors.h> | 
|  | #include <utils/String8.h> | 
|  |  | 
|  | extern "C" EGLAPI const char* eglQueryStringImplementationANDROID(EGLDisplay dpy, EGLint name); | 
|  |  | 
|  | // ---------------------------------------------------------------------------- | 
|  | namespace android { | 
|  | // ---------------------------------------------------------------------------- | 
|  |  | 
|  | class EGLUtils | 
|  | { | 
|  | public: | 
|  |  | 
|  | static inline const char *strerror(EGLint err); | 
|  |  | 
|  | static inline status_t selectConfigForPixelFormat( | 
|  | EGLDisplay dpy, | 
|  | EGLint const* attrs, | 
|  | int32_t format, | 
|  | EGLConfig* outConfig); | 
|  |  | 
|  | static inline status_t selectConfigForNativeWindow( | 
|  | EGLDisplay dpy, | 
|  | EGLint const* attrs, | 
|  | EGLNativeWindowType window, | 
|  | EGLConfig* outConfig); | 
|  |  | 
|  | static inline String8 printGLString(const char* name, GLenum s); | 
|  | static inline String8 printEGLString(EGLDisplay dpy, const char* name, GLenum s); | 
|  | static inline String8 checkEglError(const char* op, EGLBoolean returnVal); | 
|  | static inline String8 checkGlError(const char* op); | 
|  | static inline String8 printEGLConfiguration(EGLDisplay dpy, EGLConfig config); | 
|  | static inline bool printEGLConfigurations(EGLDisplay dpy, String8& msg); | 
|  | static inline bool printEGLConfigurations(FILE* output, EGLDisplay dpy); | 
|  | static inline String8 decodeColorSpace(EGLint colorSpace); | 
|  | static inline bool hasEglExtension(EGLDisplay dpy, const char* name); | 
|  | static inline bool hasExtension(const char* exts, const char* name); | 
|  | }; | 
|  |  | 
|  | // ---------------------------------------------------------------------------- | 
|  |  | 
|  | const char *EGLUtils::strerror(EGLint err) | 
|  | { | 
|  | switch (err){ | 
|  | case EGL_SUCCESS:           return "EGL_SUCCESS"; | 
|  | case EGL_NOT_INITIALIZED:   return "EGL_NOT_INITIALIZED"; | 
|  | case EGL_BAD_ACCESS:        return "EGL_BAD_ACCESS"; | 
|  | case EGL_BAD_ALLOC:         return "EGL_BAD_ALLOC"; | 
|  | case EGL_BAD_ATTRIBUTE:     return "EGL_BAD_ATTRIBUTE"; | 
|  | case EGL_BAD_CONFIG:        return "EGL_BAD_CONFIG"; | 
|  | case EGL_BAD_CONTEXT:       return "EGL_BAD_CONTEXT"; | 
|  | case EGL_BAD_CURRENT_SURFACE: return "EGL_BAD_CURRENT_SURFACE"; | 
|  | case EGL_BAD_DISPLAY:       return "EGL_BAD_DISPLAY"; | 
|  | case EGL_BAD_MATCH:         return "EGL_BAD_MATCH"; | 
|  | case EGL_BAD_NATIVE_PIXMAP: return "EGL_BAD_NATIVE_PIXMAP"; | 
|  | case EGL_BAD_NATIVE_WINDOW: return "EGL_BAD_NATIVE_WINDOW"; | 
|  | case EGL_BAD_PARAMETER:     return "EGL_BAD_PARAMETER"; | 
|  | case EGL_BAD_SURFACE:       return "EGL_BAD_SURFACE"; | 
|  | case EGL_CONTEXT_LOST:      return "EGL_CONTEXT_LOST"; | 
|  | default: return "UNKNOWN"; | 
|  | } | 
|  | } | 
|  |  | 
|  | status_t EGLUtils::selectConfigForPixelFormat( | 
|  | EGLDisplay dpy, | 
|  | EGLint const* attrs, | 
|  | int32_t format, | 
|  | EGLConfig* outConfig) | 
|  | { | 
|  | EGLint numConfigs = -1, n=0; | 
|  |  | 
|  | if (!attrs) | 
|  | return BAD_VALUE; | 
|  |  | 
|  | if (outConfig == nullptr) | 
|  | return BAD_VALUE; | 
|  |  | 
|  | // Get all the "potential match" configs... | 
|  | if (eglGetConfigs(dpy, nullptr, 0, &numConfigs) == EGL_FALSE) | 
|  | return BAD_VALUE; | 
|  |  | 
|  | std::vector<EGLConfig> configs(numConfigs); | 
|  | if (eglChooseConfig(dpy, attrs, configs.data(), numConfigs, &n) == EGL_FALSE) { | 
|  | return BAD_VALUE; | 
|  | } | 
|  |  | 
|  | int i; | 
|  | EGLConfig config = nullptr; | 
|  | for (i=0 ; i<n ; i++) { | 
|  | EGLint nativeVisualId = 0; | 
|  | eglGetConfigAttrib(dpy, configs[i], EGL_NATIVE_VISUAL_ID, &nativeVisualId); | 
|  | if (nativeVisualId>0 && format == nativeVisualId) { | 
|  | config = configs[i]; | 
|  | break; | 
|  | } | 
|  | } | 
|  |  | 
|  | if (i<n) { | 
|  | *outConfig = config; | 
|  | return NO_ERROR; | 
|  | } | 
|  |  | 
|  | return NAME_NOT_FOUND; | 
|  | } | 
|  |  | 
|  | status_t EGLUtils::selectConfigForNativeWindow( | 
|  | EGLDisplay dpy, | 
|  | EGLint const* attrs, | 
|  | EGLNativeWindowType window, | 
|  | EGLConfig* outConfig) | 
|  | { | 
|  | int err; | 
|  | int format; | 
|  |  | 
|  | if (!window) | 
|  | return BAD_VALUE; | 
|  |  | 
|  | if ((err = window->query(window, NATIVE_WINDOW_FORMAT, &format)) < 0) { | 
|  | return err; | 
|  | } | 
|  |  | 
|  | return selectConfigForPixelFormat(dpy, attrs, format, outConfig); | 
|  | } | 
|  |  | 
|  | String8 EGLUtils::printGLString(const char* name, GLenum s) { | 
|  | String8 msg; | 
|  | const char* v = reinterpret_cast<const char*>(glGetString(s)); | 
|  | msg.appendFormat("GL %s = %s\n", name, v); | 
|  | return msg; | 
|  | } | 
|  |  | 
|  | String8 EGLUtils::printEGLString(EGLDisplay dpy, const char* name, GLenum s) { | 
|  | String8 msg; | 
|  | const char* v = static_cast<const char*>(eglQueryString(dpy, s)); | 
|  | msg.appendFormat("GL %s = %s\n", name, v); | 
|  | const char* va = (const char*)eglQueryStringImplementationANDROID(dpy, s); | 
|  | msg.appendFormat("ImplementationANDROID: %s = %s\n", name, va); | 
|  | return msg; | 
|  | } | 
|  |  | 
|  | String8 EGLUtils::checkEglError(const char* op, EGLBoolean returnVal = EGL_TRUE) { | 
|  | String8 msg; | 
|  | if (returnVal != EGL_TRUE) { | 
|  | msg.appendFormat("%s() returned %d\n", op, returnVal); | 
|  | } | 
|  |  | 
|  | for (EGLint error = eglGetError(); error != EGL_SUCCESS; error = eglGetError()) { | 
|  | msg.appendFormat("after %s() eglError %s (0x%x)\n", op, EGLUtils::strerror(error), error); | 
|  | } | 
|  | return msg; | 
|  | } | 
|  |  | 
|  | String8 EGLUtils::checkGlError(const char* op) { | 
|  | String8 msg; | 
|  | for (GLint error = glGetError(); error != GL_NO_ERROR; error = glGetError()) { | 
|  | msg.appendFormat("after %s() glError (0x%x)\n", op, error); | 
|  | } | 
|  | return msg; | 
|  | } | 
|  |  | 
|  | String8 EGLUtils::printEGLConfiguration(EGLDisplay dpy, EGLConfig config) { | 
|  | #define X(VAL) \ | 
|  | { VAL, #VAL } | 
|  | struct { | 
|  | EGLint attribute; | 
|  | const char* name; | 
|  | } names[] = { | 
|  | X(EGL_BUFFER_SIZE), | 
|  | X(EGL_ALPHA_SIZE), | 
|  | X(EGL_BLUE_SIZE), | 
|  | X(EGL_GREEN_SIZE), | 
|  | X(EGL_RED_SIZE), | 
|  | X(EGL_DEPTH_SIZE), | 
|  | X(EGL_STENCIL_SIZE), | 
|  | X(EGL_CONFIG_CAVEAT), | 
|  | X(EGL_CONFIG_ID), | 
|  | X(EGL_LEVEL), | 
|  | X(EGL_MAX_PBUFFER_HEIGHT), | 
|  | X(EGL_MAX_PBUFFER_PIXELS), | 
|  | X(EGL_MAX_PBUFFER_WIDTH), | 
|  | X(EGL_NATIVE_RENDERABLE), | 
|  | X(EGL_NATIVE_VISUAL_ID), | 
|  | X(EGL_NATIVE_VISUAL_TYPE), | 
|  | X(EGL_SAMPLES), | 
|  | X(EGL_SAMPLE_BUFFERS), | 
|  | X(EGL_SURFACE_TYPE), | 
|  | X(EGL_TRANSPARENT_TYPE), | 
|  | X(EGL_TRANSPARENT_RED_VALUE), | 
|  | X(EGL_TRANSPARENT_GREEN_VALUE), | 
|  | X(EGL_TRANSPARENT_BLUE_VALUE), | 
|  | X(EGL_BIND_TO_TEXTURE_RGB), | 
|  | X(EGL_BIND_TO_TEXTURE_RGBA), | 
|  | X(EGL_MIN_SWAP_INTERVAL), | 
|  | X(EGL_MAX_SWAP_INTERVAL), | 
|  | X(EGL_LUMINANCE_SIZE), | 
|  | X(EGL_ALPHA_MASK_SIZE), | 
|  | X(EGL_COLOR_BUFFER_TYPE), | 
|  | X(EGL_RENDERABLE_TYPE), | 
|  | X(EGL_CONFORMANT), | 
|  | }; | 
|  | #undef X | 
|  |  | 
|  | String8 msg; | 
|  | for (size_t j = 0; j < sizeof(names) / sizeof(names[0]); j++) { | 
|  | EGLint value = -1; | 
|  | EGLint returnVal = eglGetConfigAttrib(dpy, config, names[j].attribute, &value); | 
|  | EGLint error = eglGetError(); | 
|  | if (returnVal && error == EGL_SUCCESS) { | 
|  | msg.appendFormat(" %s: %d (0x%x)", names[j].name, value, value); | 
|  | } | 
|  | } | 
|  | msg.append("\n"); | 
|  | return msg; | 
|  | } | 
|  |  | 
|  | bool EGLUtils::printEGLConfigurations(EGLDisplay dpy, String8& msg) { | 
|  | EGLint numConfig = 0; | 
|  | EGLint returnVal = eglGetConfigs(dpy, nullptr, 0, &numConfig); | 
|  | msg.append(checkEglError("eglGetConfigs", returnVal)); | 
|  | if (!returnVal) { | 
|  | return false; | 
|  | } | 
|  |  | 
|  | msg.appendFormat("Number of EGL configuration: %d\n", numConfig); | 
|  |  | 
|  | std::vector<EGLConfig> configs(numConfig); | 
|  |  | 
|  | returnVal = eglGetConfigs(dpy, configs.data(), numConfig, &numConfig); | 
|  | msg.append(checkEglError("eglGetConfigs", returnVal)); | 
|  | if (!returnVal) { | 
|  | return false; | 
|  | } | 
|  |  | 
|  | for (int i = 0; i < numConfig; i++) { | 
|  | msg.appendFormat("Configuration %d\n", i); | 
|  | msg.append(printEGLConfiguration(dpy, configs[i])); | 
|  | } | 
|  |  | 
|  | return true; | 
|  | } | 
|  |  | 
|  | bool EGLUtils::printEGLConfigurations(FILE* output, EGLDisplay dpy) { | 
|  | String8 msg; | 
|  | bool status = printEGLConfigurations(dpy, msg); | 
|  | fprintf(output, "%s", msg.c_str()); | 
|  | return status; | 
|  | } | 
|  |  | 
|  | String8 EGLUtils::decodeColorSpace(EGLint colorSpace) { | 
|  | switch (colorSpace) { | 
|  | case EGL_GL_COLORSPACE_SRGB_KHR: | 
|  | return String8("EGL_GL_COLORSPACE_SRGB_KHR"); | 
|  | case EGL_GL_COLORSPACE_DISPLAY_P3_EXT: | 
|  | return String8("EGL_GL_COLORSPACE_DISPLAY_P3_EXT"); | 
|  | case EGL_GL_COLORSPACE_DISPLAY_P3_PASSTHROUGH_EXT: | 
|  | return String8("EGL_GL_COLORSPACE_DISPLAY_P3_PASSTHROUGH_EXT"); | 
|  | case  EGL_GL_COLORSPACE_LINEAR_KHR: | 
|  | return String8("EGL_GL_COLORSPACE_LINEAR_KHR"); | 
|  | default: | 
|  | return String8::format("UNKNOWN ColorSpace %d", colorSpace); | 
|  | } | 
|  | } | 
|  |  | 
|  | bool EGLUtils::hasExtension(const char* exts, const char* name) { | 
|  | size_t nameLen = strlen(name); | 
|  | if (exts) { | 
|  | for (const char* match = strstr(exts, name); match; match = strstr(match + nameLen, name)) { | 
|  | if (match[nameLen] == '\0' || match[nameLen] == ' ') { | 
|  | return true; | 
|  | } | 
|  | } | 
|  | } | 
|  | return false; | 
|  | } | 
|  |  | 
|  | bool EGLUtils::hasEglExtension(EGLDisplay dpy, const char* name) { | 
|  | return hasExtension(eglQueryString(dpy, EGL_EXTENSIONS), name); | 
|  | } | 
|  |  | 
|  | // ---------------------------------------------------------------------------- | 
|  | }; // namespace android | 
|  | // ---------------------------------------------------------------------------- | 
|  |  | 
|  | #endif /* ANDROID_UI_EGLUTILS_H */ |