Road Architect - Groups
Manages road groups in the Road Architect. Groups allow batch operations (terraforming, visibility, profiles) across multiple roads defined by a perimeter polygon or manual selection.
Manages road groups in the Road Architect. Groups allow batch operations (terraforming, visibility, profiles) across multiple roads defined by a perimeter polygon or manual selection.
Public Functions
| Function | Signature | Description |
|---|---|---|
M.groups | `` | Groups data table |
M.addGroupToRoadsAudition | (...) | Adds group to roads in audition mode |
M.addGroupToRoadsPlace | (...) | Places group onto roads |
M.goToGroupView | (...) | Navigates camera to group view |
M.manageRotateCam | (...) | Manages camera rotation for groups |
M.createGroup | (...) | Creates a new group |
M.copyPlacedGroup | (...) | Copies a placed group |
M.createPrefabGroup | (...) | Creates a prefab group |
M.goToOldView | (...) | Returns to previous camera view |
M.getDefaultGroups | () | Returns default group definitions |
M.getPlacedGroups | () | Returns placed groups |
M.setPlacedGroups | (...) | Sets placed groups data |
M.removePlacedGroupSoft | (...) | Soft-removes a placed group |
M.removePlacedGroupHard | (...) | Hard-removes a placed group |
M.goToPlacedGroup | (...) | Navigates camera to a placed group |
M.updateGroupsAfterRoadRemove | (...) | Updates groups after a road is removed |
M.save | (...) | Saves groups data |
M.load | (...) | Loads groups data |
M.serialiseGroup | (...) | Serializes a group |
M.deserialiseGroup | (...) | Deserializes a group |
Example: Group Operations
local groups = require('editor/tech/roadArchitect/groups')
-- Create a group from selected roads with a perimeter polygon
local polygon = { vec3(0,0,0), vec3(100,0,0), vec3(100,100,0), vec3(0,100,0) }
local roadIndices = { 1, 3, 5 }
groups.createGroup("Highway Section", roadIndices, polygon)
-- Add/remove roads
groups.addRoadToGroup(1, 7)
groups.removeRoadFromGroup(1, 3)
-- Apply a profile to all roads in the group
groups.applyProfileToGroup(myGroup, highwayProfile, allRoads)
-- Terraform all roads in the group
groups.terraformGroup(myGroup, allRoads, roadMap, terraParams)
-- Toggle visibility
groups.setGroupVisibility(myGroup, false, allRoads)
-- Compute bounding box for camera framing
local aabb = groups.computeGroupAABB(myGroup, allRoads)Notes
- Groups reference roads by index into the master roads array
- Perimeter polygon used for visual fence rendering and containment
- Group operations iterate roads and apply per-road functions
Functions
addGroupToRoadsAudition(gIdx)
Adds group to roads audition.
gIdx(any)
addGroupToRoadsPlace(gIdx, isConformGroupToTerrain)
Adds group to roads place.
gIdx(any)isConformGroupToTerrain(any)
Returns: pGroup
goToGroupView(gIdx, timer, time)
Handles go to group view.
gIdx(any)timer(any)time(any)
Returns: time
manageRotateCam()
Handles manage rotate cam.
copyPlacedGroup(pg)
Handles copy placed group.
pg(any)
Returns: table
createPrefabGroup(g)
Creates prefab group.
g(any)
goToOldView()
Handles go to old view.
getDefaultGroups()
Returns the default groups.
getPlacedGroups()
Returns the placed groups.
setPlacedGroups(pg)
Sets the placed groups.
pg(any)
removePlacedGroupSoft(groupIdx)
Removes placed group soft.
groupIdx(any)
Returns: self
removePlacedGroupHard(groupIdx)
Removes placed group hard.
groupIdx(any)
goToPlacedGroup(idx)
Handles go to placed group.
idx(number)
Returns: self
updateGroupsAfterRoadRemove()
Updates groups after road remove.
load()
Handles load.
serialiseGroup(g)
Handles serialise group.
g(any)
Returns: gSer
deserialiseGroup(gSer)
Handles deserialise group.
gSer(any)
Returns: g
Functions
addGroupToRoadsAudition(gIdx)
Adds group to roads audition.
gIdx(any)
addGroupToRoadsPlace(gIdx, isConformGroupToTerrain)
Adds group to roads place.
gIdx(any)isConformGroupToTerrain(any)
Returns: pGroup
goToGroupView(gIdx, timer, time)
Handles go to group view.
gIdx(any)timer(any)time(any)
Returns: time
manageRotateCam()
Handles manage rotate cam.
copyPlacedGroup(pg)
Handles copy placed group.
pg(any)
Returns: table
createPrefabGroup(g)
Creates prefab group.
g(any)
goToOldView()
Handles go to old view.
getDefaultGroups()
Returns the default groups.
getPlacedGroups()
Returns the placed groups.
setPlacedGroups(pg)
Sets the placed groups.
pg(any)
removePlacedGroupSoft(groupIdx)
Removes placed group soft.
groupIdx(any)
Returns: self
removePlacedGroupHard(groupIdx)
Removes placed group hard.
groupIdx(any)
goToPlacedGroup(idx)
Handles go to placed group.
idx(number)
Returns: self
updateGroupsAfterRoadRemove()
Updates groups after road remove.
load()
Handles load.
serialiseGroup(g)
Handles serialise group.
g(any)
Returns: gSer
deserialiseGroup(gSer)
Handles deserialise group.
gSer(any)
Returns: g
See Also
- Road Architect - Clothoid - Related reference
- Road Architect - Decals - Related reference
- Road Architect - Export - Related reference
- World Editor Guide - Guide
Road Architect - Geometry
Core geometry module for the Road Architect. Computes road meshes from node chains using Catmull-Rom spline interpolation, lateral offset sampling, elevation blending, and procedural mesh generation.
Road Architect - Import
Handles deserialization and import of Road Architect road data from JSON files. Reconstructs road structures (nodes, profiles, layers, groups, junctions) and initializes render state.