Skip to content
  • Chun-wei Fan's avatar
    Add a EGL renderer (via ANGLE) for Windows · af66faf6
    Chun-wei Fan authored
    This is for adding a EGL-based renderer which is done via the ANGLE
    project, which translate EGL calls to Direct3D 9/11.  This is done as a
    possible solution to issue #105, especially for cases where the needed
    full GL extensions to map OpenGL to Direc3D is unavailable or
    unreliable, or when the OpenGL implementation from the graphics drivers
    are problematic.
    
    To enable this, do the following:
    -Build ANGLE and ensure the ANGLE libEGL.dll and libGLESv2.dll are
     available.  A sufficiently-recent ANGLE is needed for things to
     work correctly--note that the copy of ANGLE that is included in
     qtbase-5.10.1 is sufficient.  ANGLE is licensed under a BSD 3-clause
     license.  Note also that Visual Studio 2013 or later is required to
     build ANGLE from QT-5.10.1, but the 2013-built ANGLE DLLs can work
     without without problems for GTK+ that is built with Visual Studio
     2008 or later.
    -Build libepoxy on Windows with EGL support enabled.
    -Define GDK_WIN32_ENABLE_EGL when building gdk-win32.lib when building
     with Visual Studio, or pass in --enable-win32-gles during configure
     when building with MinGW/mingw-w64.
    -Prior to running GTK+ programs, the GDK_GL envvar needs to contain
     gles.
    
    Known issues:
    -Only OpenGL ES 3 is supported, ANGLE's ES 2 does not support the needed
     extensions, notably GL_OES_vertex_array_object, but its ES 3 support is
     sufficient.
    -There is no autodetection or fallback mechanism to enable using
     EGL/Angle automatically yet.  There is no plans to do this in this
     commit.
    
    Thanks to LRN for pointing out that we should #include
    "win32/gdkwin32.h" instead of #include "gdkwin32.h" for gdkgl.c.  LRN
    also did the autotools portion of this patch.
    
    Further notes about the autotools --enable-win32-gles option, fom LRN:
    
    This adds --enable-win32-gles option, which enables the
    code for GLES renderer.  This commit also adds tests for WGL and
    EGL in epoxy.  The absence of WGL is highly unlikely (it's enabled
    by default), but checking for EGL when GLES is enabled is necessary,
    as EGL is disabled in Windows builds of epoxy by default.
    af66faf6