1 unstable release
0.48.0 | Dec 28, 2022 |
---|
#305 in Graphics APIs
165KB
3K
SLoC
glfw-rs
GLFW bindings and wrapper for The Rust Programming Language.
Example
extern crate glfw;
use glfw::{Action, Context, Key};
fn main() {
let mut glfw = glfw::init(glfw::FAIL_ON_ERRORS).unwrap();
let (mut window, events) = glfw.create_window(300, 300, "Hello this is window", glfw::WindowMode::Windowed)
.expect("Failed to create GLFW window.");
window.set_key_polling(true);
window.make_current();
while !window.should_close() {
glfw.poll_events();
for (_, event) in glfw::flush_messages(&events) {
handle_window_event(&mut window, event);
}
}
}
fn handle_window_event(window: &mut glfw::Window, event: glfw::WindowEvent) {
match event {
glfw::WindowEvent::Key(Key::Escape, _, Action::Press, _) => {
window.set_should_close(true)
}
_ => {}
}
}
Using glfw-rs
Prerequisites
Make sure you have compiled and installed GLFW 3.x.
You might be able to find it on your package manager, for example on OS X:
brew install glfw3
(you may need to run brew tap homebrew/versions
).
If not you can download and build the library
from the source supplied on the
GLFW website. Note that if you compile GLFW with CMake on Linux, you will have
to supply the -DCMAKE_C_FLAGS=-fPIC
argument. You may install GLFW to your
PATH
, otherwise you will have to specify the directory containing the library
binaries when you call make
or make lib
:
GLFW_LIB_DIR=path/to/glfw/lib/directory make
Including glfw-rs in your project
Add this to your Cargo.toml
:
[dependencies.glfw]
version = "*"
On Windows
By default, glfw-rs
will try to compile the glfw
library. If you want to link to your custom
build of glfw
or if the build doesn't work (which is probably the case on Windows), you can
disable this:
[dependencies.glfw]
version = "*"
default-features = false
Support
Contact bjz
on irc.mozilla.org #rust
and #rust-gamedev,
or post an issue on GitHub.
glfw-rs in use
Dependencies
~1.6–3MB
~53K SLoC