Method Proposal: pygame.geometry.Line.closest_point(point, do_clamp=True)

[damusss]

The Line object has not been ported yet, but for the time it will, I propose to add the method in the title.

The method returns the closest point on the line relative to another point. The math for it isn't super straight forward, and unless you studied that somehow you probably need to search it online, that's why I think it should be added.

The do_clamp parameter controls weather the endpoints are ignored. The "default" math returns a point that can exceed A and B, but this could be what the user wants, so it could be optionally clamped.

[bilhox]

I didn't understand what the feature does, it might be more elaboration and a schema.

[MrRedstone058]

The Line object has not been ported yet, but for the time it will, I propose to add the method in the title.

The method returns the closest point on the line relative to another point. The math for it isn't super straight forward, and unless you studied that somehow you probably need to search it online, that's why I think it should be added.

The do_clamp parameter controls weather the endpoints are ignored. The "default" math returns a point that can exceed A and B, but this could be what the user wants, so it could be optionally clamped.

to understand what you're saying, is it basically finding the point in a line that is directly perpendicular to the point? (in the case of do_clamp = false, the closest point follows the gradient of the original line)?

[damusss]

@bilhox @MrRedstone058 I drawed what this method is supposed to do:

Now, with do_clamp = False, we have:

and with do_clamp = True, we have:

[MrRedstone058]

yup, just as i thought. i do not know the best way to do the math for this, but i can try to work it out as a base

[bilhox]

After a discussion, we agreed to rename this function to Line.project.