OpenGLES 3.1 by danoli3 · Pull Request #8533 · openframeworks/openFrameworks

danoli3 · 2026-08-11T04:21:30Z

OpenGLES 3.1

Updated PR to #8512
Merged in @mruegenberg changes and patched them into the core.
Support for openGLES 3.0
Support for openGLES 3.1
Fixed up Emscripten defines to allow for ES3
This feature allows for emulation more easily in Dawn / Emscripten / Metal / Vulkan for Mobile platforms for ES
Merged with Tess2 fixes. Auto Short / Int determination (less defines)

TODO:

danoli3 · 2026-08-13T18:26:51Z

Smoke tests on GL failing will investigate

danoli3 · 2026-09-12T04:52:19Z

This is almost complete just to do physical device tests

TODO: iOS

# Conflicts: # libs/openFrameworks/gl/ofGLProgrammableRenderer.cpp

The shared test always called drawInstanced, which is not in ES1/ES2 or GL 2.1, and the programmable GLES path never instanced even on ES3 (gated on 3.1, and ofVboMesh ignored primCount). Skip instancing unless the live context is GL 3.1+ / ES 3.0+, match VBO index type to ofIndexType on GLES, report WebGL2 as GLES 3, and give the Android lifecycle test ES2 shaders / an ES1 no-shader path.

- ofGraphics/ofGLRenderer: revert background-gradient relocation that used ofVboMesh without its header and dropped the renderer's drawBackgroundGradient definition (broke every build + link) - ofGraphics: revert illegal static_cast to ofBaseGLRenderer in ofEnable/DisablePointSprites, virtual dispatch already covers it - ofAppEGLWindow: rename glesVersion member to glesVersionMajor to match ofAppEGLWindow.cpp usage - ofAppAndroidWindow: drop dead overwrite of glesVersion from legacy field so settings getters take effect, init glesVersionMinor - ofxEmscriptenURLFileLoader: restore lowercase __EMSCRIPTEN_major__/ __EMSCRIPTEN_minor__ macros (uppercase form is never defined) - ofTexture: restore GL_TEXTURE_CUBE_MAP mipmap case on desktop, align bindAsImage cpp guard with header - ofConstants: make GLES3 includes live (unconditional on Linux ARM and Emscripten, API-gated on Android) so TARGET_OPENGLES_3 auto-detection actually works

- ofFbo::readToPixels: GLES has no glGetTexImage (ES 1/2/3), so the ES 3 branch returned empty pixels; read the bound FBO with glReadPixels on all GLES again, selecting the attachment with glReadBuffer on ES 3 contexts. - ofGLProgrammableRenderer::draw(ofMesh) on ES: line modes use the lines shader, which needs the line bundle; raw client arrays made GL_LINE_STRIP / GL_LINE_LOOP (circle and polyline outlines) collapse to nothing. Build the bundle like desktop (ofSetLineWidth works on ES again). - ofFbo::allocate(w, h, format): keep colour-only on ES; the combined depth+stencil renderbuffer was FRAMEBUFFER_INCOMPLETE_ATTACHMENT. - TARGET_OPENGLES_3 only means the ES 3 headers exist, which is true on iOS even for ES 1 / ES 2 contexts. Add ofIsGLES3Context() (headers + live context >= 3) and use it for sized RGBA8 / RGB8 internal formats (ES 2 rejects them with GL_INVALID_OPERATION); ofFbo::checkGLSupport accepts GL_OES_framebuffer_object for ES 1.1 contexts.

danoli3 · 2026-10-06T09:55:58Z

Rebased on master + GLES fixes + GL / GLES test matrix

