Road Properties

Overview

• Node Name: Road Properties
• Category: repeat_instant
• File: extensions/flowgraph/nodes/util/roadSegment.lua

Outputs detailed properties of a road segment defined by two navgraph node names, including direction, width, speed limit, drivability, and lane information.

Pin Schema

Input Pins

Output Pins

Internals

Key Methods

Caching Strategy

The node caches n1 and n2 and only recalculates static properties (direction, length, drivability, speed limit, lanes) when the node pair changes. The width output updates every frame since it depends on the dynamic xnorm input.

Lane Parsing

Lanes are parsed from the link's lanes string (default '-+'). The - characters count as incoming lanes, + as outgoing lanes.

Direction Handling

The direction vector points from n1 to n2, but is flipped if the link's inNode matches n2 (respecting one-way road direction).

How It Works

1. Retrieves navgraph map data via map.getMap().nodes.
2. Looks up the link between n1 and n2 for segment properties.
3. Computes direction vector, normalized, between the two node positions.
4. Width is calculated as lerp(a.radius, b.radius, xnorm) * 2.
5. Lane counts are derived by counting - and + characters in the lane string.

Usage Example

-- Get properties of a road segment:
-- n1 = "wp_road_001", n2 = "wp_road_002"
-- xnorm = 0.5 (midpoint)
-- Outputs: length, width, speedLimit, drivability, lane counts, direction

-- Check if road is one-way:
-- isOneWay output will be true/false

-- Get width at a specific point:
-- xnorm = 0.0 → width at node n1
-- xnorm = 1.0 → width at node n2

Key Dependencies

• map.getMap() - navgraph map data access

See Also

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