Assembly Spline Populate

Handles the placement of molecule instances (rigid + bridge meshes) along an assembly spline. Manages mesh pooling, spline sampling, rigid placement via attachment sequences, and bridge scaling/alignment.

Public Functions

Key Concepts

Placement Pipeline

1. Spline sampling - Evenly-spaced positions extracted from subdivision points
2. Distribution maps - Per-placement variation selection (round-robin or random)
3. Mesh pooling - TSStatic objects reused across updates (create/delete only deltas)
4. Root placement - Root rigid mesh aligned to spline tangent with jitter
5. Attachment chaining - Non-root rigids placed by aligning attachment frames
6. Bridge placement - Bridges scaled in X to span between molecule pairs, with roll alignment via nail axes

Normal Modes

Usage Example

local pop = require('editor/assemblySpline/populate')

-- Place molecules along a fully-computed spline
pop.populateAssemblySpline(spline, 1, spline.moleculeDescription)

-- Remove all meshes when spline is deleted
pop.tryRemove(spline)

Internal Details

• Uses TSStatic objects stored in SceneTree SimGroup folders
• Mesh pools keyed by (splineId, meshPath) for efficient reuse
• Bridge sag applied via Z-axis scaling (1.0 + spline.sag * 0.1)
• Bridge roll computed as average of source/target nail axis alignment angles
• Random seed set from spline.splineRandomSeed for deterministic variation

See Also

• assemblySpline/molecule - Molecule structure and attachment parsing
• assemblySpline/splineMgr - Spline state management