posh is a type-safe OpenGL ES 3.0 wrapper library with the aim of making graphics programming enjoyable.
posh consists of a graphics library (posh::gl) and a shading language (posh::sl), which are tightly integrated in a single crate.
If you want to learn more about the concepts used by posh, check out our blog post.
Here's the typical shape of posh code. Shaders are written in normal Rust code, so their type signature naturally becomes part of the program that is used for performing type-safe draw calls.
use posh::{gl, sl};
// ... define custom shader interface types U, V, W, and F ...
fn vertex_shader(uniform: U, vertex: V) -> sl::VsOutput<W> {
// ... compute `sl::VsOutput { clip_position, interpolant }` ...
}
fn fragment_shader(uniform: U, interpolant: W) -> F {
// ... compute F ...
}
let program: gl::Program<U, V, F> = gl.create_program(
vertex_shader,
fragment_shader,
)?;
program
.with_uniforms(/* uniform bindings matching U */)
.with_framebuffer(/* framebuffer matching F */)
.with_settings(/* draw settings */)
.draw(/* vertex specification matching V */)?;posh is in an early alpha stage.
Use with caution.
Contributions are welcome!
The initial scope of posh is limited intentionally.
It targets a subset of OpenGL ES 3.0 and GLSL ES 3.00.
These restrictions can be lifted over time. A second iteration of posh could e.g. target a subset of wgpu rather than OpenGL.
The following awesome crates are closely related to the aims of posh:
-
Shades is an EDSL for statically-typed shaders.
-
rust-gpuis a compiler backend forrustcthat generates SPIR-V.
The main difference to these is that posh tightly integrates its shading language (an embedded domain-specific language) with its graphics library in a single crate.