#gl #egl #opengl #khronos

gl

OpenGL bindings

29 releases

0.12.0 Apr 1, 2019
0.11.0 Nov 4, 2018
0.10.0 Feb 3, 2018
0.7.0 Dec 1, 2017
0.0.1 Nov 12, 2014

#3 in Graphics APIs

Download history 1172/week @ 2019-01-20 1468/week @ 2019-01-27 1453/week @ 2019-02-03 1019/week @ 2019-02-10 1460/week @ 2019-02-17 1110/week @ 2019-02-24 1023/week @ 2019-03-03 1238/week @ 2019-03-10 982/week @ 2019-03-17 1490/week @ 2019-03-24 1341/week @ 2019-03-31 1280/week @ 2019-04-07 1361/week @ 2019-04-14 1356/week @ 2019-04-21 1402/week @ 2019-04-28

5,324 downloads per month
Used in 148 crates (66 directly)

Apache-2.0

20KB
282 lines

gl-rs

Version License Downloads

An OpenGL function pointer loader for the Rust Programming Language.

[dependencies]
gl = "0.6.0"

Basic usage

You can import the pointer style loader and type aliases like so:

extern crate gl;
// include the OpenGL type aliases
use gl::types::*;

You must load the function pointers into their respective function pointers using the load_with function. You must supply a loader function from your context library, This is how it would look using [glfw-rs] (https://github.com/PistonDevelopers/glfw-rs):

// the supplied function must be of the type:
// `&fn(symbol: &'static str) -> *const std::os::raw::c_void`
// `window` is a glfw::Window
gl::load_with(|s| window.get_proc_address(s) as *const _);

// loading a specific function pointer
gl::Viewport::load_with(|s| window.get_proc_address(s) as *const _);

Calling a function that has not been loaded will result in a failure like: panic!("gl::Viewport was not loaded"), which avoids a segfault. This feature does not cause any run time overhead because the failing functions are assigned only when load_with is called.

// accessing an enum
gl::RED_BITS;

// calling a function
gl::DrawArrays(gl::TRIANGLES, 0, 3);

// functions that take pointers are unsafe
unsafe {  gl::ShaderSource(shader, 1, &c_str, std::ptr::null()) };

Each function pointer has an associated boolean value allowing you to check if a function has been loaded at run time. The function accesses a corresponding global boolean that is set when load_with is called, so there shouldn't be much overhead.

if gl::Viewport::is_loaded() {
    // do something...
}

Changelog

v0.6.0

  • Upgrade to gl_generator v0.5.0

v0.5.2

  • Update crate metadata

v0.5.1

  • Upgrade khronos_api to v1.0.0

v0.5.0

  • Use glutin for examples
  • Use raw::c_void for GLvoid

No runtime deps

~84KB