place
Set a shot’s location using style presets, colors, sky, and scenery items; invalid IDs are refused, and the updated location and item IDs return as one undo step.
Instructions
Set where a shot happens: a place preset (with its scenery), and/or its colours and sky, and scenery items. Ids must come from the current style: call library to see them (a wrong id is refused with the valid list). Returns the place and its item ids. One undo step for the person. For a generated photo background use generate_place; for your own picture use upload with as background.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "place"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| orb | No | Sun, moon or none. | |
| sky | No | Sky colour, "#RRGGBB". | |
| dark | No | true: a dark place (night, inside). | |
| name | No | A name for the place. | |
| shot | No | The shot's id (from get_project). Left out: the shot on screen. | |
| floor | No | Floor colour, "#RRGGBB". | |
| stars | No | Show stars. | |
| walls | No | Show walls (an inside place). | |
| clouds | No | Show clouds. | |
| preset | No | Place preset id (library places). | |
| horizon | No | Horizon colour, "#RRGGBB". | |
| add_items | No | Scenery items to add. | |
| clear_items | No | true: remove every scenery item. | |
| change_items | No | Scenery items to change. | |
| remove_items | No | Item ids to remove. |