Sprite（精灵）提取窗口 | SandMod API 文档

简介

用作制作 2D 动画的图片贴图，通常以逐帧画面的列表或包含许多变体的单个图像文件的形式出现，Sprite（精灵）提取窗口为您提供了一个更为便捷且降低运行性能损耗的 Sprite（精灵）提取功能。Sprite（精灵）提取窗口用于提取每个单独的帧作为 Sprite（精灵）。

【Extract_Sprite001.png】

Sprite（精灵）提取画布

Sprite（精灵）提取画布位于 Sprite（精灵）提取窗口的左侧，用于预览提取的 Sprite（精灵）范围以及提取前的 Sprite（精灵）布局。

【Extract_Sprite002.png】

基础操作

平移画布：长按鼠标右键并拖动鼠标，可以移动 Sprite（精灵）提取画布。

【Extract_Sprite003.gif】

缩放画布：滚动鼠标滚轮或类似功能可放大和缩小 Sprite（精灵）提取画布。

【Extract_Sprite004.gif】

外观设置

您还可以在 Sprite（精灵）提取窗口右侧的属性中，通过边框颜色（Border Color）属性调整提取 Sprite（精灵）的边框颜色。

【Extract_Sprite005.gif】

如果 Sprite（精灵）的颜色与背景颜色冲突以至于不便于提取 Sprite（精灵），您可以通过背景颜色（Back Color）属性调整画布的背景颜色。

【Extract_Sprite006.gif】

Sprite（精灵）提取方式

Sprite（精灵）提取窗口右侧通过提取精灵模式（Extract Sprite Type）属性的设置，您可以选择如何分割 Sprite（精灵）列表中的 Sprite（精灵）。

【Extract_Sprite007.png】

使用自定义（Custom）模式，您将可以在 Sprite（精灵）提取画布中勾勒出自定义的分割轮廓。如果您想要提取出尺寸统一的 Sprite（精灵），则可以将提取精灵模式属性设置为网格（Grid）模式。

网格提取模式

提取过程中，如果提取的各个 Sprite（精灵）在宽（Width）和高（Height）维度上的像素长度以及 Sprite（精灵）之间是否有均匀的间距，建议将提取精灵模式（Extract Sprite Type）属性设置为网格（Grid）模式。

设置为网格（Grid）模式后，Sprite（精灵）提取窗口右侧将会显示网格（Grid）模式相关的可配置属性，且这些属性都在网格（Grid）属性折叠条目下。

【Extract_Sprite008.png】

名称	描述
网格宽度（Grid Width）	您可以设置每个单元格的宽度（X，以像素数为单位），以将 Sprite（精灵）列表划分为单独的 Sprite（精灵）。
网格高度（Grid Height）	您可以设置每个单元格的高度（Y，以像素数为单位），以将 Sprite（精灵）列表划分为单独的 Sprite（精灵）。
水平矩形数量（Horizontal Count）	用于限制可以使用的单元格数量，以限制在水平（ X 轴）方向上可以提取的 Sprite（精灵）数量。属性值为自然数，且属性值不能大于 Sprite（精灵）列表的宽度（X）除以网格宽度（Grid Width）属性值的商，属性值 0 时不会施加限制。
垂直矩形数量（Vertical Count）	用于限制可以使用的单元格数量，以限制在垂直（ Y 轴）方向上可以提取的 Sprite（精灵）数量。属性值为自然数，且属性值不能大于 Sprite（精灵）列表的高度（Y）除以网格高度（Grid Height）属性值的商，属性值 0 时不会施加限制。
水平偏移（Offset X）	设置对整个 Sprite（精灵）列表的水平方向（ X 轴）上设置一个偏移量（以像素为单位）。
垂直偏移（Offset Y）	设置对整个 Sprite（精灵）列表的垂直方向（ Y 轴）上设置一个偏移量（以像素为单位）。
水平间隔（Horizontal Spacing）	设置在水平方向（ X 轴）上的 Sprite（精灵）提取单元格之间添加间距（以像素为单位）。
垂直间隔（Vertical Spacing）	设置在垂直方向（ Y 轴）上的 Sprite（精灵）提取单元格之间添加间距（以像素为单位）。
轴心点位置（Pivot）	Sprite（精灵）局部坐标系在图片纹理中的起始位置，比如将 Sprite（精灵）渲染在场景中游戏对象（Game Object）位于图片纹理的位置。您可以选择预设选项之一，或选择自定义（Custom）以设置特殊的 X 和 Y 轴位置。
自定义（Custom）	设置轴心的自定义位置，属性的 X 和 Y 属性值为 0.0 (0%) 对应于该 Sprite（精灵）引用的图片纹理的左侧或底部，0.5 (50%) 对应于几何中心，1.0 (100%) 对应于右侧或顶部。
此属性仅在轴心点位置（Pivot）属性值设置为自定义（Custom）时可查看和编辑。
导出（Export）
全选（Select All）	全选提取单元格或全不选提取单元格的快捷键。勾选，在勾选的那一刻 Sprite（精灵）提取画布上所有提取单元格都处于选中状态。不勾选，在不勾选的那一刻 Sprite（精灵）提取画布上所有提取单元格都处于取消选中状态。但是在全选状态下手动在提取画布上取消选中部分提取单元格，此属性值会默认跳转为不勾选（Flase）。
忽略空白图（Ignore Blank Image）	自动选取所有非空白提取单元格的快捷键，空白的提取单元格指的是提取单元格内所有像素点透明度（Alpha 值）都为 0。勾选，在勾选的那一刻 Sprite（精灵）提取画布上所有非空白提取单元格都处于选中状态。不勾选，在此属性处于勾选状态切换为不勾选的那一刻， Sprite（精灵）提取画布上所有提取单元格都处于选中状态。但是在属性处于勾选状态下手动在提取画布上取消选中部分提取单元格，或选中 SandMod 认为是空白的提取单元格，此属性值会默认跳转为不勾选（Flase）。
导出序列（Export Create Squence）	提取 Sprite（精灵）的同时是否将提取的 Sprite（精灵）整合并导出为一个新的精灵序列（Sprite Sequence）。勾选，提取时将提取 Sprite（精灵）以及创建由这些 Sprite（精灵）组成的精灵序列（Sprite Sequence）。不勾选，提取时将只提取 Sprite（精灵）。

在网格提取模式下，您可以在 Sprite（精灵）提取画布中选择需要提取分割为 Sprite（精灵）的提取单元格，被选中的提取单元格中的图片纹理将会被提取为 Sprite（精灵）。其中 Sprite（精灵）提取单元格边框出现绿色描边表示已被选中，再次点击该提取单元格至没有绿色描边可以取消选中。

【Extract_Sprite009.png】	【Extract_Sprite010.png】
Sprite（精灵）提取单元格为选中状态	Sprite（精灵）提取单元格为非选中状态

自定义提取模式

提取精灵模式（Extract Sprite Type）属性设置为自定义（Custom）模式后，您可以在 Sprite（精灵）提取窗口左侧的 Sprite（精灵）提取画布中，自定义每个 Sprite（精灵）提取单元格的位置和尺寸。

【Extract_Sprite011.png】

提取单元格的创建

在 Sprite（精灵）提取画布中，除 Sprite（精灵）提取单元格区域外的位置，长按鼠标左键并拖动，即可在 Sprite（精灵）提取画布中创建 Sprite（精灵）提取单元格。

【Extract_Sprite012.gif】

提取单元格的移动

在 Sprite（精灵）提取单元格区域内的位置，长按鼠标左键并拖动，即可调整 Sprite（精灵）提取单元格的位置。

【Extract_Sprite013.gif】

提取单元格的缩放

鼠标左键点击 Sprite（精灵）提取单元格区域内的位置，Sprite（精灵）提取单元格将处于选中状态，此时 Sprite（精灵）提取单元格边框将会显示为绿色，且会显示 8 个方向的红色圆圈控制柄，长按鼠标左键拖动任一控制柄，即可在特定方向上对 Sprite（精灵）提取单元格进行缩放。

【Extract_Sprite014.gif】

提取单元格的删除

鼠标左键点击 Sprite（精灵）提取单元格区域内的位置，Sprite（精灵）提取单元格将处于选中状态，此时键盘点击 Del 按钮将删除选中的提取单元格。

【Extract_Sprite015.gif】