Create Replicator (clone a template per data row)
create_replicatorCreates a TouchDesigner Replicator COMP that clones a template per row of a Table DAT, sets replication by table, and re-replicates to generate clones. Accepts or creates template and table, with optional callback stub.
Instructions
Wire a Replicator COMP that clones a template COMP once per row of a Table DAT — TouchDesigner's idiomatic 'N copies from data' mechanism (menus, scoreboards, per-track decks, instanced panels). Resolves or creates the template COMP (omit template_path → a minimal container with a Text) and the driving Table DAT (omit table_path → a small example table; rows sets how many demo rows), creates the replicator under parent_path, points its driving-table and master parameters at them, sets the replication method to 'by table', and optionally drops an onReplicate callback DAT stub for per-clone setup. The Replicator's parameter names vary by TD build, so each is set probe-first and the report includes which parameter took plus the live parameter list. Then it pulses a re-replicate so the clones appear. Re-replicating is destructive to previously generated clones, which the replicator deletes and re-creates on cook.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name for the Replicator COMP. | replicator1 |
| rows | No | When creating an example table, how many example rows (0 = a 3-row demo). | |
| table_path | No | Table DAT whose rows drive the clones. Omit → create a small example Table DAT. | |
| parent_path | No | COMP to build the replicator inside. | /project1 |
| callback_stub | No | Generate an onReplicate callback DAT stub (per-clone setup hook). | |
| template_path | No | Existing COMP to clone per row. Omit → create a minimal template COMP (a container with a Text). |