示例

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