Crate edgefirst_egl

Expand description

This crate provides a binding for the Khronos EGL 1.4/1.5 API.

It is a trimmed, maintained fork of the khronos-egl crate (itself a fork of the unmaintained egl crate), kept current for the EdgeFirst HAL. Only runtime (dynamic) loading of libEGL is supported; the upstream static-linking path has been removed.

§Usage

Enable the dynamic feature and load the EGL API at runtime via libloading into an Instance<Dynamic<libloading::Library>>:

edgefirst-egl = { version = ..., features = ["dynamic"] }

let lib = unsafe { libloading::Library::new("libEGL.so.1") }.expect("unable to find libEGL.so.1");
let egl = unsafe { egl::DynamicInstance::<egl::EGL1_4>::load_required_from(lib) }.expect("unable to load libEGL.so.1");

egl::EGL1_4 specifies the minimum required EGL version. When libEGL.so.1 provides a newer version you can upcast for version-specific features:

match egl.upcast::<egl::EGL1_5>() {
  Some(egl1_5) => {
    // do something with EGL 1.5
  }
  None => {
    // do something with EGL 1.4 instead.
  }
};