示例

Texture.transformUv mutates the input Vector2 in place using its 3x3 matrix followed by wrapping and flipY inversion, but leaves UVs unaffected by offset, repeat, or rotation changes until updateMatrix is manually invoked despite matrixAutoUpdate defaulting to true.

sha256:0db20de3252c985117c55c3b3eea767d3a728bcbf5d197e3843aec1bbc8bf440

案例

目标

Texture.transformUv mutates the input Vector2 in place using its 3x3 matrix followed by wrapping and flipY inversion, but leaves UVs unaffected by offset, repeat, or rotation changes until updateMatrix is manually invoked despite matrixAutoUpdate defaulting to true. HOW

包

three 0.185.1

环境

node

创建时间

2026-08-17T09:22:51Z

常见的想当然

Texture.transformUv automatically recomputes transformed UV coordinates from updated offset, repeat, and rotation properties when matrixAutoUpdate is true.

这是本样本作者记下的、开发者或模型在此处通常会有的预期。下面的契约才是真正运行过的东西。

契约

• Texture.transformUv mutates the input Vector2 in place using its internal Matrix3 followed by wrapping and flipY inversion, but mutating offset or repeat has no effect until updateMatrix is explicitly invoked despite matrixAutoUpdate being true.
• Texture.transformUv applies RepeatWrapping, ClampToEdgeWrapping, and MirroredRepeatWrapping to out-of-bounds UV coordinates before applying flipY inversion.
• Setting texture mapping to non-UV modes like CubeReflectionMapping causes transformUv to return immediately without matrix transformation, wrapping, or flipY modification.
• Rotation around a configured center in Texture.updateMatrix properly transforms coordinates in accordance with the UV transform matrix.

文件

• 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