How ajcraig99/plant3d-live-preview works
Plant 3D Live Preview lets users select custom Python part scripts, render them through a Plant-compatible geometry shim, and inspect or adjust the resulting model in a browser. The main path is browser selection and parameter editing → server render request → script execution and mesh generation → model and metadata in the viewer. The CLI offers a separate one-off rendering path. The README documents additional viewer capabilities; source excerpts do not expose their individual implementation details, so they are represented within the viewer node.
Main entry points: render.py Script renderer · index.html Preview UI · server.py HTTP server · p3dkernel.py Mesh geometry kernel
Components 15
User interaction
- Preview UI
viewer/index.html
Preview service
- HTTP server
server.py - Script discovery
server.py - File watcher
server.py
Rendering engine
- Script renderer
render.py - Render metadata
render.py - GLB mesh
render.py - Render CLI
render.py
Plant compatibility
- Mesh geometry kernel
shim/p3dkernel.py - Primitive shim
shim/varmain/primitiv.py - Parameter decorators
shim/varmain/custom.py - Math shim
shim/aqa/math.py
Other components
- Part author
- Part scripts
- Browser
Connections 21
- Part author → Part scripts: edits
README.md - Part author → Preview UI: selects and adjusts
README.md - Browser → Preview UI: opens
README.md - Preview UI → HTTP server: requests renders
README.md - HTTP server → Script discovery: lists scripts
server.py - HTTP server → Script renderer: invokes
server.py - File watcher → Preview UI: notifies changes
server.py - HTTP server → File watcher: starts
server.py - Part scripts → Script renderer: supplies source
README.md - Script renderer → Mesh geometry kernel: executes via
render.py - Script renderer → Render metadata: collects
render.py - Script renderer → GLB mesh: exports
render.py - Script renderer → Primitive shim: loads scripts using
render.py - Script renderer → Parameter decorators: reads parameter metadata
render.py - Primitive shim → Mesh geometry kernel: constructs solids with
shim/varmain/primitiv.py - Mesh geometry kernel → Math shim: uses math helpers
shim/p3dkernel.py - HTTP server → Preview UI: serves UI
server.py - Render metadata → Preview UI: drives controls and overlays
README.md - GLB mesh → Preview UI: displays model
README.md - Part author → Render CLI: runs one-off render
README.md - Render CLI → Script renderer: calls
render.py