项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- 已安装 Git,可克隆 GitHub 仓库
- 已安装 Rust 工具链(提供 cargo 命令)
- 如需 Web 构建,需安装 trunk
- 如需打包 macOS 应用,需能运行 cargo xtask
安装与启动步骤
-
1克隆仓库
从 GitHub 拉取源码并进入项目目录,后续命令都在此目录执行。
git clone https://github.com/storytold/vectorcraft cd vectorcraft -
2编译并启动桌面版
首次运行会编译全部 Rust 依赖,耗时较长,完成后弹出原生绘图窗口。
cargo run --release -p vectorcraft -
3打开示例文件
启动时直接载入仓库自带的示例工程,可用来确认绘制与渲染是否正常。
cargo run --release -p vectorcraft -- examples/dusk-poster.vectorcraft -
4启用控制通道
可选,启动后额外开放 7979 端口上的 JSON 控制通道,供外部程序驱动编辑器。
cargo run --release -p vectorcraft -- --control 7979 -
5无界面批量导出
可选,用 CLI 读取工程文件并导出 PDF,适合脚本化批处理,不打开窗口。
cargo run --release -p vectorcraft-cli -- run --in examples/ribbons.vectorcraft --export out.pdf -
6构建 Web 版
可选,进入 Web 子项目用 trunk 编译 wasm 版本,产物输出到 dist/web。
cd apps/vectorcraft-web && trunk build --release -
7打包 macOS 应用
可选,仅 macOS,生成 dist/VectorCraft.app 应用包,便于分发。
cargo xtask bundle
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
CRAFT_FONTS_DIR | 否 | 指向 craft-fonts 仓库绝对路径,提供日文字体;不设则用系统字体 | /Users/me/craft-fonts |
WGPU_POWER_PREF | 否 | 双显卡机器上选择独显或集显启动,取值 high 或 low | high |
WGPU_ADAPTER_NAME | 否 | 按名称片段指定显卡,如 nvidia | nvidia |
WAYLAND_DISPLAY | 否 | 置空可在 Wayland 下改走 XWayland,恢复文件拖放与数位笔 | |
如何确认成功
运行桌面版命令后能弹出 VectorCraft 绘图窗口,并能打开并显示示例工程即为成功。
常见问题
Q:Mac/Windows 双显卡下渲染用的是哪块显卡?
A:默认使用省电的集成显卡(Windows、macOS);可在首选项 › 性能 › 图形处理器中切换并重启,或用 WGPU_POWER_PREF、WGPU_ADAPTER_NAME 在启动时指定。
Q:Wayland 下拖放文件没反应?
A:winit 0.30 在原生 Wayland 下不接收拖放文件。改用 File › Open 打开 SVG,或在首选项把 Linux 显示服务器设为 X11 (XWayland) 后重启。
Q:数位笔在 Wayland 下无法绘图?
A:KDE Plasma 6.3+ 与 GNOME 下已知问题。把 Linux 显示服务器设为 X11 (XWayland),或设置为仅在连接笔时使用 XWayland,然后重启。
Q:为什么日文显示成了系统字体?
A:未设置可选的 CRAFT_FONTS_DIR 时会回退到系统字体。按官方发布流程构建请指向 storytold/craft-fonts 的绝对路径。
注意事项
- README 未给出 Rust 版本要求,请自行确认工具链为较新稳定版。
- 首次 cargo run --release 需完整编译依赖,耗时明显长于后续启动。
- 仓库含大量示例工程 examples/*.vectorcraft,可用于验证安装与渲染。
核心亮点
- 纯 Rust 从零实现,无 Electron/浏览器依赖,启动快、内存占用低
- 原生支持 SVG 导入导出,便于与设计工作流衔接
- 代码结构清晰,适合作为矢量编辑器二次开发或学习图形编程的参考
不足之处
- 功能成熟度与专业矢量软件仍有差距,复杂编辑能力待完善
- 文档与社区生态尚在成长中,插件和教程资源有限
适用场景
- 开发者学习 Rust 图形编程与矢量渲染的参考项目
- 轻量场景下快速绘制和编辑 SVG 图标、示意图
- 作为基础二次开发定制专属矢量编辑工具
替代项目
Inkscape、Graphite
上一篇:solid-glass
下一篇:没有了!
同类项目推荐
open-design
开源
让 AI 代工做界面,本地跑完随手改
The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create···
Excalidraw
开源
开源虚拟白板协作工具
Virtual whiteboard for sketching hand-drawn like diagrams
morph
开源
用数据直接生成设计、动画和交互可视化
Morph is a free and open-source tool for creating designs, animations or interactive···
ChatGPT-MidJourney-prompt
开源
输入一句话,AI帮你生成Midjourney完整提示词
This is a ChatGPT based prompt generation model for MidJorney. The purpose of this m···
