# rokol-ffi
Rust FFI to [Sokol](https://github.com/floooh/sokol), only for [Rokol](https://github.com/toyboot4e/rokol)
It's generated with [bindgen](https://github.com/rust-lang/rust-bindgen) and implements `Default` trait.
## Status
**Tested on macOS only**
## Supported headers
`rokol_ffi` compiles all of the follows:
* `sokol_app.h`
* `sokol_gfx.h`
* `sokol_glue.h`
## Supported backends
GlCore33, Metal and D3D9. **WebGPU backend is not supported by rokol-ffi** (until I need it).
## Specifying renderer
Use feature flag to switch graphics backend: `cargo run --features=glcore33`.
## Conditional compilation in down stream crates
`rokol_ffi/build.rs` emits `DEP_SOKOL_GFX` to `build.rs` of crates that lists `rokol_ffi` in their `Cargo.toml`.
c.f. [Build Scripts - The Cargo Book #The links Manifest Key](https://doc.rust-lang.org/cargo/reference/build-scripts.html#the-links-manifest-key)