Skip to content

Conversation

@paul-marechal
Copy link
Contributor

Some old APIs that may expect a Vector4 instead require a Plane: this is pretty confusing especially with tangents as one could interpret the API as wanting a value directly representing the tangent plane when in reality the Plane type is just used to carry one Vector3 and one extra sign component.

This commit attempts to clear any potential confusion by adding a note to the APIs using Planes in such a way.

Some old APIs that may expect a Vector4 instead require a Plane: this
is pretty confusing especially with tangents as one could interpret
the API as wanting a value directly representing the tangent plane when
in reality the Plane type is just used to carry one Vector3 and one
extra sign component.

This commit attempts to clear any potential confusion by adding a note
to the APIs using Planes in such a way.
@paul-marechal paul-marechal force-pushed the mesh_data_tool_tangent_doc branch from 9506dfa to 509cf61 Compare October 13, 2025 20:10
Copy link
Member

@Mickeon Mickeon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good call

@Mickeon Mickeon requested a review from a team October 13, 2025 22:52
@Repiteo Repiteo modified the milestones: 4.x, 4.6 Oct 14, 2025
@Repiteo Repiteo merged commit 076445b into godotengine:master Oct 20, 2025
20 checks passed
@Repiteo
Copy link
Contributor

Repiteo commented Oct 20, 2025

Thanks! Congratulations on your first merged contribution! 🎉

@paul-marechal paul-marechal deleted the mesh_data_tool_tangent_doc branch October 21, 2025 05:39
@paul-marechal
Copy link
Contributor Author

Thanks, I'll try to keep coming back any time I land on something I can improve :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants