Replace desktop backend with SDL3 GL and ANGLE-GLES (#2585)

* Fix issues in GLES backends

* rewrite lwjgl3 backend to use SDL

* remove debug libraries

* support msaa framebuffer extension in gles

* use auxiliary framebuffer for srgb conversion

* deprecate old opengl versions

* update deps

* use lib catalog for angle native

* fix

* remove debug override

* update libs

* add task to run tests in proton

* increase memory

* Implement GPU timer query support across multiple platforms and handle unsupported cases

* Revert "Implement GPU timer query support across multiple platforms and handle unsupported cases"

This reverts commit 36dbf9f.

* add packed float toggler to getBestColorTargetFormat and disallow packed floats in env backer

* fix wayland selection

* Reapply "Implement GPU timer query support across multiple platforms and handle unsupported cases"

This reverts commit feaf8ea.

* Revert "Reapply "Implement GPU timer query support across multiple platforms and handle unsupported cases""

This reverts commit 4bf14ab.

* fix gpu timer support

* fixes

* use Blit.j3md for gamma correction

* Revert "fixes"

This reverts commit 79734e7.

* Reapply "fixes"

This reverts commit f0a76dc740a9cd370cf76891d5edc8f8f2e103b6.

* add explicit GLSL310 support for Blit material

* force GL 3.2 in screenshot tests

* add renderer selector to settings dialog

* catch swapwindow failures

* reset hint on renderer change, fix sRGB for non angle renderer

* set __GL_THREADED_OPTIMIZATIONS=0 on start to workaround known nvidia bug that causes lwjgl apps to break

* bypass aux framebuffer if native gl

* use isGraphicsDebug

* use 24 bit buffer in Xvfb

* Fix examples launcher and disable AWT dialogs in macos

* use angle in tests with vulkan software rendering

* make all extensions optional

* update libs

* fix angle version

* Revert "make all extensions optional"

This reverts commit 748e584.

* Reapply "make all extensions optional"

This reverts commit 275cfd4.

* Revert "use angle in tests with vulkan software rendering"

This reverts commit a288755.

* fallback to aux framebuffer if srgb framebuffer is not available

* revert change to Xvfb color depth

* Revert "Reapply "make all extensions optional""

This reverts commit 8285cf7.

* restore main framebuffer override when it changes inside the app update loop

* revert unrelated changes to tests

Author: riccardobl

.gitignore

@@ -45,4 +45,4 @@ javadoc_deploy.pub
 !.vscode/settings.json
 !.vscode/JME_style.xml
 !.vscode/extensions.json
-joysticks-*.txt
+joysticks-*.txt

.vscode/settings.json

@@ -5,5 +5,5 @@
     "editor.formatOnPaste": false,
     "editor.formatOnType": false,
     "editor.formatOnSave": false,
-    "java.jdt.ls.vmargs": "-Xms512M -Xmx2G -XX:+UseG1GC -XX:+UseStringDeduplication -XX:AdaptiveSizePolicyWeight=90"
+    "java.jdt.ls.vmargs": "-Xms512M -Xmx4G -XX:+UseG1GC -XX:+UseStringDeduplication -XX:AdaptiveSizePolicyWeight=90"
 }

gradle/libs.versions.toml

@@ -5,6 +5,8 @@
 checkstyle = "13.3.0"
 jacoco = "0.8.12"
 lwjgl3 = "3.4.1"
+angle = "2026-05-09"
+saferalloc = "0.0.8"
 nifty = "1.4.3"
 spotbugs = "4.9.8"
 