Rebased onto current master (46 commits, no conflicts; emsdk stays 6.0.11). The previous msys2 failures were the CI mirror/fail-fast issue fixed on master (#8566 / #8568), not this PR.

New commit b226140 — fixes for regressions found while testing ES 1.1 / 2.0 / 3.0 on the iOS Simulator (before it, every iOS ES version failed and unfilled circles/polylines were invisible on ES):

#	Problem	Fix
1	`ofFbo::readToPixels` returned no pixels on ES 3: it called `ofTexture::readToPixels`, which is compiled out on GLES (no `glGetTexImage` in any ES)	`glReadPixels` on all GLES again (as on master), with `glReadBuffer` for the attachment on ES 3 contexts
2	Circle / polyline outlines missing on ES: line modes use the lines shader, but the new ES client-array path never built the line bundle, so `GL_LINE_STRIP` / `GL_LINE_LOOP` collapsed to nothing	ES line modes build the bundle like desktop (also brings back `ofSetLineWidth` on ES)
3	`ofFbo::allocate(w, h, fmt)` defaulted to depth+stencil on ES → `FRAMEBUFFER_INCOMPLETE_ATTACHMENT`	colour-only default on ES, as on master (`ofFboSettings` still requests depth/stencil)
4	`TARGET_OPENGLES_3` is a compile-time header check, true on iOS even for ES 1 / ES 2 contexts → ES 2 textures got `GL_RGBA8` (`GL_INVALID_OPERATION`), ES 1.1 FBOs reported "not supported"	new `ofIsGLES3Context()` (headers and live context ≥ 3) for the sized internal formats; `ofFbo::checkGLSupport` also accepts `GL_OES_framebuffer_object`

Note: the remaining ~75 TARGET_OPENGLES_3 compile-time branches (ofFbo MSAA/draw buffers, ofShader, ofBufferObject, …) have the same ES1/ES2-runtime caveat; I only switched the ones the tests hit. Worth a follow-up pass with ofIsGLES3Context().

Test matrix

Test app = graphicsExample's scene + the PR's GLSmokeTestCore + extra checks, version picked at launch. Built against the latest Apothecary libraries (macOS / iOS / emscripten / Android downloaded fresh).

Checks: context (renderer set up at the requested version) · texture upload → draw into FBO → readback colour · shader compile/link/draw → readback (programmable only) · smoke (indexed ofVboMesh, tess2 ofPath, FBO readback, instancing where available) · screen readback of graphicsExample's circle · tess2 star (index type matches ofIndexType + star arm pixels) · no GL errors

Platform	Requested	Context reported	Renderer	Context	Texture	Shader	Smoke	Screen	tess2 star	GL errors	Result
macOS (M1 Max)	GL 2.1	2.1 Metal - 90.5	ofGLRenderer (fixed)	✅	✅	n/a	✅	✅	✅	✅	PASS
macOS	GL 3.2 core	4.1 Metal - 90.5	ofGLProgrammableRenderer	✅	✅	✅	✅	✅	✅	✅	PASS
macOS	GL 3.3 core	4.1 Metal - 90.5	ofGLProgrammableRenderer	✅	✅	✅	✅	✅	✅	✅	PASS
macOS	GL 4.0 core	4.1 Metal - 90.5	ofGLProgrammableRenderer	✅	✅	✅	✅	✅	✅	✅	PASS
macOS	GL 4.1 core	4.1 Metal - 90.5	ofGLProgrammableRenderer	✅	✅	✅	✅	✅	✅	✅	PASS
iOS 26.5 Sim (iPhone 17 Pro)	ES 1.1	OpenGL ES-CM 1.1 APPLE-23.1.1	ofGLRenderer (fixed)	✅	✅	n/a	✅	✅	✅	✅	PASS
iOS 26.5 Sim	ES 2.0	OpenGL ES 2.0 APPLE-23.1.1	ofGLProgrammableRenderer	✅	✅	✅	✅	✅	✅	✅	PASS
iOS 26.5 Sim	ES 3.0	OpenGL ES 3.0 APPLE-23.1.1	ofGLProgrammableRenderer	✅	✅	✅	✅	✅	✅	✅	PASS

macOS tops out at GL 4.1 (any 3.2+ core request returns 4.1); GL 4.2+ needs Linux/Windows. Android emulator (ES 1.1 / 2.0 / 3.0 / 3.1) and emscripten (WebGL 1 / 2) runs to follow.

Also found: with older downloaded libs, ofPath fills drew a single triangle on macOS — tess2's tesselator.h used defined(TARGET_OS_IPHONE) (true on macOS), so oF read tess2's 32-bit indices as 16-bit. Current Apothecary latest already fixes the header; the new tess2 star check catches it.

Screenshots

macOS — GL 2.1 (fixed function)

macOS — GL 3.2 core

macOS — GL 3.3 / 4.0 / 4.1 core

iOS Simulator — ES 1.1 (fixed function)

iOS Simulator — ES 2.0

iOS Simulator — ES 3.0

danoli3 · 2026-10-06T10:08:35Z

This is looking great! Getting Qwen 3.8 local ai to test and analyse everything and doing test qa passes

danoli3 · 2026-10-06T10:11:40Z

Emscripten results (WebGL 1 / WebGL 2)

Same test app (graphicsExample scene + GLSmokeTestCore + extra checks) built with emsdk 6.0.11 (matches CI) against the latest Apothecary emscripten libs, at b226140. No further code changes were needed — both pass with the fixes already in this PR.

Run in headless Chrome on the real GPU (--use-angle=metal), driven over CDP; the result line is read from the page and the browser's own WebGL context type / renderer are recorded as a cross-check.

Platform	Requested	Context reported (oF)	Browser context	GPU	Context	Texture	Shader	Smoke	Screen	tess2 star	GL errors	Result
Chrome / emscripten	WebGL 2 (ES 3.0)	OpenGL ES 3.0 (WebGL 2.0 (OpenGL ES 3.0 Chromium))	`webgl2`	ANGLE Metal, Apple M1 Max	✅	✅	✅	✅	✅	✅	✅	PASS
Chrome / emscripten, `--disable-webgl2`	WebGL 1 (ES 2.0)	OpenGL ES 2.0 (WebGL 1.0 (OpenGL ES 2.0 Chromium))	`webgl1`	ANGLE Metal, Apple M1 Max	✅	✅	✅	✅	✅	✅	✅	PASS

Note: ofxAppEmscriptenWindow::setup ignores settings.glesVersion — it always tries WebGL 2 and falls back to WebGL 1 if that fails. So WebGL 1 was tested through that fallback (WebGL 2 disabled in the browser), which is what users without WebGL 2 get. Honouring an explicit setGLESVersion(2) would be possible, but the ofGLESWindowSettings default is glesVersion = 1, so it would need a "not set" state first.

Running total: macOS GL 2.1 / 3.2 / 3.3 / 4.0 / 4.1, iOS Simulator ES 1.1 / 2.0 / 3.0, emscripten WebGL 1 / 2 — all PASS. Android emulator (ES 1.1 / 2.0 / 3.0 / 3.1) next.

Screenshots

Emscripten — WebGL 2 (ES 3.0)

Emscripten — WebGL 1 (ES 2.0, fallback)

danoli3 self-assigned this Aug 11, 2026

danoli3 added the open gl es label Aug 11, 2026

danoli3 added this to the 0.12.2 milestone Aug 11, 2026

danoli3 added this to openFrameworks Development Aug 11, 2026

danoli3 mentioned this pull request Aug 11, 2026

OpenGLES 3 / OpenGLES 3.1 #8512

Closed

danoli3 force-pushed the OpenGLES3.1 branch from e45e6aa to 7eec513 Compare August 13, 2026 16:43

danoli3 force-pushed the OpenGLES3.1 branch from 7eec513 to 8d27b58 Compare August 14, 2026 16:27

danoli3 moved this to In Progress in openFrameworks Development Aug 20, 2026

danoli3 force-pushed the OpenGLES3.1 branch 2 times, most recently from 8d27b58 to b15ce0c Compare August 31, 2026 15:18

This was referenced Sep 11, 2026

Emscripten: bump to 6.0.6, fix template version macros and install script #8555

Merged

Fix msys2 clang64: move -std=gnu++17 from CFLAGS to CXXFLAGS #8556

Merged

Add GL smoke tests with CI headless fixes #8557

Merged

danoli3 force-pushed the OpenGLES3.1 branch 2 times, most recently from ebd5b9c to 7ea5268 Compare September 12, 2026 04:47

danoli3 force-pushed the OpenGLES3.1 branch from ae83f44 to bae1ec5 Compare September 28, 2026 08:27

Marcel Ruegenberg and others added 12 commits October 5, 2026 15:07

Enable new functionality of GL ES 2/3/3.1 via ifdefs

3e74a91

Android Studio 1.3/1.4 compatibility, and a fix.

4788181

Get an OpenGL ES 3.1 context if possible.

f950742

Fixes.

f7eab3e

Misc fixes

e89992b

Minor fixes when using GLES1.

7030788

More consistent API.

56871b8

Update EGL window class to use new GLES settings class.

563cdfe

TODO: iOS

Fixed problem with broken textures.

4502df7

Smaller fixes

35a733b

.

1f2fef2

Remove old android changes

9c4f5d1

danoli3 added 20 commits October 5, 2026 15:07

Android Window

e2c6bc6

ofAppAndroidWindow Fix

0d1d0f5

ofAppAndroidWindow

2d6184d

Android Window

511c407

ofGLUtils Android Fix

1760cce

OpenGLES 3.0

e677ed1

# Conflicts: # libs/openFrameworks/gl/ofGLProgrammableRenderer.cpp

ofWindowSettings with hidpi c++ default cpy ctor

951cf91

OpenGLES defines with targetable undefs in ofConstants

7e8617f

ofMesh Mode to Triangles on init

da7ebad

ofShader Fix

9d3217d

OpenGL fixes

539b749

Update Emscripten to 6.0.6

2d3393d

Fix client-side mesh indices on OpenGL ES 2

b3f0b8b

Restore line topology for ofMesh axis

ffe2a0f

Guard desktop buffer invalidation on OpenGL ES

a2b279a

Android View null fix

e6ecc6d

Add Android GLES lifecycle hardware stress test

e640968

danoli3 force-pushed the OpenGLES3.1 branch from bae1ec5 to b226140 Compare October 6, 2026 09:54

danoli3 added a commit to danoli3/openFrameworks that referenced this pull request Oct 6, 2026

Add emscripten WebGL 1 / WebGL 2 screenshots for openframeworks#8533

3def9e2

danoli3 added iOS macOS windows android webgl labels Oct 6, 2026

Navigation Menu

Uh oh!

OpenGLES 3.1 - #8533

OpenGLES 3.1#8533
danoli3 wants to merge 47 commits into
openframeworks:masterfrom
danoli3:OpenGLES3.1

danoli3 commented Aug 11, 2026 •

edited

Loading

Uh oh!

danoli3 commented Aug 13, 2026

Uh oh!

danoli3 commented Sep 12, 2026

Uh oh!

danoli3 commented Oct 6, 2026

Uh oh!

danoli3 commented Oct 6, 2026

Uh oh!

danoli3 commented Oct 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

danoli3 commented Aug 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

OpenGLES 3.1

TODO:

Uh oh!

danoli3 commented Aug 13, 2026

Uh oh!

danoli3 commented Sep 12, 2026

Uh oh!

danoli3 commented Oct 6, 2026

Rebased on master + GLES fixes + GL / GLES test matrix

Test matrix

Screenshots

Uh oh!

danoli3 commented Oct 6, 2026

Uh oh!

danoli3 commented Oct 6, 2026

Emscripten results (WebGL 1 / WebGL 2)

Screenshots

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

danoli3 commented Aug 11, 2026 •

edited

Loading