Spine のメッシュは、画像に頂点を置いて、ボーンの動きに合わせて画像を曲げたりゆがめたりできるようにする仕組みです。
作り方は「画像をメッシュに変える」「頂点を置く」「ウェイトでボーンに結び付ける」の3段階です。
- メッシュにする:ツリーのプロパティで「Mesh(メッシュ)」にチェック →「Edit Mesh(メッシュ編集)」
- 頂点を置く:「Trace(トレース)」で外周を自動で作り、「Generate(生成)」で内側に頂点を足す
- ウェイトを付ける:ウェイトビューで「Bind(バインド)」→ ボーンを選ぶ →「Auto(自動)」
- 整える:「Smooth(スムーズ)」でならし、「Prune(削減)」で小さなウェイトを消す
メッシュは Spine Professional だけの機能で、Spine Essential では使えません。
ウェイトは各頂点に対するボーンの影響度で、リージョンアタッチメントは頂点を持たない普通の画像のことです。
ボタン名は英語の画面表記で書き、公式の日本語ガイドの訳を( )で添えます。
内容は2026年11月20日に公式の日本語ガイド(メッシュアタッチメント・ウェイトビュー)で確かめたもので、Spine 4.3(変更履歴によると最新の安定版は2026年9月7日の4.3.26)を前提にしています。
この記事の手順は資料にもとづくもので、Spine の実機で操作した結果ではありません。
メッシュを作る
- 画像のリージョンアタッチメントを選ぶ
- ツリーのプロパティで「Mesh(メッシュ)」にチェックを入れる
- 「Edit Mesh(メッシュ編集)」を押して編集モードに入る
メッシュにした直後は、四隅の4つの頂点だけです。
Mesh のチェックを外すと、普通のリージョンアタッチメントに戻ります。
編集モードは、もう一度 Edit Mesh を押すか、スペースキーか Esc で抜けられます。
外周を作る(Trace)
「Trace」は、画像の透明でない部分の輪郭から、外周の頂点を自動で置きます。
公式ガイドは、何度か作り直して、合う外周を選ぶ使い方を勧めています。
実行すると既存ウェイトとデフォームキーが削除されるため、作成済みデータでは先に複製を保存します。
| Trace の設定 | 働き |
|---|---|
| Detail(詳細) | 頂点の数 |
| Concavity(凹面) | へこんだ部分に頂点を置く優先度 |
| Refinement(改良) | 形を整えるためにかける手間 |
| Alpha threshold(アルファしきい値) | この値より薄い画素は無視する |
| Padding(パディング) | 画像と外周の間のすき間 |
| Refresh(更新) | 同じ設定で外周を作り直す。毎回少しずつ違う形になる |
内側に頂点を足す(Generate)
「Generate」は、変形に効く位置に頂点を足します。
既存頂点の位置を保ったまま追加できます。
ただし公式ガイドでは、GenerateとTraceは既存ウェイトとデフォームキーを削除すると説明されています。
バインドやアニメーションを作った後に実行する場合は、先にコピーを保存してください。
公式ガイドは、関節など大事な場所だけ手で頂点を置き、残りを Generate で埋める使い方を紹介しています。
編集モードの道具
| 道具 | 働き |
|---|---|
| Modify(変更) | 今ある頂点を動かす。ダブルクリックで頂点を消す |
| Create(作成) | クリックで頂点を足す・ドラッグで辺を足す |
| Delete(削除) | クリックで頂点や辺を消す |
| New(新規) | すべての頂点を消し、クリックで外周を描き直す |
| Reset(リセット、編集モード内) | 四隅の4頂点へ戻し、既存ウェイトとデフォームキーも削除する |
右クリックで、Modify・Create・Delete を切り替えられます。
外周の辺は水色、自分で引いた内側の辺はオレンジ、自動で計算される辺は灰色の破線(「Triangles(三角形)」をオンにすると見える)で表示されます。
辺を足して曲がり方を決める
頂点を動かすと、その頂点を含む三角形だけが変形します。
公式ガイドの例では、鼻を伸ばすと頬まで伸びてしまうので、鼻の付け根と下に頂点を足しています。
さらに Create ツールで頂点の間をドラッグして辺(オレンジ)を引き、鼻だけが変形するようにしています。
自動の辺(灰色)は手で引いた辺と交わらないので、頂点のつながり方を自分で決められます。
どこに辺が要るかは、「Triangles」にチェックして三角形の分かれ方を見ると判断しやすくなります。
頂点は少なめに
公式ガイドは、頂点は1つごとに毎フレーム計算がかかるので、数を最小限にするよう勧めています。
ウェイトがあると、影響するボーンの数だけ計算が増え、100頂点に2本のボーンなら200回の計算になると説明されています。
余白は外周の外に出す
外周より外の画素は描かれないので、透明な余白の多い画像ほど描画の負担を減らせます。
メッシュはへこませることはできますが、穴は開けられません。
穴が要るときは画像のその部分を透明にし、大きな穴なら2つのメッシュに分けます。
画像のサイズを変えたときの注意
Spine の外で画像を拡大・縮小すると、Spine はテクスチャ座標を合わせて直すかを尋ねます。
画像の周りに余白を足しただけなら「Yes(はい)」を選び、絵の大きさを保ちます。
余白を四辺に均等に足していないときは、編集モードで頂点を手で合わせ直します。
絵そのものを拡大・縮小したときは「No(いいえ)」を選ぶと、メッシュは変わりません。
ウェイトを付ける
- Weights ビューを開き、メッシュを選ぶ
- 「Bind(バインド)」を押して、結び付けるボーンをクリックする
- 「Bind」をもう一度押す(スペースキーか Esc でも抜けられる)
初めて結んだときは、ウェイトが自動で計算されます。
Bind は、メッシュを先に選んでも、ボーンを先に選んでもかまいません。
Weights ビューのボタン
| ボタン | 働き |
|---|---|
| Auto(自動) | ウェイトを計算し直す。頂点やボーンを選んでいれば、その分だけやり直す |
| Smooth(スムーズ) | 外周辺や手動の内側辺でつながる隣接頂点と平均する。未選択なら全頂点が対象 |
| Prune(削減) | 小さいウェイトを消す。Bones で1頂点あたりの最大本数、Threshold で消す値を決める |
| Weld | メッシュ間のウェイトをそろえる。対象同士が共通の2本以上のボーンへBindされていることが条件 |
| Swap | 一覧で選んだ2本のボーンのウェイトを入れ替える |
| Lock | ほかのボーンを直しても、そのボーンのウェイトを変えない。ボーン名の横の色の四角にカーソルを合わせ、出てくる錠前の印を押す |
| Update Bindings(バインディングをアップデート) | 今の頂点の位置で、ボーンに結び直す |
Auto は、頂点とボーンの単純な距離ではなく、メッシュの形を考えて重みを付けます。
手で直したウェイトを残したまま一部だけやり直したいときは、その頂点だけ選んで Auto を押します。
ボーン一覧にも選択が残っている場合は、そのボーンだけがAutoの計算対象になります。
意図せず一部しか変わらない場合は、頂点とボーンの両方の選択状態を確認してください。
Update bindings が要るとき
結んだあとにボーンを動かし、その状態でウェイトを直すと、頂点がずれることがあります。
現在の形を保ったままウェイトを調整したい場合は、Update bindingsで現在位置を新しいバインド位置にできます。
古いバインド位置は置き換わるため、意図した変形まで変わらないかコピーでポーズを比較してください。
ブラシで塗る
Weights tool で、頂点のウェイトを直接決めたり、ブラシで塗ったりできます。
| モード | 働き |
|---|---|
| Direct(ダイレクト) | 上下のドラッグか Weight のスライダーで、値を正確に決める |
| ブラシの Add(追加) | 選んだボーンのウェイトを足す |
| ブラシの Remove(取り除く) | 選んだボーンのウェイトを引く |
| ブラシの Replace(置換) | 決めた値にする |
ブラシの設定は、Strength(強度:与える最大のウェイト)、Size(サイズ)、Feather(フェザー:ウェイトが弱まっていく範囲)です。
ウェイトの割合は、「Pies(円)」で頂点ごとの円グラフ、「Overlay(オーバーレイ)」でボーンの色の塗り分けとして確かめられます。
ブラシを使う前に、影響度を変更するボーンを選びます。
頂点を選択していればブラシはその頂点だけに作用し、未選択なら全頂点が対象です。
ウェイトの合計は100%に調整され、あるボーンを増やすと他のボーンの分が減ります。
1本のボーンが100%を持つ頂点では、そのボーンの値を引くだけでは減らせません。
別のバインド済みボーンを選んで影響度を足し、割合が分配されるかを確認します。
デフォームキーは控えめに
メッシュの頂点の位置は、アニメーションのキー(デフォームキー)にもできます。
ただし公式は、変形はほぼウェイトで行い、デフォームキーは避けるか最小限にするよう勧めています。
メッシュを使い回す・まとめて動かす
同じメッシュを別の画像で使う(リンクメッシュ)
旗のように、同じ形と動きを別の画像で使い回したいときはリンクメッシュを使います。
メッシュのツリープロパティで「New…(新規…)」→「Linked Mesh(リンクメッシュ)」を押します。
頂点・辺・テクスチャ座標・ウェイトは元のメッシュと共有され、元を直すとリンク先にも反映されます。
「Inherit Deform(変形を継承)」にチェックがあると、元のメッシュのデフォームキーもリンク先に効きます。
リンクメッシュは、元のメッシュと同じスロットの下に置く必要があります。
頂点をなめらかにまとめて動かす(ソフト選択)
メッシュツールビューを使うと、選んだ頂点の周りの頂点も、離れるほど弱く一緒に動きます。
- Size(サイズ):一緒に動く範囲
- Feather(フェザー):範囲のうち、だんだん弱まっていく部分の割合
- Hull vertices(ハル頂点):オフにすると、外周の頂点は動かさない
ソフト選択は、ウェイトビューでウェイトを直すときにも効きます。
Spine の最初の設定は、Spineの使い方で紹介しています。
2本のボーンで曲がり方を比較する
下の練習ZIPには、自作の透明背景画像mesh-practice-input.png(320×160)を入れています。
左側が青、右側が橙の帯で、画像の中央を関節の位置として使います。
これはSpineの出力画面ではなく練習用の入力データです。
元プロジェクトを複製し、画像を中央に置きます。
左側の中央から画像中央へ親ボーン、中央から右側の中央へ子ボーンを作ります。
メッシュは四隅に加え、中央の関節付近の上端・下端にも頂点を置き、2本へBindします。
練習用のアニメーションでAnimateモードへ切り替え、Auto Keyをオフにします。
子ボーンを曲げ、左端・関節・右端の動きを比較してください。
未キーの試し曲げは、タイムライン上をクリックすると元のポーズへ戻ります。
既存のアニメーションにキーがある場合は、その時刻のポーズが反映されるので、キーのない練習用データで試します。
まずAutoの結果を保存し、関節付近の頂点だけを選んでSmoothを試します。
元のAutoと、調整後の同じ角度を比べます。
うまくいかないときの対処
変形がおかしいときは、次の表の順に確かめます。
| 症状 | 観察するもの | 次の操作 |
|---|---|---|
| 関節で帯が潰れる | 頂点位置と両ボーンのウェイト | 関節周辺の頂点だけを確認 |
| 片側が動かない | Bind対象とPiesの割合 | 意図したボーンの影響を確認 |
| Prune後に形が変わる | プレビューと除去本数 | 適用前の値へ戻して比較 |
| ウェイト変更で頂点がずれる | ボーン移動後のバインド位置 | Update Bindingsが必要な状況かを確認 |
調整を戻すときの違い
Undoで直前の調整を戻すか、保存したAuto時点の複製へ戻します。
Edit Mesh内のResetは四隅へ戻すとともにウェイトとデフォームキーを削除します。
ツリープロパティのResetはUVに合わせて変形を解除する別の操作ですが、こちらもウェイトとデフォームキーを削除します。
どちらも調整のUndoには使いません。
Update bindingsも以前のバインド位置を復元する操作ではありません。
練習ファイルと確認済みの範囲
2本のC#例は参照・名前・待ち時間の異常系をローカルのテストダブルで検査し、4.3のAPI宣言を一次資料で照合しました。
実際のSpine/Unityコンパイル・描画・スキン・書き出し・変形は未検証です。
コードは4.3用です。
練習の完了は、それぞれ本文の表示・再生・復元を実環境で確認して判断します。
まとめ
- 「Mesh(メッシュ)」にチェック →「Edit Mesh(メッシュ編集)」でメッシュを編集する
- Trace で外周、Generate で内側の頂点。頂点は少なめに
- Weights ビューの Bind でボーンと結び、Auto で計算する
- Smooth・Prune・Update Bindings で整え、使い回すならリンクメッシュにする
次にやること:メッシュを動かすアニメーションができたら、Spineの書き出し(JSON・バイナリ・アトラス)でゲーム用のデータにします。
Unity で再生するなら、SpineをUnityで動かす方法に進んでください。
足を地面に固定したいときは、Spineの2本IKを組み合わせます。
参考:Esoteric Software の公式ガイド(日本語版)メッシュアタッチメント、ウェイトビュー、メッシュツールビュー(2026年11月20日確認)。
Weld・Swap・Lock は日本語版のウェイトビューに載っていないため(2026年11月20日に見直しても未掲載)、英語版の Weights view の記載をもとに、ボタン名を英語のまま書いています。
Spine の実機で変形・キー・Undo は再現していません。
