Go to file
daxpedda 98470393d1
Add dragging window with cursor feature (#1840)
* X11 implementation.

* Introduce example.

* Wayland implementation.

* Windows implementation.

* Improve Wayland seat passing.

* MacOS implementation.

* Correct windows implementation per specification.

* Update dependency smithay-client-toolkit from branch to master.

* Fixed blocking thread in windows implementation.

* Add multi-window example.

* Move Wayland to a different PR.

* Fix CHANGELOG.

* Improve example.

Co-authored-by: Markus Røyset <maroider@protonmail.com>

* Rename `set_drag_window` to `begin_drag`.

* Improve example.

* Fix CHANGELOG.

* Fix CHANGELOG.

Co-authored-by: Markus Røyset <maroider@protonmail.com>

* Rename to `drag_window`.

* Fix typo.

* Re-introduce Wayland implementation.

* Fixing Wayland build.

* Fixing Wayland build.

* Move SCTK to 0.12.3.

Co-authored-by: Markus Røyset <maroider@protonmail.com>
2021-03-07 10:43:23 +01:00
.github Test x11 and wayland features on CI 2020-06-15 22:49:09 +03:00
examples Add dragging window with cursor feature (#1840) 2021-03-07 10:43:23 +01:00
src Add dragging window with cursor feature (#1840) 2021-03-07 10:43:23 +01:00
tests Make size/position types generic over pixel type (#1277) 2020-01-05 14:15:11 -05:00
.gitattributes Set CHANGELOG.md merge style to union (#919) 2019-06-13 16:11:44 -04:00
.gitignore Remove util from gitignore 2020-01-09 12:24:57 -05:00
.gitmodules Forward porting (#966) 2019-06-23 02:39:26 -04:00
build.rs Change linking of CGDisplayCreateUUIDFromDisplayID on macos (#1626) 2021-02-05 08:58:55 +01:00
Cargo.toml Add dragging window with cursor feature (#1840) 2021-03-07 10:43:23 +01:00
CHANGELOG.md Add dragging window with cursor feature (#1840) 2021-03-07 10:43:23 +01:00
CONTRIBUTING.md Move contributors table to wiki (#934) 2019-06-19 15:12:27 -04:00
FEATURES.md Add dragging window with cursor feature (#1840) 2021-03-07 10:43:23 +01:00
HALL_OF_CHAMPIONS.md Linkify HALL_OF_CHAMPIONS.md (#935) 2019-06-18 16:30:37 -06:00
LICENSE Initial commit 2014-07-27 11:41:26 +02:00
README.md Change linking of CGDisplayCreateUUIDFromDisplayID on macos (#1626) 2021-02-05 08:58:55 +01:00
rustfmt.toml Re-format on stable rustfmt (#974) 2019-06-24 12:14:55 -04:00

winit - Cross-platform window creation and management in Rust

Crates.io Docs.rs CI Status

[dependencies]
winit = "0.24.0"

Documentation

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

For features outside the scope of winit, see Missing features provided by other crates in the wiki.

Contact Us

Join us in any of these:

Freenode Matrix Gitter

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 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.

use winit::{
    event::{Event, WindowEvent},
    event_loop::{ControlFlow, EventLoop},
    window::WindowBuilder,
};

fn main() {
    let event_loop = EventLoop::new();
    let window = WindowBuilder::new().build(&event_loop).unwrap();

    event_loop.run(move |event, _, control_flow| {
        *control_flow = ControlFlow::Wait;

        match event {
            Event::WindowEvent {
                event: WindowEvent::CloseRequested,
                window_id,
            } if window_id == window.id() => *control_flow = ControlFlow::Exit,
            _ => (),
        }
    });
}

Winit is only officially supported on the latest stable version of the Rust compiler.

Cargo Features

Winit provides the following features, which can be enabled in your Cargo.toml file:

  • serde: Enables serialization/deserialization of certain types with Serde.
  • x11 (enabled by default): On Unix platform, compiles with the X11 backend
  • wayland (enabled by default): On Unix platform, compiles with the Wayland backend

Platform-specific usage

WebAssembly

Winit supports compiling to the wasm32-unknown-unknown target with either a stdweb or a web-sys backend for use on web browsers. However, please note that the stdweb backend is being deprecated and may be removed in a future release of Winit. The web-sys backend is also more feature complete.

On the web platform, a Winit window is backed by a <canvas> element. You can either provide Winit with a <canvas> element, or let Winit create a <canvas> element which you can then retrieve and insert it into the DOM yourself.

For example code using Winit with WebAssembly, check out the web example. For information on using Rust on WebAssembly, check out the Rust and WebAssembly book.

Android

This library makes use of the ndk-rs crates, refer to that repo for more documentation.

Running on an Android device needs a dynamic system library, add this to Cargo.toml:

[[example]]
name = "request_redraw_threaded"
crate-type = ["cdylib"]

And add this to the example file to add the native activity glue:

#[cfg_attr(target_os = "android", ndk_glue::main(backtrace = "on"))]
fn main() {
    ...
}

And run the application with cargo apk run --example request_redraw_threaded

MacOS

To ensure compatibility with older MacOS systems, winit links to CGDisplayCreateUUIDFromDisplayID through the CoreGraphics framework. However, under certain setups this function is only available to be linked through the newer ColorSync framework. So, winit provides the WINIT_LINK_COLORSYNC environment variable which can be set to 1 or true while compiling to enable linking via ColorSync.