cast
Add, change, or remove characters and objects in a shot, then set their position, pose, size, facing, color, or accessory and get shot and member IDs.
Instructions
Add, change or remove a character or object in a shot. op add needs ref (a character or object id of the style); change and remove need member (its id from get_shot, or its name). Ids must come from the current style: call library to see them (a wrong id is refused with the valid list). A character added without x is spaced out automatically. Returns the shot and member ids. One undo step for the person. To make the cast move or feel something, use act; for animation over time, use keys.
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": "cast"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | Left (-) to right (+); about -8 to 8 is in frame. | |
| y | No | Height above the ground; 0 stands on it. | |
| z | No | Near (+) to far (-); 0 is the front line. | |
| op | No | add if left out. | |
| ref | No | Character or object id (add), or a new one of the same kind (change swaps it). | |
| name | No | A name for this member, like 'Mia'. Used by act and in undo notes. | |
| pose | No | A pose id the character offers. | |
| shot | No | The shot's id (from get_project). Left out: the shot on screen. | |
| size | No | 1 is normal size. | |
| spin | No | Degrees, turning in the picture like a wheel. | |
| tint | No | Colour "#RRGGBB", or "" to remove. | |
| turn | No | Degrees, turning round like on a stage. | |
| auto_x | No | change: true lets the scene space it out again. | |
| facing | No | Which way it looks. | |
| member | No | Member id or name (change, remove). | |
| accessory | No | hat, crown, party, bow (only characters that can dress), or "". |