blob: 9dab3871e2e11db7c571d2fcca5cdd272ab9b0f4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
# glutin - OpenGL, UTilities and INput
[](https://gitter.im/tomaka/glutin?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Alternative to GLFW in pure Rust.
[](https://travis-ci.org/tomaka/glutin)
[](https://ci.appveyor.com/project/tomaka/glutin/branch/master)
```toml
[dependencies]
glutin = "*"
```
Note that the crates.io version won't compile on OS/X and Android because the required dependencies haven't been uploaded yet. Instead you can use the git version which works everywhere:
```toml
[dependencies.glutin]
git = "https://github.com/tomaka/glutin"
```
## [Documentation](http://tomaka.github.io/glutin/)
## Try it!
```bash
git clone https://github.com/tomaka/glutin
cd glutin
cargo run --example window
```
## Usage
Glutin is an OpenGL context creation library and doesn't directly provide OpenGL bindings for you.
```toml
[dependencies]
gl = "*"
libc = "*"
```
```rust
extern crate glutin;
extern crate libc;
extern crate gl;
fn main() {
let window = glutin::Window::new().unwrap();
unsafe { window.make_current() };
unsafe {
gl::load_with(|symbol| window.get_proc_address(symbol));
gl::ClearColor(0.0, 1.0, 0.0, 1.0);
}
while !window.is_closed() {
window.wait_events();
unsafe { gl::Clear(gl::COLOR_BUFFER_BIT) };
window.swap_buffers();
}
}
```
## Platform-specific notes
### Android
- To compile the examples for android, initialize the submodules, go to `deps/apk-builder/apk-builder` and run `cargo build`, then go back to `glutin` and call `ANDROID_HOME=/path/to/sdk NDK_HOME=/path/to/ndk NDK_STANDALONE=/path/to/standalone cargo test --no-run --target=arm-linux-androideabi`
- Events and vsync are not implemented
- Headless rendering doesn't work
### Emscripten
- Work will start when Emscripten gets updated to LLVM 3.5 (which should happen soon)
### OS/X
- Some events are not implemented
- Implementation is still work-in-progress
- Vsync not implemented
- Changing the cursor (set_cursor) is not implemented
### Win32
- You must call `glFlush` before `swap_buffers`, or else on Windows 8 nothing will be visible on the window
- Changing the cursor (set_cursor) is not implemented
### X11
- Some input events are not implemented
- Pixel formats not implemented
- Vsync not implemented
- Not all mouse cursors are implemented (ContextMenu, ...)
|
