Side Hologram Marker

A three-part checkpoint marker with a curved base, active side hologram, and a distant hologram that fades in at range. Blends between close and far representations based on camera distance.

Class API (OOP via metatable)

Spawned Objects (3 total)

Mode Colors & Shapes

How It Works

1. Distance blending: Uses a blendState machine (close/far) with hysteresis between fadeNear (50m) and fadeFar (75m)
2. Close alpha: Base at 0.75 opacity, sides at 0.95
3. Distant alpha: Smoothly transitions via blendTimer / blendDuration (0.8s)
4. Side scaling: Uses smootherstep for smooth lerp between close and distant scale
5. Camera-facing rotation: Base and sides rotate to face camera when distance > radius * 1.5
6. Shape swapping: Lap/final modes use _finish.dae shape, swapped via preApply/postApply
7. Hidden fade: Alpha lerps to 0 when entering hidden mode, lerps from 0 when leaving

Usage Example

local createMarker = require("scenario/raceMarkers/sideHologramMarker")
local marker = createMarker(1)
marker:createMarkers()
marker:setToCheckpoint({
  pos = vec3(100, 200, 50),
  radius = 10,
  normal = vec3(0, 1, 0),
  mode = 'default'
})
marker:setMode('default')

Key Notes

• Shape paths under art/shapes/interface/sideMarker/
• distanceScale = 4 with sideToDistantRatio for scaled transition
• Base, sides, and distant all scale to waypoint radius
• Blending uses separate blendTimer independent of colorTimer

See Also

• Race Marker: Attention - Floating Arrow Checkpoint Marker - Related reference
• Race Marker: Crawl Marker - Arrow + Flag + Column Checkpoint - Related reference
• Race Marker: Cylinder - Base + Cylinder Checkpoint Marker - Related reference
• Scenario System Guide - Guide