Expand description
slint-pixel:可复用像素风 Slint 1.18 组件库。
提供:
- Slint 组件(经
@slint_pixel导入,嵌入你自己的.slint):PixelPainter画板、PixelTitleBar标题栏、PixelButton按钮、PixelCheckBox复选、PixelSwitch开关、PixelSlider滑块、PixelTextInput输入框、PixelProgressBar进度条、PixelBadge徽章、PixelPanel面板、PixelDialog对话框、Swatch色块。 - 成品窗口
PixelPainterWindow(Rust 类型,直接::new()使用)。 - Rust 侧一键接线:
install_painter()(画/擦、清空、导出 PNG)与install_title_bar_controls()(拖拽、最小化、最大化、关闭)。 library_paths():供下游 crate 的 build.rs 注册@slint_pixel库导入。- 画布数据:
Canvas(网格级 RGBA + 放大渲染 + PNG 导出)。
§在其它 Slint 项目里复用
§1. 添加依赖
[dependencies]
slint = "1.18"
slint-pixel = { path = "../slint-pixel" }
[build-dependencies]
slint-build = "1.18"
slint-pixel = { path = "../slint-pixel" }§2. build.rs 注册库路径并编译自己的 .slint
ⓘ
let config = slint_build::CompilerConfiguration::new()
.with_library_paths(slint_pixel::library_paths());
slint_build::compile_with_config("ui/main.slint", config).unwrap();§3. 在 ui/main.slint 中导入组件
import { PixelPainter, PixelTitleBar } from "@slint_pixel";§4. Rust 侧接线(宏把生成类型适配到本库契约,然后一键安装)
ⓘ
slint::include_modules!();
slint_pixel::impl_painter_ui!(MainWindow);
slint_pixel::impl_title_bar_ui!(MainWindow);
let ui = MainWindow::new().unwrap();
slint_pixel::install_painter(&ui);
slint_pixel::install_title_bar_controls(&ui);
ui.run().unwrap();也可以直接用成品窗口,连 .slint 都不用写:
use slint::ComponentHandle;
let ui = slint_pixel::PixelPainterWindow::new().unwrap();
slint_pixel::install_painter(&ui);
slint_pixel::install_title_bar_controls(&ui);
ui.run().unwrap();Re-exports§
pub use canvas::Canvas;pub use canvas::CELL_PX;pub use canvas::GRID;pub use slint::ComponentHandle as _;pub use slint::Global as _;pub use slint::ModelExt as _;
Modules§
- canvas
- 像素画布:保存 16×16 网格级 RGBA 数据,负责放大渲染与 PNG 导出。
Macros§
- impl_
painter_ ui - 为生成类型实现
PainterUi。用法: - impl_
resize_ ui - 为生成类型实现
ResizeUi。用法: - impl_
title_ bar_ ui - 为生成类型实现
TitleBarUi。用法:
Structs§
Traits§
- Painter
Ui - 画板接线契约:任何暴露
PixelPainter相同属性/回调的 Slint 组件均可实现。 - Resize
Ui - 窗口缩放接线契约:带
begin-resize(direction)回调的组件(配合 PixelWindowResize 热区)。 - Title
BarUi - 像素标题栏接线契约:带
drag-start / minimize / toggle-maximize / close-window回调的组件(如PixelTitleBar或组装后的窗口)均可实现。
Functions§
- attach_
owner - 非 Windows 平台:无 owner 概念,no-op(macOS 用 NSWindow parent、Linux 用 transient 由宿主自行处理)。
- install_
painter - 安装画板接线:画/擦、清空、导出 PNG,并返回画布句柄(供高级用法直接读写)。
- install_
title_ bar_ controls - 安装像素标题栏窗口控制:拖拽移动、最小化、最大化/还原、关闭。
- install_
title_ bar_ controls_ no_ quit - 同
install_title_bar_controls,但关闭只隐藏当前窗口、不退出整个事件循环 (适合子窗口;主窗口关闭用quit_on_close: true)。 - install_
window_ resize - 安装无边框窗口缩放:把
PixelWindowResize热区的方向回调接到 winit 的drag_resize_window(系统级缩放循环,跨平台)。 - library_
paths - 返回
@slint_pixel库路径表,供下游 crate 的 build.rs 注册。 - transparent_
window - 开启透明窗口,无边框窗口做「圆角窗身」时必须调用它。