#gui #graphics #opengl #no-std #gleam

no-std gl-context-loader

Minimal OpenGL function loader for no_std OpenGL contexts

8 releases

Uses old Rust 2015

0.1.7 Aug 14, 2021
0.1.6 Aug 14, 2021
0.1.4 Jul 12, 2021
0.1.0 Jun 29, 2021

#236 in GUI

Download history 13/week @ 2021-06-24 3/week @ 2021-07-01 75/week @ 2021-07-08 25/week @ 2021-07-15 12/week @ 2021-07-22 35/week @ 2021-07-29 67/week @ 2021-08-05 109/week @ 2021-08-12 19/week @ 2021-08-19 12/week @ 2021-08-26 11/week @ 2021-09-02 13/week @ 2021-09-09 18/week @ 2021-09-16

89 downloads per month
Used in azul-webrender

Apache-2.0/MIT

265KB
6K SLoC

opengl-function-loader

Defines a struct holding OpenGL function pointers as well as the corresponding functions. Designed for no_std use (with default-features = false).

You are responsible for loading the functions yourself:

fn main() {
    /// ...

    wglMakeContextCurrent(hDC, hRC);

    let context = GenericGlContext {
        glAccum: wglGetProcAddress("glAccum"),
        glActiveTexture: wglGetProcAddress("glActiveTexture"),
        glAlphaFunc: wglGetProcAddress("glAlphaFunc"),
        glAreTexturesResident: wglGetProcAddress("glAreTexturesResident"),
        ...
    };

    // function provided by this library - also available on no_std!
    context.clear_color(0.0, 0.0, 0.0, 0.0);
    context.flush();

    wglMakeContextCurrent(NULL, NULL);
}

If a function pointer is set to 0x00000 (i.e. the function is not loaded), this library will return a "default" value without panicking (i.e. Vec::new(), String::new() or 0). With stdlib support it will print a "missing function: X" to stdout before returning.

If stdlib support is enabled, GenericGlContext implements gleam::Gl!. The point of this is to make it possible to integrate crates that use gleam::Gl with custom OpenGL function pointer loaders while using custom loaders on no_std.

License

The code is somewhat copied from servo/gleam, so it retains the original Apache/MIT license.

Dependencies