Road Architect - Render

Handles all editor viewport rendering for the Road Architect. Draws road surfaces, outlines, centerlines, lane numbering, direction arrows, node spheres, guidelines, layer visualizations, junctions, links, groups, multi-selections, terrain edit ranges, tunnels, overlays, and bridges.

Public Functions

Parameters for drawRoadMarkups:

• roads - array of all road structures
• map - road name to index map
• tree - spatial query tree for camera-frustum culling
• selectedRoadIdx - currently selected road index
• selectedNodeIdx - currently selected node index
• selectedLayerIdx - currently selected layer index
• selectedLink - proposed link preview data
• selectedCandidateJct - proposed junction preview data
• isGuidelines - whether to show alignment guidelines
• isGroupMode - whether group editing mode is active
• isProfileMode - whether profile editing mode is active
• isCreateGroup - whether user is drawing a group polygon
• gPolygon - group polygon vertices being drawn
• multi - multi-selection array
• isShowTerraSingle / isShowTerraGroup - terraform visualization flags
• selectedPlacedGroup - selected placed group for terraform vis
• terraParams - terraform parameter set

Example: Road Rendering Pipeline

local render = require('editor/tech/roadArchitect/render')

-- Called each frame from the Road Architect editor's onEditorGui:
render.drawRoadMarkups(
  roads,                    -- all roads
  roadMap,                  -- name → index map
  spatialTree,              -- R-tree for culling
  selectedRoadIdx,          -- selected road
  selectedNodeIdx,          -- selected node
  selectedLayerIdx,         -- selected layer
  selectedLink,             -- proposed link (or nil)
  selectedCandidateJct,     -- proposed junction (or nil)
  isGuidelines,             -- show guidelines
  isGroupMode,              -- group mode active
  isProfileMode,            -- profile mode active
  isCreateGroup,            -- drawing group polygon
  gPolygon,                 -- polygon verts
  multi,                    -- multi-selected roads
  isShowTerraSingle,        -- terraform single road vis
  isShowTerraGroup,         -- terraform group vis
  selectedPlacedGroup,      -- placed group for terraform
  terraParams               -- terraform parameters
)

-- Rendering is camera-culled: only roads within 350 units are drawn
-- Each road controls its own display flags:
--   road.isDisplayRoadSurface[0]   - semi-transparent surface mesh
--   road.isDisplayRoadOutline[0]   - edge outline lines
--   road.isDisplayRefLine[0]       - centerline reference line
--   road.isDisplayLaneInfo[0]      - lane numbers and direction arrows
--   road.isDisplayNodeSpheres[0]   - spheres at node positions
--   road.isDisplayNodeNumbers[0]   - text labels at nodes

Internal Render Functions

The module contains many local helper functions:

• renderRoadSurface - draws semi-transparent lane polygons
• renderRoadOutline - draws edge lines with selection highlighting
• renderRoadCenterline - draws the reference/center line
• renderLaneNumbering - draws lane number labels
• renderLaneDirectionTriangles - draws direction arrow triangles
• renderNodeSpheres - draws spheres at road nodes
• renderNodeNumbering - draws node index labels
• renderLayer - draws a specific profile layer visualization
• renderOverlay - draws overlay patches
• renderAutoTunnel - draws tunnel geometry
• renderProposedJoin_End2End - draws proposed link preview
• renderProposedJoin_End2Mid - draws proposed junction preview
• renderGroupPolygonFence - draws group creation polygon
• renderMultiSelectNodes - highlights multi-selected nodes
• renderGuidelines - draws alignment guidelines
• renderTerraSingle / renderTerraGroup - terraform range visualization

Notes

• Uses debugDrawer for 3D line/sphere/triangle rendering
• Camera culling via spatial tree query (350-unit radius)
• Selected roads get distinct coloring and additional detail

See Also

• Road Architect - Clothoid - Related reference
• Road Architect - Decals - Related reference
• Road Architect - Export - Related reference
• World Editor Guide - Guide