精灵编辑器

Pyxen 内置了一个完整的精灵编辑器，可以直接在 iPad 和 Mac 上的项目中创建和编辑像素画。无需外部工具——设计你的精灵并即时看到更改应用到运行中的游戏。

打开精灵编辑器

在侧边栏中点击任意图像资源，然后点击编辑按钮，从图像查看器切换到精灵编辑器。

绘图工具

顶部的工具栏提供：

• 铅笔 — 绘制单个像素
• 橡皮擦 — 擦除像素
• 填充 — 用选中的颜色填充连通区域
• 线条 — 在两点之间绘制直线
• 矩形 — 绘制矩形（描边或填充）
• 椭圆 — 绘制椭圆（描边或填充）

选择一个工具，从调色板中选取颜色，然后在画布上绘制。使用捏合（iPad）或滚动（Mac）放大以进行像素级精确操作。

调色板

调色板位于编辑器底部。点击任意颜色即可选中。使用吸管工具从画布上取色。

调色板按图像分配——每个精灵图集可以有自己的颜色集。

选择工具

• 矩形选区 — 拖动以选择矩形区域
• 魔棒 — 点击以选择相似颜色的连通区域。按住 Shift 可添加到选区，按住 Shift+Option 可从选区中减去。
• 移动 — 拖动选区以重新定位

选中区域会显示行军蚁线（动画虚线轮廓）。在有活动选区时，你可以：

• 剪切（Cmd+X）— 移除选区并复制到剪贴板
• 复制（Cmd+C）— 将选区复制到剪贴板
• 粘贴（Cmd+V）— 将剪贴板内容粘贴为新的浮动选区
• 删除 — 清除选中区域

图层

右侧的图层面板显示当前图像的所有图层。你可以：

• 添加图层 — 在上方或下方创建新图层
• 重新排序 — 拖动以更改堆叠顺序
• 切换可见性 — 工作时临时隐藏图层
• 合并图层 — 将多个图层合并为一个

每个图层独立绘制。这让你可以将背景、角色和特效分离到不同的图层中，编辑时互不影响。

调整大小和画布

• 调整大小 — 更改图像尺寸（缩放现有内容）
• 画布大小 — 更改画布大小而不缩放（在边缘周围添加或移除空间）

动画时间轴

精灵编辑器内置了动画时间轴，用于创建逐帧精灵动画。

打开时间轴

点击胶片堆叠按钮（画布右下角）来切换动画模式。时间轴条将出现在画布下方。

创建动画

1. 打开动画选择器（时间轴左侧）并点击新建动画
2. 为其命名（例如 “walk”、“idle”、“attack”）
3. 使用图块选择工具在精灵图集上选择图块，然后点击添加到动画
4. 或者点击时间轴中的 + 按钮，按阅读顺序添加下一个图块

编辑帧

• 点击帧 可选中它——画布会缩放到该图块以便编辑
• 右键点击帧 可移除或重新排序
• 播放控制 — 播放/停止、FPS 步进器（1-60）、帧计数器

洋葱皮

切换洋葱皮按钮可在编辑时查看前一帧的半透明叠加。这有助于保持动画帧之间的一致性。

图块隔离

编辑帧时，切换隔离按钮可隐藏或淡化周围的图块，让你专注于当前帧。

在代码中使用动画

动画保存在精灵的元数据中。使用 animation 参数在游戏中播放它们：

player.sprite = Sprite("hero", animation="walk")

参见精灵与渲染和 Sprite 参考文档了解完整 API。

撤销和重做

精灵编辑器中的每个操作都支持撤销（Cmd+Z）和重做（Cmd+Shift+Z）。撤销栈按图像分配，在项目打开期间持续存在。

实时预览

当你的游戏正在运行时，你在精灵编辑器中所做的任何更改都会立即生效——画一个像素就能在游戏预览中看到它出现。这使得在测试游戏玩法的同时迭代美术变得非常容易。

提示

• 使用网格覆盖层在图块表上精确对齐图块
• 放大进行像素级细节编辑，缩小查看完整图像
• 图层非常适合在同一张图上分离动画帧
• 精灵编辑器会自动保存——更改会在你工作时写入项目文件
• 在 iPad 上使用 Apple Pencil 时，在偏好设置中启用仅 Pencil 绘制，用 Pencil 画画，用手指平移