Pyodide-only WebGL bridge for imgui_bundle.
Available only in Pyodide builds (compile-time gated by
IMGUI_BUNDLE_WITH_WEBGL). On desktop, importing this submodule raises
ImportError; gate with imgui_bundle.has_submodule("webgl").
Typical usage:
import imgui_bundle
if imgui_bundle.has_submodule("webgl"):
from imgui_bundle import webgl
from js import document
gl = document.getElementById("canvas").getContext("webgl2")
tex = gl.createTexture()
# ... populate the texture via WebGL ...
tex_id = webgl.register_texture(tex)
# ... in the GUI loop ...
imgui.image(imgui.ImTextureRef(tex_id), ImVec2(256, 256))
# ... at shutdown ...
webgl.unregister_texture(tex_id)
gl.deleteTexture(tex)See _plans/pyodide_webgl_bridge__spec.md for the design rationale.
Upstream repository · The book’s page
Modules¶
In imgui_bundle (from imgui_bundle import webgl):
webgl: 2 functions, 0 classes, 0 enums
Demos using it¶
The demos of the catalog that use it (the pictures link to their code and to the playground).
Shader background, minimal¶
The Mandelbrot set, drawn by a fragment shader behind the GUI.
More
Pyodide only: this demo calls the browser’s WebGL2 API directly, through Python’s js interop. On desktop, you would use PyOpenGL instead.
Browser only
Uses: browser APIs
Shader background: a 3D sea¶
One source file, two platforms: a shader behind the GUI, with OpenGL on desktop and WebGL in the browser.
More
Uses: OpenGL, browser APIs
WebAudio synthesizer¶
A small synthesizer written in Python: play the piano with the mouse or the computer keyboard, or let it play a tune.
More
Pick a waveform, add some echo, and watch the scope. Pyodide only: it plays through the browser’s WebAudio API, via Pyodide’s js interop.
Browser only
Uses: knobs, browser APIs