Persona

レイヤーを選んで「ピン留め」を開くと、モデルに取り付けられます。使えるアンカーは、親モデルと子レイヤーによって異なります。

オブジェクトをモデルにピン留めするアンカーリンクをコピー

ピン留め機能を使用すると、マルチメディアオブジェクトをキャラクターモデルにアタッチし、アバターの動きに追従させることができます（顔の眼鏡、手に持った小道具、頭上のネームプレートなど）。ピン留めを行うと、オブジェクトの空間座標はグローバルなステージ原点からではなく、アタッチ先アンカーからの相対オフセット値として扱われます。Live2Dモデルも同様の仕組みで別のLive2Dモデルにアタッチでき、Live2Dアイテムとして動作します。

オブジェクトは同一のレンダリング空間体系に属するモデルにのみピン留めできます（2DオブジェクトはLive2Dモデルへ、3DオブジェクトはVRMモデルへ）。この制約は座標系とアンカー階層構造によるものであり、レンダラーの実装制限ではありません。異なる空間を跨ぐピン留めには、統一された深度テスト基準や空間変換行列が存在しないためです。

アンカーの選択には2つの方法があります。アンカードロップダウンリストから検索して選択するか、ステージ上で選択をクリックしてステージビューポート内の目的の表面を直接クリックします（選択待機中はボタンが選択をキャンセルに変化します）。両モデルのリストともにモデル全体の座標系を表すモデルルートが含まれており、上部の検索バーにより多数のボーンやアートメッシュの中から目的の要素を迅速に検索できます。

リスト上でアンカーにホバーするかステージ上で選択する際、対象のメッシュまたはボーンが緑と白の交互のアウトラインでハイライト表示されます。配信モードではこのデバッグハイライトは自動的に非表示となります。

2Dピン留めアンカーリンクをコピー

ステージ上で選択したアンカーは、モデルメッシュ上の特定の三角ポリゴンに対応します。Personaは対象のアートメッシュIDと正確な重心座標を記録するため、アタッチされたアイテムはメッシュの変形に滑らかに追従し、モデル上に不自然に浮遊することがありません（VTube Studioのアイテムシステムと同様の仕様）。ドロップダウンリストにはモデル内の全アートメッシュが網羅されているため名前による完全一致指定に適しており、可視表面への素早い配置にはステージ上での直接クリックが適しています。

倍率はモデルのParamAngleZ（頭の傾き）を参照し、視差Xおよび視差YはParamAngleXとParamAngleY（頭の左右旋回および上下傾斜）を参照します。ピクセル数値はモデルの1×スケールを基準としており、モデル全体の拡縮に比例してスケーリングされます。正の値を設定すると頭部と同じ方向へオフセットし、メッシュ手前に浮遊しているような立体感が生まれます。負の値を設定すると逆方向へオフセットし、メッシュ背後にあるように見えます。眼鏡にわずかな正の視差を設定することで横を向いた際にフレームの厚みを自然に表現でき、ネームプレートに負の視差を設定することで常に頭部の背後に安定して配置できます。

Live2Dモデルにアタッチされた2D画像、動画、およびウェブレイヤーも、モデル内部のパーツレイヤー間に割り込んで描画可能です（object-pin-depth機能に依存）。ピン留めを設定すると、下部に深度スライダーが表示され（後述のLive2Dアイテムと同様の操作）、ホストモデルの特定のArtMeshの間にオブジェクトを挿入できます。同じ深度に複数のオブジェクトがピン留めされている場合は、グローバルレイヤーリストでの相対的な重なり順序が維持されます。レイヤー一覧内のピン留めされたメディア行にもピンアイコンが表示されます。

Live2Dアイテムアンカーリンクをコピー

Live2Dモデルを別のLive2Dモデルへアイテムとして丸ごとアタッチできます（VTube StudioのLive2Dアイテム機能に準拠）。モデルを選択すると位置セクションの下部にピン留め設定エリアが現れ、設定項目は2Dピン留めと同一です。アイテムとして読み込まれた状態でも、独立したフェイストラッキング、待機呼吸、表情、レイヤーエフェクトなどモデル本来の全機能を維持します。モデルドロップダウンにはシーン内の他の全Live2Dモデルが一覧表示されます。すでに現在のモデルへ直接または間接的にアタッチされているモデルは、循環参照を防ぐためグレーアウトされこれに追従中と表示されます。

