2016-11-01 03:19:37 +11:00
|
|
|
# winit - Cross-platform window creation and management in Rust
|
2014-07-27 18:55:37 +10:00
|
|
|
|
2016-11-01 03:19:37 +11:00
|
|
|
[![](http://meritbadge.herokuapp.com/winit)](https://crates.io/crates/winit)
|
2015-05-04 23:18:03 +10:00
|
|
|
|
2016-11-01 03:19:37 +11:00
|
|
|
[![Docs.rs](https://docs.rs/winit/badge.svg)](https://docs.rs/winit)
|
2016-09-06 05:10:15 +10:00
|
|
|
|
2016-11-01 03:19:37 +11:00
|
|
|
[![Build Status](https://travis-ci.org/tomaka/winit.png?branch=master)](https://travis-ci.org/tomaka/winit)
|
|
|
|
[![Build status](https://ci.appveyor.com/api/projects/status/5h87hj0g4q2xe3j9/branch/master?svg=true)](https://ci.appveyor.com/project/tomaka/winit/branch/master)
|
2014-09-20 03:51:54 +10:00
|
|
|
|
2015-02-16 04:28:12 +11:00
|
|
|
```toml
|
|
|
|
[dependencies]
|
2017-05-22 14:41:06 +10:00
|
|
|
winit = "0.6"
|
2015-02-16 04:28:12 +11:00
|
|
|
```
|
|
|
|
|
2016-11-01 03:19:37 +11:00
|
|
|
## [Documentation](https://docs.rs/winit)
|
2014-07-28 19:45:59 +10:00
|
|
|
|
2014-07-27 23:59:58 +10:00
|
|
|
## Usage
|
|
|
|
|
2016-11-01 03:33:36 +11:00
|
|
|
Winit is a window creation and management library. It can create windows and lets you handle
|
|
|
|
events (for example: the window being resized, a key being pressed, a mouse mouvement, etc.)
|
2016-11-01 03:19:37 +11:00
|
|
|
produced by window.
|
2015-02-22 21:31:27 +11:00
|
|
|
|
2016-11-01 03:19:37 +11:00
|
|
|
Winit is designed to be a low-level brick in a hierarchy of libraries. Consequently, in order to
|
|
|
|
show something on the window you need to use the platform-specific getters provided by winit, or
|
|
|
|
another library.
|
2015-02-22 21:31:27 +11:00
|
|
|
|
2014-07-27 23:59:58 +10:00
|
|
|
```rust
|
2016-11-01 03:19:37 +11:00
|
|
|
extern crate winit;
|
2014-07-27 23:59:58 +10:00
|
|
|
|
|
|
|
fn main() {
|
2017-06-10 13:43:15 +10:00
|
|
|
let mut events_loop = winit::EventsLoop::new();
|
2017-05-22 15:03:22 +10:00
|
|
|
let window = winit::Window::new(&events_loop).unwrap();
|
2014-07-27 23:59:58 +10:00
|
|
|
|
2017-05-22 15:03:22 +10:00
|
|
|
events_loop.run_forever(|event| {
|
2015-06-16 21:48:08 +10:00
|
|
|
match event {
|
2017-05-22 15:03:22 +10:00
|
|
|
winit::Event::WindowEvent { event: winit::WindowEvent::Closed, .. } => {
|
2017-06-20 21:34:00 +10:00
|
|
|
winit::ControlFlow::Break
|
2017-05-22 15:03:22 +10:00
|
|
|
},
|
2017-06-10 13:43:15 +10:00
|
|
|
_ => winit::ControlFlow::Continue,
|
2015-06-16 21:48:08 +10:00
|
|
|
}
|
2017-05-22 15:03:22 +10:00
|
|
|
});
|
2014-07-27 23:59:58 +10:00
|
|
|
}
|
|
|
|
```
|