Object3d.worldToLocal

[redblackbit]

The method treats the input vector as a point expressed in homogeneous coordinates. This behavior should be commented.

[WestLangley]

No. Object3d.worldToLocal( vector ) takes a Vector3 argument, and treats the input vector as a 3D point.

[redblackbit]

Which is exactly what I meant. A 4D vector with w = 1 corresponds to a 3D point with the same coordinates but what if you want to transform a vector instead (i.e. w = 0)?
In the API sometimes a Vector3 means a vector and some other times it means a point and the meaning depends on the context. In the above case it's not obvious that the user wants to transform a point instead of a vector.

[WestLangley]

Sorry, I do not understand what you are saying.

1. Can you please explain it another way -- with a specific example?
2. Can you please point to the specific API document(s) you are referring to?

[redblackbit]

my_obj.worldToLocal(new THREE.Vector3(1, 1, 1));

Without documentation/experimentation it's not clear if the input parameter is treated as point or as vector.

[dubejf]

In this context, "vector" means "point". worldToLocal transforms the Cartesian coordinates of a point from world space to local space.