@@ -35,9 +37,10 @@ lwjgl3-glfw     = { module = "org.lwjgl:lwjgl-glfw",     version.ref = "lwjgl3"
 lwjgl3-jawt     = { module = "org.lwjgl:lwjgl-jawt",     version.ref = "lwjgl3" }
 lwjgl3-jemalloc = { module = "org.lwjgl:lwjgl-jemalloc", version.ref = "lwjgl3" }
 lwjgl3-openal   = { module = "org.lwjgl:lwjgl-openal",   version.ref = "lwjgl3" }
-lwjgl3-opencl   = { module = "org.lwjgl:lwjgl-opencl",   version.ref = "lwjgl3" }
 lwjgl3-opengl   = { module = "org.lwjgl:lwjgl-opengl",   version.ref = "lwjgl3" }
 lwjgl3-sdl      = { module = "org.lwjgl:lwjgl-sdl",      version.ref = "lwjgl3" }
+lwjgl3-opengles = { module = "org.lwjgl:lwjgl-opengles", version.ref = "lwjgl3" }
+lwjgl3-egl   = { module = "org.lwjgl:lwjgl-egl", version.ref = "lwjgl3" }
 
 mokito-core = "org.mockito:mockito-core:5.23.0"
 mokito-junit-jupiter = "org.mockito:mockito-junit-jupiter:5.23.0"
@@ -52,8 +55,18 @@ vecmath = "javax.vecmath:vecmath:1.5.2"
 
 stb-image = "org.ngengine:stb-image:2.30.4"
 imagewebp = "org.ngengine:image-webp-decoder:1.3.0"
+angle = { module = "org.ngengine:angle-natives", version.ref = "angle" }
+saferalloc = { module = "org.ngengine:saferalloc", version.ref = "saferalloc" }
+saferalloc-natives-linux-x8664 = { module = "org.ngengine:saferalloc-natives-linux-x86_64", version.ref = "saferalloc" }
+saferalloc-natives-linux-aarch64 = { module = "org.ngengine:saferalloc-natives-linux-aarch64", version.ref = "saferalloc" }
+saferalloc-natives-windows-x8664 = { module = "org.ngengine:saferalloc-natives-windows-x86_64", version.ref = "saferalloc" }
+saferalloc-natives-windows-aarch64 = { module = "org.ngengine:saferalloc-natives-windows-aarch64", version.ref = "saferalloc" }
+saferalloc-natives-macos-x8664 = { module = "org.ngengine:saferalloc-natives-macos-x86_64", version.ref = "saferalloc" }
+saferalloc-natives-macos-aarch64 = { module = "org.ngengine:saferalloc-natives-macos-aarch64", version.ref = "saferalloc" }
+saferalloc-natives-android = { module = "org.ngengine:saferalloc-natives-android", version.ref = "saferalloc" }
 
 [bundles]
+saferalloc = ["saferalloc", "saferalloc-natives-linux-x8664", "saferalloc-natives-linux-aarch64", "saferalloc-natives-windows-x8664", "saferalloc-natives-windows-aarch64", "saferalloc-natives-macos-x8664", "saferalloc-natives-macos-aarch64", "saferalloc-natives-android"]
 
 [plugins]
 jacoco = { id = "jacoco", version.ref = "jacoco" }

jme3-android/src/main/java/com/jme3/renderer/android/AndroidGL.java

@@ -51,6 +51,11 @@ public class AndroidGL implements GL, GL2, GLES_30, GLExt, GLFbo {
     public void resetStats() {
     }
 
+    @Override
+    public boolean supportsGpuTimerQuery() {
+        return false;
+    }
+
     private static int getLimitBytes(ByteBuffer buffer) {
         checkLimit(buffer);
         return buffer.limit();
@@ -100,6 +105,9 @@ public void glAttachShader(int program, int shader) {
 
     @Override
     public void glBeginQuery(int target, int query) {
+        if (target == GL.GL_TIME_ELAPSED) {
+            throw new UnsupportedOperationException("64-bit GPU timer queries are not exposed by the Android GLES bindings");
+        }
         GLES30.glBeginQuery(target, query);
     }
 
@@ -287,6 +295,9 @@ public void glEnableVertexAttribArray(int index) {
 
     @Override
     public void glEndQuery(int target) {
+        if (target == GL.GL_TIME_ELAPSED) {
+            throw new UnsupportedOperationException("64-bit GPU timer queries are not exposed by the Android GLES bindings");
+        }
         GLES30.glEndQuery(target);
     }
 
@@ -348,16 +359,13 @@ public String glGetProgramInfoLog(int program, int maxLength) {
 
     @Override
     public long glGetQueryObjectui64(int query, int pname) {
-        IntBuffer buff = IntBuffer.allocate(1);
-        //FIXME This is wrong IMO should be glGetQueryObjectui64v with a LongBuffer but it seems the API doesn't provide it.
-        GLES30.glGetQueryObjectuiv(query, pname, buff);
-        return buff.get(0);
+        throw new UnsupportedOperationException("64-bit query results are not exposed by the Android GLES bindings");
     }
 
     @Override
     public int glGetQueryObjectiv(int query, int pname) {
-        IntBuffer buff = IntBuffer.allocate(1);
-        GLES30.glGetQueryiv(query, pname, buff);
+        IntBuffer buff = (IntBuffer)tmpBuff.clear();
+        GLES30.glGetQueryObjectuiv(query, pname, buff);
         return buff.get(0);
     }
 
@@ -786,4 +794,9 @@ public void glGenVertexArrays(IntBuffer arrays) {
 
     }
 
+    @Override
+    public String glGetString(int name, int index) {
+        return GLES30.glGetStringi(name, index);
+    }
+
 }

jme3-android/src/main/java/com/jme3/system/android/OGLESContext.java

@@ -669,21 +669,37 @@ private boolean renderFrameWithBlitSrgbConversion() {
             return false;
         }
 
+        FrameBuffer previousMainFramebuffer = renderer.getCurrentFrameBuffer();
+        if (previousMainFramebuffer != null) {
+            return false;
+        }
+
         rebuildLinearFrameBufferIfNeeded();
         if (linearFrameBuffer == null || !ensureBlitResources()) {
             return false;
         }
 
+        FrameBuffer restoreMainFramebuffer = previousMainFramebuffer;
+
         renderer.setMainFrameBufferOverride(linearFrameBuffer);
         try {
             listener.update();
+            FrameBuffer currentMainFramebuffer = renderer.getCurrentFrameBuffer();
+            if (currentMainFramebuffer != linearFrameBuffer) {
+                restoreMainFramebuffer = currentMainFramebuffer;
+            }
         } finally {
-            renderer.setMainFrameBufferOverride(null);
+            renderer.setMainFrameBufferOverride(restoreMainFramebuffer);
         }
 
-        renderer.setFrameBuffer(null);
-        blitGeometry.updateGeometricState();
-        application.getRenderManager().renderGeometry(blitGeometry);
+        renderer.setMainFrameBufferOverride(null);
+        try {
+            renderer.setFrameBuffer(null);
+            blitGeometry.updateGeometricState();
+            application.getRenderManager().renderGeometry(blitGeometry);
+        } finally {
+            renderer.setMainFrameBufferOverride(restoreMainFramebuffer);
+        }
         return true;
     }
 

jme3-awt-dialogs/src/main/java/com/jme3/awt/AWTSettingsDialog.java

@@ -129,6 +129,7 @@ public interface SelectionListener {
     private JComboBox<String> colorDepthCombo = null;
     private JComboBox<String> displayFreqCombo = null;
     private JComboBox<String> antialiasCombo = null;
+    private JComboBox<String> rendererCombo = null;
     private JLabel icon = null;
     private int selection = 0;
     private SelectionListener selectionListener = null;
@@ -463,6 +464,8 @@ public void keyPressed(KeyEvent e) {
         displayFreqCombo.addKeyListener(aListener);
         antialiasCombo = new JComboBox<>();
         antialiasCombo.addKeyListener(aListener);
+        rendererCombo = setUpRendererChooser();
+        rendererCombo.addKeyListener(aListener);
         fullscreenBox = new JCheckBox(resourceBundle.getString("checkbox.fullscreen"));
         fullscreenBox.setSelected(source.isFullscreen());
         fullscreenBox.addActionListener(new ActionListener() {
@@ -549,6 +552,20 @@ public void actionPerformed(ActionEvent e) {
         gbc.anchor = GridBagConstraints.WEST;
         mainPanel.add(antialiasCombo, gbc);
 
+        gbc = new GridBagConstraints();
+        gbc.insets = new Insets(4, 4, 4, 4);
+        gbc.gridx = 0;
+        gbc.gridy = 4;
+        gbc.anchor = GridBagConstraints.EAST;
+        gbc.weightx = 0.5;
+        mainPanel.add(new JLabel(resourceBundle.getString("label.renderer")), gbc);
+        gbc = new GridBagConstraints();
+        gbc.gridx = 1;
+        gbc.gridy = 4;
+        gbc.gridwidth = 3;
+        gbc.anchor = GridBagConstraints.WEST;
+        mainPanel.add(rendererCombo, gbc);
+
         // Set the button action listeners. Cancel disposes without saving, OK
         // saves.
         ok.addActionListener(new ActionListener() {
@@ -583,14 +600,14 @@ public void actionPerformed(ActionEvent e) {
         gbc = new GridBagConstraints();
         gbc.gridx = 0;
         gbc.gridwidth = 2;
-        gbc.gridy = 4;
+        gbc.gridy = 5;
         gbc.anchor = GridBagConstraints.EAST;
         mainPanel.add(ok, gbc);
         gbc = new GridBagConstraints();
         gbc.insets = new Insets(4, 16, 4, 4);
         gbc.gridx = 2;
         gbc.gridwidth = 2;
-        gbc.gridy = 4;
+        gbc.gridy = 5;
         gbc.anchor = GridBagConstraints.WEST;
         mainPanel.add(cancel, gbc);
 
@@ -662,6 +679,7 @@ private boolean verifyAndSaveCurrentSelection() {
         boolean fullscreen = fullscreenBox.isSelected();
         boolean vsync = vsyncBox.isSelected();
         boolean gamma = gammaBox.isSelected();
+        String renderer = (String) rendererCombo.getSelectedItem();
 
         String[] parts = display.split(" x ");
         int width = Integer.parseInt(parts[0]);
@@ -721,7 +739,7 @@ private boolean verifyAndSaveCurrentSelection() {
             source.setFullscreen(fullscreen);
             source.setVSync(vsync);
             source.setGammaCorrection(gamma);
-            // source.setRenderer(renderer);
+            source.setRenderer(renderer);
             source.setSamples(multisample);
 
             String appTitle = source.getTitle();
@@ -762,6 +780,30 @@ public void actionPerformed(ActionEvent e) {
         return resolutionBox;
     }
 
+    private JComboBox<String> setUpRendererChooser() {
+        JComboBox<String> rendererBox = new JComboBox<>();
+        Set<String> renderers = new LinkedHashSet<>(Arrays.asList(
+                AppSettings.ANGLE_GLES3,
+                AppSettings.LWJGL_OPENGL32,
+                AppSettings.LWJGL_OPENGL33,
+                AppSettings.LWJGL_OPENGL40,
+                AppSettings.LWJGL_OPENGL41,
+                AppSettings.LWJGL_OPENGL42,
+                AppSettings.LWJGL_OPENGL43,
+                AppSettings.LWJGL_OPENGL44,
+                AppSettings.LWJGL_OPENGL45
+        ));
+        String currentRenderer = source.getRenderer();
+        if (currentRenderer != null) {
+            renderers.add(currentRenderer);
+        }
+        for (String renderer : renderers) {
+            rendererBox.addItem(renderer);
+        }
+        rendererBox.setSelectedItem(currentRenderer);
+        return rendererBox;
+    }
+
     /**
      * <code>updateDisplayChoices</code> updates the available color depth and
      * display frequency options to match the currently selected resolution.

jme3-awt-dialogs/src/main/java/com/jme3/system/JmeDialogsFactoryImpl.java

@@ -32,16 +32,26 @@
 
 package com.jme3.system;
 
+import java.util.logging.Logger;
+
 import com.jme3.awt.AWTErrorDialog;
 import com.jme3.awt.AWTSettingsDialog;
 
 public class JmeDialogsFactoryImpl implements JmeDialogsFactory {
-    
+    private final static Logger logger = Logger.getLogger(JmeDialogsFactoryImpl.class.getName());
     public boolean showSettingsDialog(AppSettings settings, boolean loadFromRegistry){
+        if(JmeSystem.getPlatform()==Platform.MacOSX64||JmeSystem.getPlatform()==Platform.MacOSX_ARM64){
+            logger.warning("AWT settings dialog skipped in MacOS");
+            return true;
+        }
         return AWTSettingsDialog.showDialog(settings,loadFromRegistry);
     }
 
     public void showErrorDialog(String message){
+        if(JmeSystem.getPlatform()==Platform.MacOSX64||JmeSystem.getPlatform()==Platform.MacOSX_ARM64){
+            logger.warning("AWT error dialog skipped in MacOS");
+            return;
+        }
         AWTErrorDialog.showDialog(message);
     }
 

jme3-core/src/main/java/com/jme3/app/DetailedProfiler.java

@@ -32,6 +32,7 @@
 package com.jme3.app;
 
 import com.jme3.profile.*;
+import com.jme3.renderer.Caps;
 import com.jme3.renderer.Renderer;
 import com.jme3.renderer.ViewPort;
 import com.jme3.renderer.queue.RenderQueue;
@@ -86,14 +87,16 @@ public void appStep(AppStep step) {
             frameTime.setNewFrameValueCpu(System.nanoTime());
 
             frameEnded = false;
-            for (StatLine statLine : data.values()) {
-                for (Iterator<Integer> i = statLine.taskIds.iterator(); i.hasNext(); ) {
-                    int id = i.next();
-                    if (renderer.isTaskResultAvailable(id)) {
-                        long val = renderer.getProfilingTime(id);
-                        statLine.setValueGpu(val);
-                        i.remove();
-                        idsPool.push(id);
+            if (renderer != null) {
+                for (StatLine statLine : data.values()) {
+                    for (Iterator<Integer> i = statLine.taskIds.iterator(); i.hasNext(); ) {
+                        int id = i.next();
+                        if (renderer.isTaskResultAvailable(id)) {
+                            long val = renderer.getProfilingTime(id);
+                            statLine.setValueGpu(val);
+                            i.remove();
+                            idsPool.push(id);
+                        }
                     }
                 }
             }
@@ -222,8 +225,8 @@ private void addStep(String path, long value) {
             int id = getUnusedTaskId();
             line.taskIds.add(id);
             renderer.startProfiling(id);
+            ongoingGpuProfiling = true;
         }
-        ongoingGpuProfiling = true;
         prevPath = path;
 
     }
@@ -239,8 +242,13 @@ private String getPath(String step, String... subPath) {
     }
 
     public void setRenderer(Renderer renderer) {
-        this.renderer = renderer;
-        poolTaskIds(renderer);
+        idsPool.clear();
+        if (renderer != null && renderer.getCaps().contains(Caps.GpuTimerQuery)) {
+            this.renderer = renderer;
+            poolTaskIds(renderer);
+        } else {
+            this.renderer = null;
+        }
     }
 
     private void poolTaskIds(Renderer renderer) {

jme3-core/src/main/java/com/jme3/renderer/Caps.java

@@ -467,6 +467,12 @@ public enum Caps {
      * GPU support for binary shaders.
      */
     BinaryShader,
+
+    /**
+     * Supports GPU timer queries with full 64-bit elapsed-time results.
+     */
+    GpuTimerQuery,
+
     /**
      * Supporting working with UniformBufferObject.
      */

jme3-core/src/main/java/com/jme3/renderer/opengl/GL.java

@@ -890,6 +890,16 @@ public void glCompressedTexSubImage2D(int target, int level, int xoffset, int yo
      */
     public String glGetProgramInfoLog(int program, int maxSize);
 
+    /**
+     * Returns whether this GL binding can execute elapsed-time timer queries
+     * and read their full 64-bit results.
+     *
+     * @return true if full GPU timer query support is exposed by the binding
+     */
+    public default boolean supportsGpuTimerQuery() {
+        return true;
+    }
+
     /**
      * Unsigned version.
      *