spine-skeleton-viewer

# 总述（Overview）

骨骼动画查看器（Skeleton Viewer）是一个加载和显示骨骼数据的工具。它能用于测试 Spine 导出的骨骼数据在实际运行时的渲染效果。

![](/img/skeleton-viewer.jpg)

Skeleton Viewer 使用 [spine-libgdx](https://github.com/EsotericSoftware/spine-runtimes/tree/master/spine-libgdx) 运行库，这是 Spine 其它运行库的参考基础。即使你不使用 spine-libgdx，如果你想知道如何在其它运行库上渲染一套骨骼，Skeleton Viewer 也可以帮你搞清楚问题是出在 spine-libgdx 上，还是你使用的运行库上，还是你自已的代码上。

Skeleton Viewer 的源码可以在 [here](https://github.com/EsotericSoftware/spine-runtimes/blob/master/spine-libgdx/test/com/esotericsoftware/spine/SkeletonViewer.java) 查看。

# 运行骨骼动画查看器（Running Skeleton Viewer）

Skeleton Viewer 是一个 JAR 文件，可以从这里下载：

[Skeleton Viewer 下载](/files/skeletonViewer.jar)

[Java](http://www.java.com/) 应该在运行此工具前安装。如果你已经装了 Java，那么通常双击 skeletonViewer.jar 就可以了。如果不行，那么像下面这样用命令行方式来运行：

```
java -jar skeletonViewer.jar
```

通过命令行来运行的好处就在于，如果出错，你就能到它输出的错误提示。

# 加载数据（Loading data）

`Browse` 按钮用于打开一个 Spine 导出的 JSON 或 二进制 数据文件。无论完整版还是试用版的 Spine 在示例中都带了导出好的数据，你可以用 Skeleton Viewer 打开。在 Spine 或 Spine Trial 的安装目录下可以找到它们。

Skeleton Viewer 会在选中的 JSON 边上查找同名的 atlas 文件。例如，如果打开 `raptor.json`，它就会查找 `raptor.atlas`。如果找不到 atlas,就会用白色半透明方框代替图片。

Skeleton Viewer 会监视 JSON 和 atlas 文件，如果文件被外部程序修改，它会自动重新加载。

# 使用骨骼动画查看器（Using Skeleton Viewer）

被选中的骨架加截并显示在右边的黑色区域。点击并拖拽可以移动骨骼。缩放`Scale`, 翻转`Flip` 和 调试`Debug`用于更好地显示骨架的各个部分。

如果图片有脏边或其它什么显示异常的情况，请尝试勾选或取消 `Premultiplied`。如果勾选后渲染正常，那导出 atlas 时应该使用 premultiplied alpha 设置。

在 `Animation` 列表中选中的动画会被播放。当选中不同的动画时将使用[AnimationState](http://esotericsoftware.com/spine-using-runtimes#AnimationState) 过度到新的动画。`Mix` 滑动条控制混合动画的时间长度。

`Setup Pose` 按钮可以将骨骼（bones）、资源槽（slots）或两者重置为装配动作（setup pose）。它与调用`setBonesToSetupPose` 或 `setSlotsToSetupPose` 是一样的。当一个动画改变了某个骨骼后，此变动将一直持续到下一次你用代码或另一个动画改动它。由于动画只修改的骨架具有关键帧的部分，其结果可能会无意中影响到另一个动画。解决方案看这里[Animation changes](http://esotericsoftware.com/spine-using-runtimes/#Animation-changes)。