/* * Copyright 2011-2026 Branimir Karadzic. All rights reserved. * License: https://github.com/bkaradzic/bgfx/blob/master/LICENSE */ #include "bgfx_p.h" #if (BGFX_CONFIG_RENDERER_OPENGLES || BGFX_CONFIG_RENDERER_OPENGL) # include "renderer_gl.h" # if BGFX_USE_EGL # if BX_PLATFORM_RPI # include # include # endif // BX_PLATFORM_RPI #define _EGL_CHECK(_check, _call) \ BX_MACRO_BLOCK_BEGIN \ EGLBoolean success = _call; \ _check(success, #_call "; EGL error 0x%x", eglGetError() ); \ BX_MACRO_BLOCK_END #if BGFX_CONFIG_DEBUG # define EGL_CHECK(_call) _EGL_CHECK(BX_ASSERT, _call) #else # define EGL_CHECK(_call) _call #endif // BGFX_CONFIG_DEBUG namespace bgfx { namespace gl { #ifndef EGL_CONTEXT_FLAG_NO_ERROR_BIT_KHR # define EGL_CONTEXT_FLAG_NO_ERROR_BIT_KHR 0x00000008 #endif // EGL_CONTEXT_FLAG_NO_ERROR_BIT_KHR #if BGFX_USE_GL_DYNAMIC_LIB #define EGL_IMPORT \ EGL_IMPORT_FUNC(PFNEGLBINDAPIPROC, eglBindAPI); \ EGL_IMPORT_FUNC(PFNEGLCHOOSECONFIGPROC, eglChooseConfig); \ EGL_IMPORT_FUNC(PFNEGLCREATECONTEXTPROC, eglCreateContext); \ EGL_IMPORT_FUNC(PFNEGLCREATEPBUFFERSURFACEPROC, eglCreatePbufferSurface); \ EGL_IMPORT_FUNC(PFNEGLCREATEWINDOWSURFACEPROC, eglCreateWindowSurface); \ EGL_IMPORT_FUNC(PFNEGLDESTROYCONTEXTPROC, eglDestroyContext); \ EGL_IMPORT_FUNC(PFNEGLDESTROYSURFACEPROC, eglDestroySurface); \ EGL_IMPORT_FUNC(PFNEGLGETCURRENTCONTEXTPROC, eglGetCurrentContext); \ EGL_IMPORT_FUNC(PFNEGLGETCURRENTDISPLAYPROC, eglGetCurrentDisplay); \ EGL_IMPORT_FUNC(PFNEGLGETCURRENTSURFACEPROC, eglGetCurrentSurface); \ EGL_IMPORT_FUNC(PFNEGLGETPLATFORMDISPLAYPROC, eglGetPlatformDisplay); \ EGL_IMPORT_FUNC(PFNEGLGETDISPLAYPROC, eglGetDisplay); \ EGL_IMPORT_FUNC(PFNEGLGETERRORPROC, eglGetError); \ EGL_IMPORT_FUNC(PFNEGLGETPROCADDRESSPROC, eglGetProcAddress); \ EGL_IMPORT_FUNC(PFNEGLINITIALIZEPROC, eglInitialize); \ EGL_IMPORT_FUNC(PFNEGLMAKECURRENTPROC, eglMakeCurrent); \ EGL_IMPORT_FUNC(PFNEGLQUERYCONTEXTPROC, eglQueryContext); \ EGL_IMPORT_FUNC(PFNEGLRELEASETHREADPROC, eglReleaseThread); \ EGL_IMPORT_FUNC(PFNEGLSWAPBUFFERSPROC, eglSwapBuffers); \ EGL_IMPORT_FUNC(PFNEGLSWAPINTERVALPROC, eglSwapInterval); \ EGL_IMPORT_FUNC(PFNEGLTERMINATEPROC, eglTerminate); \ EGL_IMPORT_FUNC(PFNEGLQUERYSTRINGPROC, eglQueryString); \ EGL_IMPORT_FUNC(PFNEGLGETCONFIGSPROC, eglGetConfigs); \ EGL_IMPORT_FUNC(PFNEGLGETCONFIGATTRIBPROC, eglGetConfigAttrib); \ #define EGL_IMPORT_FUNC(_proto, _func) _proto _func EGL_IMPORT #undef EGL_IMPORT_FUNC void* eglOpen() { void* handle = bx::dlopen( #if BX_PLATFORM_LINUX "libEGL.so.1" #else "libEGL." BX_DL_EXT #endif // BX_PLATFORM_* ); BGFX_FATAL(NULL != handle, Fatal::UnableToInitialize, "Failed to load libEGL dynamic library."); #define EGL_IMPORT_FUNC(_proto, _func) \ _func = (_proto)bx::dlsym(handle, #_func); \ BX_TRACE("%p " #_func, _func); \ BGFX_FATAL(NULL != _func, Fatal::UnableToInitialize, "Failed get " #_func ".") EGL_IMPORT #undef EGL_IMPORT_FUNC return handle; } void eglClose(void* _handle) { bx::dlclose(_handle); #define EGL_IMPORT_FUNC(_proto, _func) _func = NULL EGL_IMPORT #undef EGL_IMPORT_FUNC } #else void* eglOpen() { return NULL; } void eglClose(void* /*_handle*/) { } #endif // BGFX_USE_GL_DYNAMIC_LIB #if BX_PLATFORM_LINUX # define WL_EGL_IMPORT \ WL_EGL_FUNC(struct wl_egl_window *, wl_egl_window_create, (struct wl_surface *, int, int) ) \ WL_EGL_FUNC(void, wl_egl_window_destroy, (struct wl_egl_window *)) \ WL_EGL_FUNC(void, wl_egl_window_resize, (struct wl_egl_window *, int, int, int, int)) \ WL_EGL_FUNC(void, wl_egl_window_get_attached_size, (struct wl_egl_window *, int *, int *) ) \ # define WL_EGL_FUNC(rt, fname, params) \ typedef rt(*PFNWLEGL_##fname) params; \ PFNWLEGL_##fname fname; WL_EGL_IMPORT # undef WL_EGL_FUNC void* waylandEglOpen() { void* handle = bx::dlopen("libwayland-egl.so.1"); BGFX_FATAL(handle != NULL, Fatal::UnableToInitialize, "Could not dlopen() libwayland-egl.so.1"); # define WL_EGL_FUNC(rt, fname, params) fname = (PFNWLEGL_##fname) bx::dlsym(handle, #fname); WL_EGL_IMPORT # undef WL_EGL_FUNC return handle; } void waylandEglClose(void* _handle) { bx::dlclose(_handle); # define WL_EGL_FUNC(rt, fname, params) fname = NULL; WL_EGL_IMPORT # undef WL_EGL_FUNC } #endif // BX_PLATFORM_LINUX # define GL_IMPORT(_optional, _proto, _func, _import) _proto _func = NULL # include "glimports.h" static EGLint s_contextAttrs[16]; struct SwapChainGL { SwapChainGL(EGLDisplay _display, EGLConfig _config, EGLContext _context, EGLNativeWindowType _nwh, int32_t _width, int32_t _height) : m_nwh(_nwh) , m_display(_display) # if BX_PLATFORM_LINUX , m_eglWindow(NULL) # endif { EGLSurface defaultDrawSurface = eglGetCurrentSurface(EGL_DRAW); EGLSurface defaultReadSurface = eglGetCurrentSurface(EGL_READ); BX_UNUSED(_width, _height); if (EGLNativeWindowType(0) == _nwh) { m_surface = eglCreatePbufferSurface(m_display, _config, NULL); } else { # if BX_PLATFORM_LINUX if (g_platformData.type == NativeWindowHandleType::Wayland) { // A wl_surface needs to be first wrapped in a wl_egl_window // before it can be used to create the EGLSurface. m_eglWindow = wl_egl_window_create( (wl_surface*)_nwh, _width, _height); _nwh = (EGLNativeWindowType) m_eglWindow; } # endif m_surface = eglCreateWindowSurface(m_display, _config, _nwh, NULL); } BGFX_FATAL(m_surface != EGL_NO_SURFACE, Fatal::UnableToInitialize, "Failed to create surface."); m_context = eglCreateContext(m_display, _config, _context, s_contextAttrs); BX_ASSERT(NULL != m_context, "Create swap chain failed: %x", eglGetError() ); makeCurrent(); GL_CHECK(glClearColor(0.0f, 0.0f, 0.0f, 0.0f) ); GL_CHECK(glClear(GL_COLOR_BUFFER_BIT) ); swapBuffers(); GL_CHECK(glClear(GL_COLOR_BUFFER_BIT) ); swapBuffers(); EGL_CHECK(eglMakeCurrent(m_display, defaultDrawSurface, defaultReadSurface, _context) ); } ~SwapChainGL() { EGLSurface defaultDrawSurface = eglGetCurrentSurface(EGL_DRAW); EGLSurface defaultReadSurface = eglGetCurrentSurface(EGL_READ); EGLContext defaultContext = eglGetCurrentContext(); EGL_CHECK(eglMakeCurrent(m_display, EGL_NO_SURFACE, EGL_NO_SURFACE, EGL_NO_CONTEXT) ); EGL_CHECK(eglDestroyContext(m_display, m_context) ); EGL_CHECK(eglDestroySurface(m_display, m_surface) ); # if BX_PLATFORM_LINUX if (m_eglWindow) { wl_egl_window_destroy(m_eglWindow); } # endif EGL_CHECK(eglMakeCurrent(m_display, defaultDrawSurface, defaultReadSurface, defaultContext) ); } void makeCurrent() { EGL_CHECK(eglMakeCurrent(m_display, m_surface, m_surface, m_context) ); } void swapBuffers() { EGL_CHECK(eglSwapBuffers(m_display, m_surface) ); } EGLNativeWindowType m_nwh; EGLContext m_context; EGLDisplay m_display; EGLSurface m_surface; # if BX_PLATFORM_LINUX wl_egl_window *m_eglWindow; # endif }; # if BX_PLATFORM_RPI typedef uint32_t DISPMANX_ELEMENT_HANDLE_T; typedef struct { DISPMANX_ELEMENT_HANDLE_T element; int width; /* This is necessary because dispmanx elements are not queriable. */ int height; } EGL_DISPMANX_WINDOW_T; static EGL_DISPMANX_WINDOW_T s_dispmanWindow; # endif // BX_PLATFORM_RPI void GlContext::create(const SwapChain& _swapChain, uint32_t _reset) { m_nwh = _swapChain.nwh; # if BX_PLATFORM_RPI bcm_host_init(); # endif // BX_PLATFORM_RPI m_eglDll = eglOpen(); m_ownsContext = NULL == g_platformData.context; if (m_ownsContext) { void* ndtRaw = _swapChain.ndt; # if BX_PLATFORM_RPI ndtRaw = EGL_DEFAULT_DISPLAY; # endif // BX_PLATFORM_RPI EGLNativeDisplayType ndt = (EGLNativeDisplayType)ndtRaw; EGLNativeWindowType nwh = (EGLNativeWindowType )m_nwh; # if BX_PLATFORM_WINDOWS if (NULL == ndtRaw && NULL != nwh) { m_hdc = GetDC( (HWND)nwh); ndt = m_hdc; } # endif // BX_PLATFORM_WINDOWS m_display = eglGetDisplay(NULL == ndt ? EGL_DEFAULT_DISPLAY : ndt); BGFX_FATAL(m_display != EGL_NO_DISPLAY, Fatal::UnableToInitialize, "Failed to create display %p", m_display); EGLint major = 0; EGLint minor = 0; EGLBoolean success = eglInitialize(m_display, &major, &minor); BGFX_FATAL(success && major >= 1 && minor >= 3, Fatal::UnableToInitialize, "Failed to initialize %d.%d", major, minor); BX_TRACE("EGL info:"); const char* clientApis = eglQueryString(m_display, EGL_CLIENT_APIS); BX_TRACE(" APIs: %s", clientApis); BX_UNUSED(clientApis); const char* vendor = eglQueryString(m_display, EGL_VENDOR); BX_TRACE(" Vendor: %s", vendor); BX_UNUSED(vendor); const char* version = eglQueryString(m_display, EGL_VERSION); BX_TRACE("Version: %s", version); BX_UNUSED(version); const char* extensions = eglQueryString(m_display, EGL_EXTENSIONS); BX_TRACE("Supported EGL extensions:"); dumpExtensions(extensions); if (BX_ENABLED(BGFX_CONFIG_RENDERER_OPENGL) ) { EGLBoolean ok = eglBindAPI(EGL_OPENGL_API); BGFX_FATAL(ok, Fatal::UnableToInitialize, "Could not set API! error: %d", eglGetError()); } const bool isAngle = !bx::findIdentifierMatch(version, "ANGLE").isEmpty(); const bool hasEglAndroidRecordable = true && !isAngle // Extension reports it exist with ANGLE, but initialization with it fails. && !bx::findIdentifierMatch(extensions, "EGL_ANDROID_recordable").isEmpty() ; const uint32_t glVersion = !!BGFX_CONFIG_RENDERER_OPENGL ? BGFX_CONFIG_RENDERER_OPENGL : BGFX_CONFIG_RENDERER_OPENGLES ; const uint32_t msaa = (_swapChain.flags & BGFX_SWAP_CHAIN_MSAA_MASK)>>BGFX_SWAP_CHAIN_MSAA_SHIFT; uint32_t msaaSamples = 0 == msaa ? 0 : 1<swapBuffers(); } } void GlContext::makeCurrent(SwapChainGL* _swapChain) { if (m_current != _swapChain) { m_current = _swapChain; if (NULL == _swapChain) { if (NULL != m_display) { EGL_CHECK(eglMakeCurrent(m_display, m_surface, m_readSurface, m_context) ); } } else { _swapChain->makeCurrent(); } // eglSwapInterval is per-surface, so re-apply the cached interval every time a // different surface becomes current. Without this, secondary swap chains keep // their driver default (typically vsync ON) even after resize(). // eglSwapInterval raises EGL_BAD_SURFACE when no surface is bound. if (NULL != m_display && (NULL != _swapChain || EGL_NO_SURFACE != m_surface) ) { EGL_CHECK(eglSwapInterval(m_display, m_swapInterval) ); } } } void GlContext::import() { BX_TRACE("Import:"); # if BX_PLATFORM_WINDOWS || BX_PLATFORM_LINUX # if BX_PLATFORM_WINDOWS # if BGFX_CONFIG_RENDERER_OPENGL # define LIBRARY_NAME "libGL.dll" # else # define LIBRARY_NAME "libGLESv2.dll" # endif // BGFX_CONFIG_RENDERER_OPENGL # elif BX_PLATFORM_LINUX # if BGFX_CONFIG_RENDERER_OPENGL # define LIBRARY_NAME "libGL.so.1" # else # define LIBRARY_NAME "libGLESv2.so.2" # endif // BGFX_CONFIG_RENDERER_OPENGL # endif void* lib = bx::dlopen(LIBRARY_NAME); # define GL_EXTENSION(_optional, _proto, _func, _import) \ { \ if (NULL == _func) \ { \ _func = bx::dlsym<_proto>(lib, #_import); \ BX_TRACE("\t%p " #_func " (" #_import ")", _func); \ BGFX_FATAL(_optional || NULL != _func \ , Fatal::UnableToInitialize \ , "Failed to create OpenGLES context. eglGetProcAddress(\"%s\")" \ , #_import); \ } \ } # else # define GL_EXTENSION(_optional, _proto, _func, _import) \ { \ if (NULL == _func) \ { \ _func = reinterpret_cast<_proto>(eglGetProcAddress(#_import) ); \ BX_TRACE("\t%p " #_func " (" #_import ")", _func); \ BGFX_FATAL(_optional || NULL != _func \ , Fatal::UnableToInitialize \ , "Failed to create OpenGLES context. eglGetProcAddress(\"%s\")" \ , #_import); \ } \ } # endif // BX_PLATFORM_ # include "glimports.h" # undef GL_EXTENSION } } /* namespace gl */ } // namespace bgfx # endif // BGFX_USE_EGL #endif // (BGFX_CONFIG_RENDERER_OPENGLES || BGFX_CONFIG_RENDERER_OPENGL)