55 releases
0.31.6 | Sep 4, 2024 |
---|---|
0.31.5 | Jul 16, 2024 |
0.31.3 | May 31, 2024 |
0.31.1 | Jan 29, 2024 |
0.24.0 | Sep 14, 2019 |
#778 in GUI
376,487 downloads per month
Used in 578 crates
(8 directly)
98KB
1K
SLoC
wayland-cursor
Loading of XCursor images for Wayland client apps. This crate provides helpers to load the system
provided cursor images and load them into WlBuffer
s as well as obtain the necessary metadata to
properly display animated cursors.
lib.rs
:
Wayland cursor utilities
This crate aims to re-implement the functionality of the libwayland-cursor
library in Rust.
It allows you to load cursors from the system and display them correctly.
First of all, you need to create a CursorTheme
, which represents the full cursor theme.
From this theme, using the [get_cursor()
][CursorTheme::get_cursor()] method, you can load a
specific Cursor
, which can contain several images if the cursor is animated. It also provides
you with the means of querying which frame of the animation should be displayed at what time, as
well as handles to the buffers containing these frames, to attach them to a wayland surface.
Example
use wayland_cursor::CursorTheme;
// Load the default cursor theme.
let mut cursor_theme = CursorTheme::load(&connection, shm, 32)
.expect("Could not load cursor theme");
let cursor = cursor_theme.get_cursor("wait")
.expect("Cursor not provided by theme");
let start_time = Instant::now();
loop {
// Obtain which frame we should show, and for how long.
let millis = start_time.elapsed().as_millis();
let fr_info = cursor.frame_and_duration(millis as u32);
// Here, we obtain the right cursor frame...
let buffer = &cursor[fr_info.frame_index];
// and attach it to a wl_surface.
cursor_surface.attach(Some(&buffer), 0, 0);
cursor_surface.commit();
sleep(Duration::from_millis(fr_info.frame_duration as u64));
}
Dependencies
~3–12MB
~149K SLoC