浏览代码

[Docs] Add warning on Object3D.applyMatrix4 based on Matrix4.decompose (#27714)

* [Docs] Add warning on Object3D.applyMatrix4 based on Matrix4.decompose (https://github.com/mrdoob/three.js/issues/20435)

* Add warning in Matrix-Transformations page

* Update Object3D.html

Clean up.

* Update Matrix-transformations.html

---------

Co-authored-by: Michael Herzog <[email protected]>
Jonathan Chemla 1 年之前
父节点
当前提交
2510a29b6a
共有 1 个文件被更改,包括 3 次插入0 次删除
  1. 3 0
      docs/manual/en/introduction/Matrix-transformations.html

+ 3 - 0
docs/manual/en/introduction/Matrix-transformations.html

@@ -54,6 +54,9 @@ object.matrixAutoUpdate = false;
 		<p>
 		When either the parent or the child object's transformation changes, you can request that the child object's [page:Object3D.matrixWorld matrixWorld] be updated by calling [page:Object3D.updateMatrixWorld updateMatrixWorld]().
 		</p>
+		<p>
+		An object can be transformed via [page:Object3D.applyMatrix4]. Note: Under-the-hood, this method relies on [page:Matrix4.decompose], and not all matrices are decomposable in this way. For example, if an object has a non-uniformly scaled parent, then the object's world matrix may not be decomposable, and this method may not be appropriate.
+		</p>
 
 		<h2>Rotation and Quaternion</h2>
 		<p>