smithay/gbm.rs

libgbm bindings for rust

Smithay

A smithy for rusty wayland compositors

Goals

Smithay aims to provide building blocks to create wayland compositors in Rust. While not being a full-blown compositor, it'll provide objects and interfaces implementing common functionalities that pretty much any compositor will need, in a generic fashion.

It supports the core Wayland protocols, the official protocol extensions, and some external extensions, such as those made by and for wlroots and KDE

Also:

• Documented: Smithay strives to maintain a clear and detailed documentation of its API and its functionalities. Compiled documentations are available on docs.rs for released versions, and here for the master branch.
• Safety: Smithay will target to be safe to use, because Rust.
• Modularity: Smithay is not a framework, and will not be constraining. If there is a part you don't want to use, you should not be forced to use it.
• High-level: You should be able to not have to worry about gory low-level stuff (but Smithay won't stop you if you really want to dive into it).

Anvil

Smithay as a compositor library has its own sample compositor: anvil.

To get informations about it and how you can run it visit anvil README

Other compositors that use Smithay

• Cosmic: Next generation Cosmic desktop environment
• Catacomb: A Wayland Mobile Compositor
• MagmaWM: A versatile and customizable Wayland Compositor
• Niri: A scrollable-tiling Wayland compositor
• Strata: A cutting-edge, robust and sleek Wayland compositor
• Pinnacle: A WIP Wayland compositor, inspired by AwesomeWM
• Sudbury: Compositor designed for ChromeOS
• wprs: Like xpra, but for Wayland, and written in Rust.

System Dependencies

(This list can depend on features you enable)

• libwayland
• libxkbcommon
• libudev
• libinput
• libgbm
• libseat
• xwayland

Contact us

If you have questions or want to discuss the project with us, our main chatroom is on Matrix: #smithay:matrix.org.

gbm.rs's Issues

Why does mapping require a function?

Why does mapping require a function to be passed instead of mapping then unmapping on drop?

gbm.rs/src/buffer_object.rs

Lines 299 to 310 in 8fd2021

	pub fn map<'a, D, F, S>(
	&'a self,
	device: &Device<D>,
	x: u32,
	y: u32,
	width: u32,
	height: u32,
	f: F,
	) -> Result<IoResult<S>, WrongDeviceError>
	where
	D: AsFd + 'static,
	F: FnOnce(&MappedBufferObject<'a, T>) -> S,

Implement Debug for all public types

Notably BufferObject is not Debug.

Using #![warn(missing_debug_implementations)] can help spotting them all.

cc Smithay/smithay#319

[Question] Minimal example with drm-rs(dev) and gbm.rs

I want to use code in dev branch of drm-rs (which seems to be far ahead from master) with gbm.rs lib. It should be pretty straightforward I beleive (given that the draft already exists on gmb page), but just in case: is there any example that already does this?