UKismetMathLibrary::FindClosestPointOnLine
#include "Kismet/KismetMathLibrary.h"
Access: public
Specifiers: staticUFUNCTIONBlueprintPure
Description
Returns the closest point on an infinite line to a query point. Unlike FindClosestPointOnSegment, there are no endpoints — the line extends infinitely in both directions.
Caveats & Gotchas
- • LineDirection must not be zero; no safety check exists and a zero vector causes a divide-by-zero. Validate the direction before calling in data-driven contexts.
- • For finite segments with clamping to endpoints, use FindClosestPointOnSegment. Mixing up the two silently produces wrong results when Point lies beyond a segment's end.
Signature
static ENGINE_API FVector FindClosestPointOnLine(FVector Point, FVector LineOrigin, FVector LineDirection);Parameters
| Name | Type | Description | Default |
|---|---|---|---|
| Point | FVector | The query point. | — |
| LineOrigin | FVector | Any point on the infinite line. | — |
| LineDirection | FVector | Direction of the infinite line. Does not need to be normalized. | — |
Return Type
FVector Example
Find the nearest position on a train track axis to the player C++
FVector PlayerPos = GetActorLocation();
FVector NearestOnTrack = UKismetMathLibrary::FindClosestPointOnLine(
PlayerPos, TrackOrigin, TrackDirection);Version History
Introduced in: 4.0
| Version | Status | Notes |
|---|---|---|
| 5.6 | stable | — |
Feedback
Was this helpful?