SpineUnpacker一款专为 Spine 骨骼动画开发者和游戏美术师设计的 Atlas 大图解包工具  Spine Atlas 解包工具
SpineUnpacker 是一款专为 Spine 骨骼动画开发者和游戏美术师设计的 **Atlas 大图解包工具**。

 

Spine 软件在导出动画资产时，会将所有散图打包为一张或多张大图（Atlas），并配套生成 `.atlas` 元数据文件。SpineUnpacker 能精确解析此格式，将每个精灵区域从大图中提取为独立 PNG 小图，**完全还原原始图片的透明通道、尺寸和偏移信息**。

无论您是需要修改现有动画资源、替换部分精灵图片，还是研究商业游戏的动画结构，SpineUnpacker 都能帮您轻松完成。
## 核心功能

### 1. 标准 Spine Atlas 格式解包

- 完整支持 **Spine 3.x / 4.x** 标准 `.atlas` 格式
- 精确解析精灵坐标（xy）、尺寸（size）、原始尺寸（orig）、偏移（offset）等所有字段
- 自动还原旋转精灵（`rotate: true`）—— 逆时针旋转90°还原到原始方向
- 完整支持 Spine 的**下左坐标系（bottom-left origin）offset** 还原

 

### 2. 精确偏移还原

- 精灵放置在正确偏移位置，透明边距完整保留
- 输出图片尺寸 = `orig` 原始尺寸，确保在游戏引擎中渲染位置完全正确
- 无需手动调整，解包即可用

### 3. 子目录结构保留

- 精灵名含路径分隔符（如 `111/body`）时自动创建对应子目录
- 输出结构与精灵命名完全对应，方便管理大量精灵

### 4. 帧动画支持

- 自动识别 `index` 字段
- 对动画帧文件名自动添加帧序号后缀（如 `run_0000.png`、`run_0001.png`）
- 完整保留帧序列信息

### 5. 单文件模式

- 指定单个 `.atlas` + `.png` 进行解包
- 支持**拖拽** `.atlas` 文件到程序窗口，自动填充路径
- 自动推断配套 `.png` 路径（同名同目录）
- 同步复制同名 `.json` 骨骼数据文件到输出目录

### 6. 批量目录模式

- 递归扫描目录，一次性解包所有 `.atlas` 文件
- 每个 atlas 输出到以文件名命名的独立子目录
- 适合大型项目资源批量管理

 

---

## 使用方法

### 单文件模式

1. 选择"单个文件"模式
2. 点击"浏览"选择 `.atlas` 文件（自动填充 PNG 路径）
3. 设置输出目录
4. 点击"开始解包"

> 也可以直接将 `.atlas` 文件拖拽到程序窗口，路径会自动填充。

### 批量模式

1. 选择"批量解包"模式
2. 选择包含 `.atlas` 文件的目录
3. 设置输出目录
4. 点击"开始解包"

---

## 输入输出格式

| 格式 | 说明 |
|------|------|
| 输入 `.atlas` | Spine 3.x/4.x 标准 atlas 描述文件 |
| 输入 `.png` | Atlas 大图（RGBA8888 透明通道） |
| 输出 `.png` | 透明通道完整的独立精灵图片 |

---

## 解包原理

Spine atlas 格式示例：

```
player.png
size: 977,520
format: RGBA8888
filter: Linear,Linear
repeat: none
body
  rotate: false
  xy: 2, 2
  size: 64, 64
  orig: 80, 80
  offset: 8, 8
  index: -1
head
  rotate: true
  xy: 919, 274
  size: 50, 40
  orig: 60, 60
  offset: 5, 10
  index: -1
```

SpineUnpacker 的处理流程：

1. **解析** `.atlas` 文件，获取每个精灵的位置、尺寸、偏移等元数据
2. **裁剪** 从大图 PNG 中按 `xy` + `size` 裁剪出精灵区域
3. **旋转还原** 若 `rotate: true`，将裁剪图顺时针旋转90°还原
4. **偏移还原** 创建 `orig` 大小的透明画布，将还原图放置到正确偏移位置
5. **保存** 输出为含透明通道的 PNG 文件

---

## 配合 SpineRepacker 使用

SpineUnpacker 与 SpineRepacker 构成完整的工作流：

```
原始 atlas (player.atlas + player.png)
        ↓ SpineUnpacker 解包
    独立 PNG 散图（含子目录结构）
        ↓ 修改/替换部分图片
    修改后的 PNG 散图
        ↓ SpineRepacker 重新打包
    新的 atlas (player.atlas + player.png)
        ↓ 导入 Spine / 游戏引擎
```

---

## 适用人群

| 人群 | 使用场景 |
|------|---------|
| 游戏美术师 | 提取精灵进行修改替换，再重新打包 |
| 独立游戏开发者 | 提取现有游戏资源做参考或二次创作 |
| 外包工作室 | 处理来自客户的 Spine 资源文件 |
| 游戏学习者 | 研究商业游戏的动画资源结构 |
| Mod 制作者 | 解包游戏资源进行 Mod 制作 |

---

## 系统要求

- **操作系统**: Windows 7 / 8 / 10 / 11（64位）
- **运行库**: 无需安装额外运行库
- **内存**: 建议 512MB 以上（处理超大图集时需要更多）

---

## 常见问题

**Q: 解包后的图片位置不对？**
A: 检查 `.atlas` 文件是否包含完整的 `orig` 和 `offset` 字段。某些低版本 Spine 导出可能省略这些字段。

**Q: 支持多 page 的 atlas 吗？**
A: 当前版本每个 `.atlas` 文件处理其关联的第一张 PNG，多 page atlas 请将每个 `.atlas` 单独解包。

**Q: 解包后的图片在 Spine 中还能用吗？**
A: 可以。配合 SpineRepacker 可以将散图重新打包为标准 Spine atlas 格式，完美兼容。

**Q: 旋转的精灵解包后方向正确吗？**
A: 完全正确。工具自动检测 `rotate: true` 标记并执行顺时针90°旋转还原，输出与原始图片方向一致。


 

百度网盘下载：
链接: 百度网盘 请输入提取码 提取码: 2t5f

蓝奏云下载地址：
https://net188.lanzout.com/b009huurrc 密码:fp8k