Single Hologram Marker

A lightweight checkpoint marker that renders a single faded column at the waypoint center. Uses raycasting to snap to terrain and scales height with camera distance.

Class API (OOP via metatable)

Mode Properties

How It Works

1. Ground raycasting: setToCheckpoint casts a ray (6m up, 25m down) at the waypoint center to find terrain. Disables forest collision during raycast.
2. Ground snap: If ground is found and within 1m of waypoint Z, uses ground position; otherwise uses waypoint position
3. Bobbing: Column bobs vertically via sin(timer * 0.333 * 2π) * 0.05
4. Column height: Scales with distance: inverseLerp(60, 180, distance) gives 0–20 units, base height of 1
5. Fade: Column alpha fades from 0.15 to 1.0 between 60–120m distance, multiplied by mode alpha
6. scalarThin: Modes control column X/Y scale; hidden uses 0 to completely hide
7. Column offset: Positioned 7m above ground for visibility

Usage Example

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

Key Notes

• Shape: s_single_faded_column_rect.dae
• Simplest ground-snapping marker - only 1 TSStatic object
• Uses core_forest.getForestObject():disableCollision() during raycasts
• columnOffset = vec3(0, 0, 7) lifts the column above ground
• 0.8s color lerp duration (longer than most other markers)

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