Three.js: Missing Object3D.updateWorldMatrix() in the document

Created on 20 Apr 2019 · 6Comments · Source: mrdoob/three.js

Description of the problem

No updateWorldMatrix() in Object3D document.

Three.js version

[x] Dev
[ ] r103
[ ] ...

Browser

[x] All of them
[ ] Chrome
[ ] Firefox
[ ] Internet Explorer

OS

[x] All of them
[ ] Windows
[ ] macOS
[ ] Linux
[ ] Android
[ ] iOS

Hardware Requirements (graphics card, VR Device, ...)

Documentation

Source

takahirox

Most helpful comment

@gkjohnson To be honest, I have been trying to get updateMatrixWorld() replaced since at least 2015 -- likely longer than that.

updateMatrixWorld() does not do what its name implies. It also updates children -- needlessly in many cases -- and isn't even guaranteed to do that correctly.

I believe updateWorldMatrix() should be the method that replaces it.

If you are interested, you can help by supporting #16292 as a start.

WestLangley on 22 Apr 2019

👍2

All 6 comments

It is an undocumented feature I added to replace a method that does not work correctly.

WestLangley on 20 Apr 2019

Is it intentionally undocumented or just an oversight?

looeee on 20 Apr 2019

It was intentional on my part.

WestLangley on 20 Apr 2019

@WestLangley Is there a plan to change the behavior of the documented function or to add this one to the docs in the future? I'm using the function for my work now to make sure just a specific node in a deep hierarchy is up to date.

gkjohnson on 22 Apr 2019

@gkjohnson To be honest, I have been trying to get updateMatrixWorld() replaced since at least 2015 -- likely longer than that.

updateMatrixWorld() does not do what its name implies. It also updates children -- needlessly in many cases -- and isn't even guaranteed to do that correctly.

I believe updateWorldMatrix() should be the method that replaces it.

If you are interested, you can help by supporting #16292 as a start.

WestLangley on 22 Apr 2019

👍2

By the way, this was fixed with #17109