KAS, (historically the toolKit Abstraction System), is a general-purpose GUI toolkit. KAS's design provides:
- retained mode (library stores state), inspired by Qt (classic)
- concise, partially declarative specification of widgets
- type-safe, widget-local event handlers
- simple ownership with no retained pointers into widget state
- widgets embed state and handlers (easy reuse of complex components)
- scalability to millions of widgets
For details, see the Examples README.
- Automatic window size and layout: just specify row/column/grid layout and let KAS do the rest (with correct HiDPI scaling)
- Themes (sizing and rendering control) and colour schemes with run-time switching
- Accessibility/input: full keyboard control as well as touchscreen and mouse
- Bidirectional and rich text support via KAS-text with complex glyph shaping via HarfBuzz
- Accelerated graphics via WebGPU
- Embedded accelerated graphics via custom pipelines
These aren't here yet!
- Raster graphics
- Flow-box layouts (but rows, columns and grids are enough for most stuff)
- CPU-based fallback renderer
- Desktop UI integration
- And much more, see the ROADMAP.
- API docs: https://docs.rs/kas, https://docs.rs/kas-theme, https://docs.rs/kas-wgpu
- KAS Tutorials
- Examples
- Discuss
- KAS Blog
KAS requires [Rust] version 1.45 or greater. All examples are compatible with the stable channel, but using the nightly channel does have a couple of advantages:
- Proceedural macros emit better diagnostics. In some cases, diagnostics are missed without nightly rustc, hence nightly is recommended for development.
- Documentation generated via
cargo doc
requires nightly for links - A few minor option things: see Feature flags below.
Currently, KAS's only drawing method is WebGPU which requires DirectX 11/12, Vulkan or Metal. In the future, there may be support for OpenGL and software rendering.
This is only needed if the shaping
feature is enabled. On my system, the
following libraries are used: libharfbuzz.so.0
, libglib-2.0.so.0
,
libgraphite2.so.3
and libpcre.so.1
.
Install dependencies:
# For Ubuntu:
sudo apt-get install build-essential git libxcb-shape0-dev libxcb-xfixes0-dev libharfbuzz-dev
# For Fedora:
# glslc is optional; see kas-wgpu/README.md
sudo dnf install libxcb-devel harfbuzz-devel glslc
Next, clone the repository and run the examples as follows:
git clone https://github.com/kas-gui/kas.git
cd kas
cargo test
cd kas-wgpu
cargo build --examples
cargo run --example gallery
cargo run --example layout
cargo run --example mandlebrot
To build docs locally:
RUSTDOCFLAGS="--cfg doc_cfg" cargo +nightly doc --features markdown --no-deps --all --open
kas
: the core of the GUI library, providing most interfaces and logic along with a selection of common widgetskas-macros
: a helper crate for proc macros (do not use directly)- KAS-text: font loading, text layout, text navigation
kas-theme
: theming support for KAS (API plus two themes; organisation may change)kas-wgpu
: provides windowing viawinit
and rendering via WebGPU
A user depends on kas
to write their complete UI specification, selects a
theme from kas-theme
, instances a kas_wgpu::Toolkit
, adds the window(s),
and runs the UI.
The kas
crate has the following feature flags:
shaping
: enables complex glyph forming for languages such as Arabic. This requires that the HarfBuzz library is installed.markdown
: enables Markdown parsing for rich-textserde
: adds (de)serialisation support to various typesjson
: adds config (de)serialisation using JSON (impliesserde
)yaml
: adds config (de)serialisation using YAML (impliesserde
)winit
: adds compatibility code for winit's event and geometry types. This is currently the only functional windowing/event library.stack_dst
: some compatibility impls (seekas-theme
's documentation)internal_doc
: turns on some extra documentation intended for internal usage but not for end users. (This only affects generated documentation.)
Formats are not yet stabilised, hence reading/writing configuration is disabled
by default. Ensure that the yaml
and/or json
feature flag is enabled, then
configure with environment variables:
# Set the config path:
export KAS_CONFIG=kas-config.yaml
# Use write-mode to write out default config:
KAS_CONFIG_MODE=writedefault cargo run --example gallery
# Now just edit the config and run like normal:
cargo run --example gallery
The COPYRIGHT file includes a list of contributors who claim copyright on this project. This list may be incomplete; new contributors may optionally add themselves to this list.
The KAS library is published under the terms of the Apache License, Version 2.0. You may obtain a copy of this licence from the LICENSE file or on the following webpage: https://www.apache.org/licenses/LICENSE-2.0