ZenGL
ZenGL is a minimalist Python module providing exactly one way to render scenes with OpenGL.
pip install zengl
ZenGL is ...
- high-performance
- simple - buffers, images, pipelines and there you go
- easy-to-learn - it is simply OpenGL with no magic added
- verbose - most common mistakes are catched and reported in a clear and understandable way
- robust - there is no global state or external trouble-maker affecting the render
- backward-compatible - it requires OpenGL 3.3 - it is just enough
- cached - most OpenGL objects are reused between renders
- zen - there is one way to do it
Concept
ZenGL provides a simple way to render from Python. We aim to support headless rendering first, rendering to a window is done by blitting the final image to the screen. By doing this we have full control of what we render. The window does not have to be multisample, and it requires no depth buffer at all.
Offscreen rendering works out of the box on all platforms if the right loader is provided. Loaders implement a load method to resolve a subset of OpenGL 3.3 core. The return value of the load method is an int, a void pointer to the function implementation. Virtualized, traced, and debug environments can be provided by custom loaders. The current implementation uses the glcontext from moderngl to load the OpenGL methods.
ZenGL's main focus is on readability and maintainability. Pipelines in ZenGL are almost entirely immutable and they cannot affect each other except when one draws on top of the other's result that is expected. No global state is affecting the render, if something breaks there is one place to debug.
ZenGL does not use anything beyond OpenGL 3.3 core, not even if the more convenient methods are available. Implementation is kept simple. Usually, this is not a bottleneck.
ZenGL does not implement transform feedback, storage buffers or storage images, tesselation, geometry shader, and maybe many more. We have a strong reason not to include them in the feature list. They add to the complexity and are against ZenGL's main philosophy. ZenGL was built on top experience gathered on real-life projects that could never make good use of any of that.
ZenGL is using the same vertex and image format naming as WebGPU and keeping the vertex array definition from ModernGL. ZenGL is not the next version of ModernGL. ZenGL is a simplification of a subset of ModernGL with some extras that were not possible to include in ModernGL.
Examples
grass.py
envmap.py
instanced_crates.py
julia_fractal.py
blending.py
render_to_texture.py
pybullet_box_pile.py
pygmsh_shape.py
texture_array.py
monkey.py
reflection.py
polygon_offset.py
blur.py
hello_triangle.py
hello_triangle_srgb.py
viewports.py
points.py
wireframe_terrain.py
crate.py
sdf_example.py
sdf_tree.py
mipmaps.py
conways_game_of_life.py
Headless
import zengl
from PIL import Image
ctx = zengl.context(zengl.loader(headless=True))
size = (1280, 720)
image = ctx.image(size, 'rgba8unorm', samples=1)
triangle = ctx.pipeline(
vertex_shader='''
#version 330
out vec3 v_color;
vec2 positions[3] = vec2[](
vec2(0.0, 0.8),
vec2(-0.6, -0.8),
vec2(0.6, -0.8)
);
vec3 colors[3] = vec3[](
vec3(1.0, 0.0, 0.0),
vec3(0.0, 1.0, 0.0),
vec3(0.0, 0.0, 1.0)
);
void main() {
gl_Position = vec4(positions[gl_VertexID], 0.0, 1.0);
v_color = colors[gl_VertexID];
}
''',
fragment_shader='''
#version 330
in vec3 v_color;
layout (location = 0) out vec4 out_color;
void main() {
out_color = vec4(v_color, 1.0);
}
''',
framebuffer=[image],
topology='triangles',
vertex_count=3,
)
image.clear_value = (1.0, 1.0, 1.0, 1.0)
image.clear()
triangle.render()
Image.frombuffer('RGBA', size, image.read(), 'raw', 'RGBA', 0, -1).save('hello.png')
3 Sep 27, 2022
1 Jan 09, 2022
921 Dec 25, 2022
4 Nov 16, 2022
49 Oct 17, 2022
13 Dec 16, 2022
1 Nov 01, 2021
2k Dec 19, 2022
6 Mar 31, 2022
86 Dec 29, 2022
105 Dec 21, 2022
4 May 16, 2022
2 Nov 03, 2022
2 Feb 13, 2022
6 Oct 01, 2022
3.5k Dec 31, 2022
220 Dec 27, 2022
6 Aug 05, 2022
1 Feb 02, 2022
87 Dec 22, 2022