Skeleton Viewer

Skeleton Viewer是一个可以加载和显示skeleton数据的工具。它与Preview视图非常相似,对于测试从Spine导出的skeleton数据是如何使用Spine Runtime进行渲染的非常有用.

Skeleton Viewer 使用spine-libgdx运行时,它是Spine的参考运行时,其他运行时都基于此。如果你在使用运行时渲染骨架时遇到问题,那么Skeleton Viewer也可以帮助你确定问题出在spine-libgdx, 或是使用的其他运行时,还是你的代码中——即使你没有使用spine-libgdx.

Skeleton Viewer的源代码可在此处查阅.

下载

Skeleton Viewer可以在这里以JAR文件的形式下载:

Skeleton Viewer 4.2.00
Skeleton Viewer 4.1.24
Skeleton Viewer 4.0.64
Skeleton Viewer 3.8.99
Skeleton Viewer 3.7.94
Skeleton Viewer 3.6.53
Skeleton Viewer 3.5.51
Skeleton Viewer 2.1.27

请选择与你导出数据所用的Spine编辑器版本相一致的版本。如果你需要旧版本的Skeleton Viewer,请浏览Git历史记录来下载源代码并通过源代码来运行它.

运行

运行Skeleton Viewer需要Java 版本为 9+. 当你准备好了Java运行环境, 双击JAR文件即可运行Skeleton Viewer。如果无法启动,也可以像这样通过命令行来执行:

java -jar skeletonViewer.jar

从命令行运行的好处是你可以看到输出的全部错误日志.

加载数据

Browse按钮用于打开从Spine导出的JSON或二进制数据文件。Spine的试用版和完整版都附有Skeleton Viewer可查看的导出示例文件。这些文件可以在Spine完整版或Spine试用版的安装目录中找到.

Skeleton Viewer会在选定的数据文件旁边寻找具有同名的texture atlas。例如,如果打开了raptor.json,它将寻找raptor.atlas。如果没有找到atlas,Skeleton Viewer将使用半透明的白色方块来显示代替图像.

Skeleton Viewer监控数据和atlas文件,若它们经历了外部修改,Skeleton Viewer将自动重加载它们.

如果你从命令行启动Skeleton Viewer,则可以在打开时直接指定skeleton的.json.skel:

java -jar skeletonViewer.jar path\to\skeleton.json

使用Skeleton Viewer

选中的skeleton被加载并显示在右边的黑色区域。在这个区域点击和拖动可以移动skeleton。可以用Scale, FlipDebug来更好地观察研究skeleton的不同部分.

如果图像有黑边或其他显示错误,可以尝试勾选或取消勾选Premultiplied。勾选后,渲染将默认atlas用了premultiplied alpha.

Animation列表中选择的动画将被直接播放。选择不同的动画将使用AnimationState来交叉淡出(cross fade)到新动画。Mix滑块控制交叉淡出的时长,单位为秒.

Setup Pose按钮将把骨骼和槽位重置为到setup pose。这与调用setBonesToSetupPosesetSlotsToSetupPose效果相同。当一个动画对一个skeleton进行改变时,这些改变会保持到你的代码或另一个动画改变它们。由于一个动画只对skeleton中某些它key过的部件进行修改,结果可能会导致一个动画无意中影响另一个动画。更多信息请参见文档Animation changes.