create_variant_structure
Add empty variants to a USD prim and select a default, ready to author and switch between without replacing existing sets.
Instructions
Add a variant set of empty variants to a prim and select one, ready to fill and to switch between with set_variant_selection.
A set or variant that already exists is kept and added to, never replaced. The variants hold nothing until you author into them, with execute_script. An error when the prim doesn't exist.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prim_path": "<prim_path>",
"variant_set_name": "<variant_set_name>",
"variant_names": "<variant_names>"
},
"name": "create_variant_structure"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prim_path | Yes | The prim to add the variant set to | |
| variant_names | Yes | The variants to create, e.g. ["focused", "shell"] | |
| default_variant | No | The variant to select; the first of variant_names when empty or not among them | |
| variant_set_name | Yes | The new variant set's name, e.g. "model" |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |