Ring Marker - 3D Ring Checkpoint Marker

A race checkpoint marker that renders a 3D ring (hoop) at the waypoint position. Supports normal/up orientation, scales to waypoint radius, and swaps between regular and finish ring shapes based on mode.

Class API (OOP via metatable)

Mode Colors & Shapes

How It Works

1. Two ring shapes: Regular checkpoints use checkpoint_ring.dae, lap/final use checkpoint_ring_finish.dae
2. Orientation: Ring is rotated via quatFromDir(fwd, up) using the waypoint's normal and up vectors
3. Scale: Ring scales to vec3(radius, radius, radius) - checkpoint radius maps directly to ring size
4. Color transition: Lerps between old/new mode colors and base colors over 0.3 seconds
5. Alpha fade: When transitioning to/from hidden, alpha smoothly interpolates (0→1 or 1→0)
6. Shape swap: setMode and setToCheckpoint call preApply/postApply to hot-swap the shape DAE

Usage Example

local createMarker = require("scenario/raceMarkers/ringMarker")
local marker = createMarker(1)
marker:createMarkers()
marker:setToCheckpoint({
  pos = vec3(100, 200, 50),
  radius = 8,
  normal = vec3(0, 1, 0),  -- direction the ring faces
  up = vec3(0, 0, 1),
  mode = 'default'
})
marker:setMode('default')

Key Notes

• Ring mesh path: art/shapes/interface/ringMarker/checkpoint_ring.dae
• Finish ring: art/shapes/interface/ringMarker/checkpoint_ring_finish.dae
• Scale is radius + 1.5 in setToCheckpoint for visual padding
• Uses baseColor per mode for secondary tinting (white for most, black for next/hidden)

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