企业官网建设流程全解析

PixiEditor 自定义笔刷：笔刷形状、大小与抗锯齿的设置方法

【免费下载链接】PixiEditorPixiEditor is a Universal Editor for all your 2D needs项目地址: https://gitcode.com/GitHub_Trending/pi/PixiEditor

PixiEditor 是一款开源的 2D 像素画与动画编辑器，其笔刷引擎允许你精确控制每一笔的形状、大小和边缘过渡。本文介绍它的 5 种笔刷形状模式、3 个核心参数，以及如何加载和扩展自定义笔刷。

笔刷形状预览是什么

鼠标悬停在画布上时，光标周围的细线框就是笔刷形状预览，由 BrushShapeOverlay 覆盖层实现。它在移动指针时实时调用笔刷引擎计算当前笔触的实际轮廓并绘制出来，因此你看到的形状就是落笔后的形状，不需要试画验证。预览线宽会随缩放级别自动变细，高倍放大下依然清晰。

五种笔刷形状模式怎么选

BrushShape 枚举定义了 5 种模式，对应预览的显示方式：

• Hidden：隐藏预览线框，适合不想被遮挡的场景
• Pixel：单像素点，用于逐像素放置
• Square：方形笔触，边缘硬、块状感强
• CirclePixelated：轮廓切成像素的圆形，匹配像素画风格
• CircleSmooth：抗锯齿的平滑圆形，适合粒子、光晕类效果

像素画作品建议用CirclePixelated，做柔边效果时切换CircleSmooth。

三个最常调的参数

• 大小：对应 BrushData 中的StrokeWidth，单位为像素，直接决定落笔直径。
• 抗锯齿：AntiAliasing布尔属性，关闭后边缘保持像素硬边，开启后边缘平滑过渡约 1~2 像素。注意预览线框本身始终开启抗锯齿，最终渲染以笔刷设置为准。
• 压感平滑窗口：笔刷引擎 的PressureSmoothingWindowSize默认 10，对压感做滑动平均过滤；调大曲线更稳但响应变钝，鼠标绘制可以调小以获得更跟手的反馈。

笔刷颜色跟随右侧色板的前景色，常用颜色组合可以保存为色板复用。

从哪里获取更多笔刷

内置笔刷以.pixi格式存放在 src/PixiEditor/Data/Brushes/，包括 PixelCircle、Splats（泼溅）、Foam（气泡）、Texture、Strands 等，可在笔刷面板直接选用。

自建笔刷有两条路径：

1. 在文档内用节点图搭建笔刷逻辑，保存为.pixi文件；
2. 通过扩展批量注册，Sample11_Brushes 示例的做法是：

Api.BrushesProvider.RegisterBrushDataSource( new BrushesDataSource("MyBrushes", [brushBytes]));

常见坑与排查

• 预览线框不跟随鼠标：笔刷数据未加载（BrushGraph为空），检查是否选中了有效笔刷。
• 放大后线框显得粗：正常现象，预览线宽按 1/缩放 缩放，属设计行为。
• 长笔画时出现红色"绳索"标记：这是稳定模式（CircleRope / TimeBased）在限制单次落笔的最大步长，防止快速移动造成断点。
• 验收标准：画一条直线，观察边缘过渡宽度；关闭抗锯齿后边界应无半透明像素，开启后过渡不超过 2 像素，即为设置生效。

【免费下载链接】PixiEditorPixiEditor is a Universal Editor for all your 2D needs项目地址: https://gitcode.com/GitHub_Trending/pi/PixiEditor