29 releases
0.3.5 | Sep 7, 2023 |
---|---|
0.3.1 | Jun 4, 2023 |
0.2.4 | Jan 28, 2023 |
0.2.2 | Dec 4, 2022 |
0.2.0 | Jul 25, 2022 |
#208 in Graphics APIs
1.5MB
4K
SLoC
🎨 acrylic
Ultra-portable, web-inspired UI toolkit with SIMD graphics.
Work in progress!
Also, requires a nightly toolchain if you've enabled SIMD support (which is the default).
🪂 Features
- feels familiar to web developers
- support for templating
- integrated JSON state store
- anti-aliased
- input API designed for improved accessibility
- pure and safe rust
- Fully
no_std
🏗️ Progress (core crate)
- ☑ XML parsing
- ☑ flexbox-like layout
- ☑ PNG images
- ☐ Railway images [WiP]
- ☑ full
no_std
support - ☑ textual nodes
- ☑ state store
- ☑ round containers
- ☑ input events
- ☑ event handlers
- ☑ SIMD acceleration
- ☑ text editing
- ☑ templating
- ☐ texture cache
- ☐ non-hardcoded state file
- ☐ scrolling [WiP]
- ☐ rich text
- ☐ external links
- ☐ video playback
- ☐ sound playback
🧱 Supported platforms
platform | Link | Rendering | Asset Loading | Event Handling |
---|---|---|---|---|
web | acrylic-web | ☑ | ☑ | WiP |
wayland | acrylic-wayland | ☑ | ☑ | WiP |
x11 | ||||
gdi | ||||
fbdev | ||||
drmkms |
⚡️ Quickstart
Project structure:
.
├── Cargo.toml
├── assets
│ ├── rustacean-flat-happy.png
│ └── default.xml
└── src
└── app.rs
An asset: rustacean-flat-happy.png
You can get it here.
Place it in assets/
.
The view layout: default.xml
<h-rem style="default">
<inflate />
<v-fixed length="400" gap="10">
<inflate />
<png file="rustacean-flat-happy.png" />
<h-fixed length="40" gap="10">
<inflate />
<label text="Rust rocks!" />
<inflate />
</h-fixed>
<inflate />
</v-fixed>
<inflate />
</h-rem>
The code: app.rs
use platform::{app, acrylic::{core::app::SimpleCallbackMap, ArcStr}};
fn layout_selector() -> ArcStr {
"default.xml".into()
}
app!("./assets/", layout_selector, SimpleCallbackMap::new(), "default.json");
The manifest: Cargo.toml
[package]
name = "my-app"
version = "0.1.0"
edition = "2021"
[lib]
crate-type = [ "cdylib" ]
path = "src/app.rs"
[dependencies]
# building for the web
platform = { package = "acrylic-web", version = "0.3" }
Building
cargo +nightly build --release --target wasm32-unknown-unknown
Note: this uses nightly because SIMD in rust is currently unstable.
Install a web server
httpserv
is tiny and good enough for this demo.
cargo install httpserv
Download the HTML file which starts your app
You can get it here. Place it at the root of your project, next to the cargo manifest.
Start the web server
From the root of your project:
# normal start:
httpserv
# quiet + in the background
httpserv > /dev/null &
Then open http://localhost:8080/#release
Expected Result
☕ Contact & Contributions
Contact
You can contact me via email
or on Discord: bitsneak#1889
.
You can use these for any question regarding this project.
Contributions
We gladly accept all contributions via Github Pull Requests.
👉 See Also
🕯️ License
- MIT for the code
- SIL Open Font License for the embedded Noto Font
Dependencies
~6MB
~119K SLoC