Driveline Normals

Calculates forward normal vectors for driveline points using adjacent point positions. Used for waypoint orientation and direction display.

Exports

How It Works

normalAlignPoints(point)

Simply returns point.prev, point, and point.next from the linked-list driveline structure.

forwardNormalVec(point)

Calculates the forward direction vector using available adjacent points:

1. Both neighbors exist: Uses prev→next direction (smoothest result)
2. Only next exists: Uses current→next direction
3. Only prev exists: Uses prev→current direction
4. No neighbors: Returns nil

Delegates actual normal calculation to rallyUtil.calculateForwardNormal(fromPos, toPos).

local normals = require('/lua/ge/extensions/gameplay/rally/snaproad/normals')

-- Get forward direction at a driveline point
local normalVec = normals.forwardNormalVec(point)
if normalVec then
  -- normalVec is a unit vec3 pointing in the forward direction
end

-- Get alignment points for custom calculations
local prev, curr, next = normals.normalAlignPoints(point)

See Also

• geoPacenotes - Geometric Pacenote Measurement - Related reference
• Gameplay Systems Guide - Guide