Skeleton Viewer

Skeleton Viewerは、スケルトンデータをロードして表示することができるツールです。プレビュー(Preview)ビューとよく似ており、SpineからエクスポートしたスケルトンデータがSpineランタイムでどのようにレンダリングされるかをテストするのに役立ちます。

Skeleton Viewerはspine-libgdxランタイムを使用しています。これは他のランタイムのベースとなっているSpineのリファレンスランタイムです。spine-libgdxを使用していない場合でも、ランタイムのスケルトンレンダリングに問題がある場合、Skeleton Viewerは問題がspine-libgdxにあるのか使用しているランタイムにあるのか、あるいはあなたのコードにあるのかを判断する手助けになります。

Skeleton Viewerのソースコードはこちらで公開されています。

Spineから実行する場合

Skeleton Viewerは、以下のように --skeleton-viewer または --sv というコマンドライン パラメーターを使用することで実行できます:

Spineから実行する方法は、Spineランチャーバージョンが 4.1.10以上且つSpineエディターバージョンが4.1.12以上である必要があります。もしこのコマンドラインパラメーターが認識されない場合、Spineエディターバージョンが4.1.12以上であることを確認して、最新のランチャーをSpineライセンスページよりダウンロードしてください。

また、Skeleton Viewerの特定のバージョンを実行したい場合、--update または -u パラメーターを使用してください:

スタンドアロンで実行する場合

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のHistoryを参照し、ソースから実行することができます。

実行

Skeleton Viewerの実行には、Javaバージョン9以上が必要です。すでにJavaがあれば、通常はJARファイルをダブルクリックするだけでSkeleton Viewerを実行できます。そうでない場合は、以下のようにコマンドラインから実行してください。

また、コマンドラインからの実行は、エラーログが出力されている場合にそれを確認することができるという利点があります。

データのロード

Browseボタンは、SpineからエクスポートされたJSONまたはバイナリデータファイルを開くために使用されます。Spineのトライアル版および製品版には、Skeleton Viewerで開くことができるエクスポート例が付属しています。これらはSpineまたはSpine Trialのインストールディレクトリにあります。

Skeleton Viewerは、選択されたデータファイルの隣にある、同じ名前のテクスチャアトラスを探します。例えば、raptor.jsonを開くと、raptor.atlasが検索されます。アトラスが見つからない場合は、画像の代わりに半透明の白い四角形が使用されます。

Skeleton Viewerはデータファイルとアトラスファイルを監視し、外部から変更された場合は自動的に再ロードします。

コマンドラインからSkeleton Viewerを実行する場合、開くスケルトン.jsonまたは.skelを以下のように直接指定することができます:

Skeleton Viewerの使用

選択されたスケルトンが読み込まれ、右側の黒い領域に表示されます。この領域をクリック＆ドラッグすると、スケルトンを移動させることができます。Scale、Flip、Debugの各コントロールを使用すると、スケルトンのさまざまな部分をよりよく視覚化することができます。

画像の縁が暗いなど、正しく表示されない場合は、PremultipliedのチェックボックスをON/OFFしてみてください。チェックすると、そのアトラスが乗算済みアルファ(Premultiplied alpha)を使用して作成されたと仮定してレンダリングするようになります。

Animationのリストで選択されているアニメーションが再生されます。別のアニメーションを選択すると、AnimationStateを使用して新しいアニメーションにクロスフェードします。Mixスライダーはクロスフェードの時間を秒単位で制御します。

Setup Poseボタンは、ボーン、スロット、またはその両方をセットアップポーズにリセットします。これはsetBonesToSetupPose や setSlotsToSetupPose を呼び出すのと同じです。アニメーションがスケルトンに変更を加えると、コードや他のアニメーションがそれを変更するまで、変更が持続します。アニメーションは、キーがあるスケルトンの部分だけに変更を加えるので、結果としてアニメーションが意図せず別のアニメーションに影響を与えてしまうことがあります。詳しくはAnimation changesをご覧ください。