Create Gaussian Splat scene
create_gaussian_splat_sceneLoad a Gaussian splat asset (.ply or .splat) into TouchDesigner, drop the TDGS tool, and expose a renderTOP with configurable resolution and optional camera binding.
Instructions
Drops the community TDGS .tox by Anglerfish-graphics into a fresh baseCOMP, loads a .ply or .splat Gaussian Splat asset, optionally binds an existing cameraCOMP, and exposes a clean output renderTOP at 720p–2160p. Assets can be exported from Polycam, Postshot, Luma, or Nerfstudio. The wrapper connects to any existing tdmcp camera rig (create_camera_orbit, XY pads, MIDI). REQUIREMENTS: TDGS by Anglerfish-graphics installed (https://github.com/Anglerfish-Graphics/TDGS); TouchDesigner build ≥2023.30000; CUDA-capable NVIDIA GPU on Windows. macOS and AMD GPUs are not supported by TDGS — the tool returns a friendly error. VRAM: 720p≈2GB, 1080p≈4-6GB, 1440p≈12GB+, 2160p≈16GB+ (OOM crashes TD — no friendly error, start at 720p on a laptop). Returns container_path, dropped_tox_path, output_top_path, camera_path, warnings, and a preview image.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| splat_asset_path | Yes | Absolute path to a .ply or .splat Gaussian Splat asset. Export from Polycam, Postshot, Luma, or Nerfstudio. | |
| tox_path | No | Optional explicit absolute path to TDGS.tox. When set, skips the standard candidate walk. Useful when TDGS lives in a non-standard packages directory. | |
| camera_path | No | Absolute TD path to an existing cameraCOMP (e.g. one built by create_camera_orbit). When set, TDGS's camera reference par is bound to it. When unset, TDGS uses its internal default camera. | |
| output_res | No | Output renderTOP resolution. 720p=1280×720, 1080p=1920×1080, 1440p=2560×1440, 2160p=3840×2160. WARNING: 1440p+ requires a discrete GPU with ≥12GB VRAM; 2160p will crash TD on OOM. Default 1080p. | 1080p |
| container_name | No | Name of the outer baseCOMP created by createSystemContainer. | gaussian_splat_scene |
| parent_path | No | Parent network for the baseCOMP (default '/project1'). | /project1 |
| expose_controls | No | When true (default), promotes SplatAssetPath, CameraRef, and OutputRes to the wrapper container as live knobs. |