Go to file

Ivan Molodetskikh 825995687a anvil: add BufferUtils A helper struct which currently contains only a method for retrieving buffer dimensions. Will be used for getting the buffer dimensions early, before rendering, to always have up-to-date size which is not zero.		2020-02-03 12:56:59 +03:00
anvil	anvil: add BufferUtils	2020-02-03 12:56:59 +03:00
examples	Make wayland support optional	2019-02-06 09:29:56 +01:00
src	backend.egl: add egl_buffer_dimensions	2020-02-03 12:41:35 +03:00
.gitignore	Fix travis build with updated libinput	2017-12-15 19:22:40 +01:00
.rustfmt.toml	Remove unstable rustfmt options	2018-04-17 17:48:20 +02:00
.travis.yml	travis: don't test individual features on beta&nightly	2019-02-06 18:34:02 +01:00
CHANGELOG.md	version 0.2.0	2019-01-03 10:52:15 +01:00
CONTRIBUTING.md	Cargo.toml: include repo, update nix/image	2017-10-09 15:17:19 +02:00
Cargo.toml	Upgrade to dbus 0.8, change imports to match.	2020-01-01 11:42:28 +01:00
LICENSE.txt	Add MIT license	2017-03-24 10:24:07 +01:00
README.md	anvil: properly document logind support	2019-06-19 15:07:01 +02:00
build.rs	fmt: rust 1.31	2018-12-08 18:31:08 +01:00
doc_index.html	travis: add a redirect doc homepage	2017-10-01 20:34:24 +02:00
matrix_badge.svg	Add a few badges on the README	2017-10-04 11:30:07 +02:00
vagga.yaml	travis: increase ubuntu image version	2018-11-29 13:36:06 +01:00

README.md

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 functionnalities that pretty much any compositor will need, in a generic fashion.

Also:

Documented: Smithay strives to maintain a clear and detailed documentation of its API and its functionnalities. 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

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

You can run it with cargo after having cloned this repository:

cd anvil;

cargo run -- --{backend}

The currently available backends are:

--winit: start anvil as a Winit application. This allows you to run it inside of an other X11 or Wayland session.
--tty-udev: start anvil in a tty with udev support. This is the "traditional" launch of a Wayland compositor. Note that this requires you to start anvil as root if your system does not have logind available (consolekit support is planned). To use logind, you need to activate the associated cargo feature:
```
cargo run --features logind -- --tty-udev
```