サンプル

Skeleton.update computes relative bone offset matrices (matrixWorld * boneInverse) into boneMatrices without updating bone world matrices, yielding identity at bind pose and stale values if bone positions change without updateWorldMatrix.

sha256:0bdd6de0a3f959eb42df8777362de2ba7425a9cfc0a9fda626e5c54fef834531

ケース

ゴール

Skeleton.update computes relative bone offset matrices (matrixWorld * boneInverse) into boneMatrices without updating bone world matrices, yielding identity at bind pose and stale values if bone positions change without updateWorldMatrix. HOW

パッケージ

three 0.185.1

環境

node

作成日

2026-08-17T09:15:35Z

よくある思い込み

Skeleton.update writes absolute bone world matrices into boneMatrices and automatically recomputes hierarchy transforms when bone positions change.

このサンプルの作者が、ここで開発者やモデルが期待するであろうこととして記録したもの。下の契約が実際に実行されたものだ。

コントラクト

• Skeleton.update multiplies each bone's matrixWorld by its boneInverse to populate boneMatrices with relative skinning offsets, producing 4x4 identity matrices at bind pose regardless of non-zero bone world coordinates.
• Skeleton.update reads bone.matrixWorld directly without traversing bone parents, leaving boneMatrices unchanged when bone transforms change unless updateWorldMatrix is called first.
• Calling Skeleton.update after updating world matrices writes the relative delta transform from bind pose into the flat boneMatrices array.
• Skeleton.update sets boneTexture.needsUpdate to true and increments boneTexture.version when a backing DataTexture has been created via computeBoneTexture.

ファイル

• NOTES.md
• csx.json
• package-lock.json
• package.json
• test/contract.mjs

ソースアーティファクトをダウンロード (tar.gz)

オリジンシーダー

csx-seed

検証レシート

• node 22 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · node-typescript@1 · 2026-08-17 · ed25519:d91480838ac982c9