Home

Awesome

[!Important] Linebender no longer uses Glazier, and so this project is no longer supported.

You should prefer to use winit instead.

<div align="center">

glazier

Xi Zulip dependency status Apache 2.0 Build Status

<!-- [![Crates.io](https://img.shields.io/crates/v/glazier.svg)](https://crates.io/crates/glazier) --> <!-- [![Docs](https://docs.rs/glazier/badge.svg)](https://docs.rs/glazier) --> </div>

[!Caution] This README content has not been validated recently.

Glazier is no longer supported, and should not be used.

This repository is made available for reference purposes.

Feel free to use the #glazier channel if reusing code from Glazier. Some of the text input handling code is more complete than the equivalent in winit, and so might be useful for reference.

Glazier is an operating system integration layer infrastructure layer intended for high quality GUI toolkits in Rust. It is agnostic to the choice of drawing, so the client must provide that, but the goal is to abstract over most of the other integration points with the underlying operating system.

Primary platforms are Windows, macOS, and Linux. Web is a secondary platform. Other ports may happen if they are contributed.

This library is currently work in progress and should be considered experimental. Contributions are welcome, see CONTRIBUTING for more details.

Community

Xi Zulip

Discussion of Xilem development happens in the Xi Zulip, specifically the #glazier stream. All public content can be read without logging in

Scope

The following tasks are in scope. Mostly they are implemented, but as always there is more refinement to be done.

The general philosophy is that a task is in scope if it requires deep integration with the platform and is not easy to separate out as a separate library that layers on top of Glazier.

Hooks provided

Glazier does not provide drawing primitives and is intended to be agnostic to the drawing infrastructure. It uses raw-window-handle to provide an attachment point for the drawing code, a widely used abstraction in the Rust ecosystem. A top priority will be integrating with the wgpu ecosystem. In addition, we would gladly accept integration work to make Piet run on top of Glazier, but this is not a core priority.

We hope to integrate with AccessKit for accessibility.

While Glazier currently has primitive support for scheduling repaint cycles, ultimately we would like to support frame pacing. Doing the actual decision of when to repaint is probably out of scope, but providing portable infrastructure (CVDisplayLink on macOS, presentation statistics, scheduling based on high resolution timers) is in scope.

Out of scope

We have no solution to interfacing with the system compositor. This is necessary to handle embedded video content properly, and is also a good way to stitch together other embedded content such as web views.

Like drawing, most font and text issues are out of scope. Localization and internationalization are expected to be handled by the layer above, though platform hooks would be in scope (for example, querying the locale preference).

Glazier does not provide a solution for packaging and distribution of applications. Work on this is needed, and we would gladly cooperate with such efforts.

Design

The code in Glazier can be divided into roughly two categories: the platform agnostic code and types, which are exposed directly, and the platform-specific implementations of these types, which live in per-backend directories in src/backend. The backend-specific code for the current backend is reexported as glazier::backend.

Glazier does not generally expose backend types directly. Instead, we expose wrapper structs that define the common interface, and then call corresponding methods on the concrete type for the current backend.

Unsafe

Interacting with system APIs is inherently unsafe. One of the goals of Glazier is to handle almost all interaction with these APIs, exposing a safe interface to the UI toolkit. The exception is drawing, which will generally require at least some additional unsafe code for integration.

Similar libraries

Dependencies

Glazier requires a recent rust toolchain to build; it does not (yet) have an explicit minimum supported rust version, but the latest stable version should work.

On Linux and BSD, Glazier also requires pkg-config and clang, and the development packages of wayland, libxkbcommon and libxcb, to be installed. Some of the examples require vulkan-loader.

Most distributions have pkg-config installed by default. To install the remaining packages on Fedora, run

sudo dnf install clang wayland-devel libxkbcommon-x11-devel libxcb-devel vulkan-loader-devel

To install them on Debian or Ubuntu, run

sudo apt-get install pkg-config clang libwayland-dev libxkbcommon-x11-dev libvulkan-dev

Further reading

License

Licensed under the Apache License, Version 2.0 (LICENSE or http://www.apache.org/licenses/LICENSE-2.0)

Contribution

Contributions are welcome by pull request. The Rust code of conduct applies.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.