Create 3D scene
create_3d_sceneBuild a 3D scene with geometry, camera, light, and render TOP. Supports GPU instancing with random size and rotation, and exposes scene spin and zoom knobs.
Instructions
Build a renderable 3D scene: a Geometry COMP holding the chosen primitive (sphere/box/grid), a Camera, a Light, and a Render TOP, output as a Null. Creates a new baseCOMP under parent_path holding all of these — optionally instanced into a grid of instances copies via GPU instancing, with scale_variation for per-copy random sizes and spin for per-copy rotation over time. Exposes RotateY (whole-scene spin) and Zoom (camera distance) knobs. The starting point for 3D visuals — bind RotateY to a tempo ramp or an audio feature to make it move. Use create_3d_audio_reactive instead when you want the geometry driven by sound, or create_pbr_scene for physically-based materials. Returns a summary plus a JSON block with the container path, created node paths, the geometry/camera/render/output paths, exposed controls, any node errors, warnings, and an inline preview image.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| primitive | No | Geometry to render. | sphere |
| instances | No | Copies to scatter via GPU instancing on a grid (1 = a single object). | |
| spin | No | Per-instance spin around Y in degrees/sec (0 = still). Each copy rotates in place over time; needs instances > 1. | |
| scale_variation | No | Per-instance size variation: 0 = all the same size, 1 = sizes range from 0 to full. Needs instances > 1. | |
| expose_controls | No | When true (default), expose live RotateY (spin) and Zoom (camera distance) knobs. | |
| parent_path | No | Parent network where the 3D-scene container is created (default '/project1'). | /project1 |