mcpField
I
inspect-glb

inspect-glb

github.com/playcanvas開発31319 回インストール1 週間前に更新
リポジトリ

inspect-glb について

inspect-glbは、変換やアニメーションを設定する前にGLBモデルを調べる開発スキルです。境界情報やシーンのメタデータを示し、実行時確認が必要な測定値も明記します。

主な機能

  1. 01寸法、中心、接地オフセットの確認
  2. 02境界の取得元とポーズの報告
  3. 03ノード、クリップ、ジョイント、アニメーション対象の一覧
  4. 04実行時確認が必要なケースの表示

活用シーン

  1. 01モデルのスケールとピボットオフセットの決定
  2. 02アニメーション名と対象の特定
  3. 03調査した境界に基づく静的モデルの配置

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/playcanvas/skills --skill inspect-glb

インストール後、Claude Code で/inspect-glbを入力して読み込まれたか確認します。

同梱ファイルscripts/inspect.mjs

詳細

GLB を検査する

変換やアニメーション名を選ぶ前に、このスキルを基準に scripts/inspect.mjs のパスを解決して実行します。ファイルを絞り込み、アセットパック全体をコンテキストに出力しないでください。

node <skill-directory>/scripts/inspect.mjs public/models/*.glb

出力を読む

  • dims、center、groundOffset は、それぞれ一様スケールの入力値、ピボットオフセット、Y 軸の接地位置を示します。center.x または center.z がゼロでない場合、モデルはルートに配置されていません。
  • boundsSource が vertices の場合に限り、配置時に境界を信頼してください。accessor-minmax は回転したノードを最大 41 パーセント過大評価することがあります。incomplete または null の場合はキャリブレーションしないでください。原因は boundsNotes に示されます。
  • boundsPose の static と default-morph は作成時のポーズです。bind はスキンのレストポーズです。
  • requiresRuntimeCheck は、モーフ、スキン、または部分的なデコードがあることを示します。アプリ内で範囲を確認してください。
  • nodePaths、clips、joints、animationTargets は configure-animation に使用します。

境界だけでは正面の向きを確認できません。実行中のアプリで確認し、ヨー角を calibrate-model に記録してください。実行時の meshInstance.aabb はモーフを考慮して保守的に拡張されるため、静的モデルは検査した境界を基に配置してください。

圧縮ファイル

インスペクターは、プレーン、インターリーブ、量子化、スパース形式のバッファーをデコードします。Draco、Meshopt、または外部バッファーの場合は、ロスレスの作業用コピーを検査してください。追加の変換を適用する optimize は使用しないでください。

npx --yes @gltf-transform/[email protected] copy in.glb scratch.glb

Engine は EXT_meshopt_compression を読み込めません。このようなファイルをリリースする前に load-assets を参照してください。

コメント

Markdown 対応