Skip to main content

Crate slint_pixel

Crate slint_pixel 

Source
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§

PixelPainterWindow

Traits§

PainterUi
画板接线契约:任何暴露 PixelPainter 相同属性/回调的 Slint 组件均可实现。
ResizeUi
窗口缩放接线契约:带 begin-resize(direction) 回调的组件(配合 PixelWindowResize 热区)。
TitleBarUi
像素标题栏接线契约:带 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
开启透明窗口,无边框窗口做「圆角窗身」时必须调用它。