Closest Road (Flowgraph Node)

Overview

• Node Name: Closest Road
• Category: repeat_instant
• File: extensions/flowgraph/nodes/util/closestRoad.lua

Finds the closest road segment on the navgraph from a given position. Returns both endpoint nodes, distance, projected point, road width, and optional DecalRoad IDs.

Pin Schema

Input Pins

Output Pins

Internals

Key Methods

How It Works

1. Only recalculates when pos changes (caches oldPos).
2. Calls map.findClosestRoad(pos) to get the two endpoint node names and distance.
3. Calculates xnorm (projection parameter) on the line segment; swaps A/B so A is always the closer endpoint.
4. Projects pos onto the segment using setLerp for the projected point.
5. Interpolates road width from both node radii: lerp(a.radius, b.radius, xnorm) * 2.
6. Attempts to parse DecalRoad IDs from navgraph node names (format: DecalRoadNNN_MMM).

Usage Example

-- Find closest road from a position:
local name_a, name_b, distance = map.findClosestRoad(pos)
local nodeA = map.getMap().nodes[name_a]
local nodeB = map.getMap().nodes[name_b]

-- Project position onto road:
local xnorm = clamp(pos:xnormOnLine(nodeA.pos, nodeB.pos), 0, 1)
local projected = vec3()
projected:setLerp(nodeA.pos, nodeB.pos, xnorm)

-- Get road width at that point:
local width = lerp(nodeA.radius, nodeB.radius, xnorm) * 2

Key Dependencies

• map.findClosestRoad() - finds nearest navgraph road segment
• map.getMap().nodes - access to navgraph node positions and radii

See Also

• Route Distance (Flowgraph Node) - Related reference
• Custom Lua (Flowgraph Node) - Related reference
• Distance Between (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide