Go to file
Mads Marquart bf97def398
Change `run_app(app: &mut A)` to `run_app(app: A)` (#3721)
This allows the user more control over how they pass their application state
to Winit, and will hopefully allow `Drop` implementations on the application
handler to work in the future on all platforms.
2024-07-11 15:38:09 +02:00
.cargo Re-introduce Web examples (#3637) 2024-04-18 19:43:39 +02:00
.github Web: use the word "Web" correctly and consistently (#3785) 2024-07-10 16:17:39 +02:00
docs/res Changes and improvements to the documentation (#3253) 2023-12-03 18:39:08 +01:00
dpi Rustfmt: use `group_imports` 2024-07-07 18:38:50 +02:00
examples Change `run_app(app: &mut A)` to `run_app(app: A)` (#3721) 2024-07-11 15:38:09 +02:00
src Change `run_app(app: &mut A)` to `run_app(app: A)` (#3721) 2024-07-11 15:38:09 +02:00
tests event_loop: remove generic user event 2024-06-24 13:04:55 +03:00
.git-blame-ignore-revs Add to `.git-blame-ignore-revs` file 2024-07-07 18:43:32 +02:00
.gitattributes Update changelog guidelines to prevent conflicts from blocking PRs (#2145) 2022-01-23 13:55:33 +01:00
.gitignore Web: implement `WaitUntilStrategy` (#3739) 2024-06-20 23:07:42 +02:00
.swcrc Web: implement `WaitUntilStrategy` (#3739) 2024-06-20 23:07:42 +02:00
CHANGELOG.md chore(docs): make changelogs visible on docsrs 2024-03-15 17:19:19 +04:00
CODE_OF_CONDUCT.md docs: add a code of conduct 2024-03-07 17:32:06 +04:00
CONTRIBUTING.md docs: fix release steps in CONTRIBUTING.md 2024-04-18 20:27:31 +04:00
Cargo.toml Web: fix `MouseMotion` coordinate space (#3770) 2024-07-05 16:07:01 +02:00
FEATURES.md Remove EventLoopExtIOS::idiom and ios::Idiom (#2924) 2024-06-24 22:56:20 +02:00
HALL_OF_CHAMPIONS.md Changes and improvements to the documentation (#3253) 2023-12-03 18:39:08 +01:00
LICENSE Initial commit 2014-07-27 11:41:26 +02:00
README.md Bump version on master 2024-06-21 21:40:16 +03:00
build.rs Move iOS and macOS implementations into new `apple` module (#3756) 2024-06-24 13:26:49 +02:00
clippy.toml Fix icrate's clippy customization 2024-04-18 20:04:42 +04:00
deny.toml Update Redox (#3368) 2024-01-10 20:05:52 +01:00
rustfmt.toml Rustfmt: use `group_imports` 2024-07-07 18:38:50 +02:00
typos.toml Fix CI failing when updating `typos` to 1.20.3 (#3620) 2024-04-03 00:38:55 +02:00

README.md

winit - Cross-platform window creation and management in Rust

Crates.io Docs.rs Master Docs CI Status

[dependencies]
winit = "0.30.3"

Documentation

For features within the scope of winit, see FEATURES.md.

For features outside the scope of winit, see Are we GUI Yet? and Are we game yet?, depending on what kind of project you're looking to do.

Contact Us

Join us in our Matrix room. If you don't get an answer there, try Libera.Chat.

The maintainers have a meeting every friday at UTC 15. The meeting notes can be found here.

Usage

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 movement, etc.) produced by the window.

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.

MSRV Policy

This crate's Minimum Supported Rust Version (MSRV) is 1.73. Changes to the MSRV will be accompanied by a minor version bump.

As a tentative policy, the upper bound of the MSRV is given by the following formula:

min(sid, stable - 3)

Where sid is the current version of rustc provided by Debian Sid, and stable is the latest stable version of Rust. This bound may be broken in case of a major ecosystem shift or a security vulnerability.

The exception is for the Android platform, where a higher Rust version must be used for certain Android features. In this case, the MSRV will be capped at the latest stable version of Rust minus three. This inconsistency is not reflected in Cargo metadata, as it is not powerful enough to expose this restriction.

All crates in the rust-windowing organizations have the same MSRV policy.

Platform-specific usage

Check out the winit::platform module for platform-specific usage.