通常のオブジェクトとは異なり、Live2Dアイテムはホストモデルのレンダリングパイプライン内部に直接組み込まれて描画されます。深さスライダーはホストモデルの描画順序全体にまたがっており、一端がモデルの後ろ、もう一端が前面に対応し、各アートメッシュ間にスナップ位置が設けられています。ラベル下のステータス表示には、ホストモデルの何枚のパーツによって遮蔽され、どのアートメッシュの直上に位置しているかが明示されます。スライダー操作中、ホストモデルはキャンバス上で一時的にパーツを着色ハイライトします（アイテムを遮蔽するパーツはオレンジ色、アイテムによって遮蔽されるパーツは青色）。調整を止めて約1秒後にハイライトは自然にフェードアウトします。この着色はモデル表面に直接合成されるため、キャプチャ映像にもそのまま反映されます（配信モードでも非表示にはなりません）。

ピン留めシステムは静的なレイヤー番号ではなくアートメッシュ固有のIDを記録します。Cubismエンジンはモーション再生時に描画順を動的に並べ替えるため、アイテムは毎フレームのリアルタイムな描画順序に正確に追従します。存在しないIDが検出された場合（ホストモデル差し替え時など）、アイテムは自動的に最前面へ安全にフォールバックし、深さパネルに警告が表示されます。

モデルを挟むスイッチを有効にすると、アイテムを前後に分割し、深さスライダー上に2つ目の制御つまみが追加されます。下側のつまみで後半分の深さ、上側のつまみで前半分の深さを制御し、その間に挟まれたホストモデルのパーツが後半分を遮蔽しながら前半分に遮蔽されます（マフラーの前側が胸元に垂れ、後ろ側が首元を通って髪の毛の後ろへ回り込むような表現が可能です）。分割位置ドロップダウンでアイテム自身のどのパーツで分割するかを指定し、そのパーツより下に描画される部分が後ろ半分となります。選択をクリックすると、ステージビューポート上のクリックによって分割境界を指定できます（入力待機中はボタンがキャンセルに変化します）。本機能を有効にした際、境界はIDにsplitを含むアートメッシュへ自動スナップし、非該当時は中央で等分割されます。後半分の初期深さは前半分よりホストモデルの総パーツ数の4分の1だけ自動的に背後へオフセットされます。

深さがピン留めシステムによって制御されている場合、グローバルレイヤーリストは相対深度に干渉しません。アイテムはホストモデルがリスト内で占める階層スロット内に描画されるため、ホストモデルより上位のレイヤーは、アイテム行がリストのどこにあっても常にアイテムを遮蔽します。レイヤーリストは同一アートメッシュ上にピン留めされた複数のアイテム同士の前後順序のみを決定します。アイテム行にはピン留めを示すピンマークが表示されます。

ホストモデルが1枚のフラットテクスチャとしてレンダリングされる場合（単体レイヤーエフェクト適用中、クロスフェード遷移中、またはオフスクリーンレンダリングを使用するmoc3 v6モデルなど）、内部レイヤーへの割り込みが不可能なため、アイテムはモデルの最前面にまとめて描画されます。

3Dピン留めアンカーリンクをコピー

3DアンカーはVRMの人型骨格ボーン（head、leftHand、hipsなど）またはモデルルートに対応します。ステージ上で選択する際、Personaはアバターへレイキャストを照射し、交差したメッシュポリゴンのスキニングウェイトを読み取って最もウェイトの高いボーンへ自動的に解決します（顔をクリックするとhead、手をクリックするとleftHandが選択されます）。

弾性物理演算を有効にすると仮想的なスプリングダンパーが適用され、小道具がアンカーの運動に追従して慣性的な揺れや跳ね返りを生み出します：

アタッチ先の親モデルがシーンから削除されるか別形式のモデルへ差し替えられた場合、ピン留め関係は安全に解除され、オブジェクトは削除されずに現在のステージ座標へ独立して留まります。