words
Add, change, or remove on-screen text in a video shot using style presets and animations; returns shot and text IDs and creates one undo step.
Instructions
Add, change or remove on-screen text in a shot. preset is one of the style's text presets (its look and font); action is its animation (pop, slam, type, fade, slide, drop...). Ids must come from the current style: call library to see them (a wrong id is refused with the valid list). Returns the shot and text ids. One undo step for the person. For a script line that is spoken, use write_script or assign_line (its captions come from the voice).
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": "words"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | Centre across, in % of the frame (50 is the middle). | |
| y | No | Centre down, in % of the frame (18 is near the top; captions sit near 84). | |
| at | No | When it appears, in % through the shot (0 to 100) | |
| id | No | Text id, for change and remove. | |
| op | No | add if left out. | |
| font | No | A font family the style offers, or "". | |
| shot | No | The shot's id (from get_project). Left out: the shot on screen. | |
| size | No | 1 is normal. | |
| when | No | Rough timing in the shot. Use at for an exact %. | |
| color | No | "#RRGGBB", or "" for the preset's own. | |
| until | No | When it leaves, in % through the shot (0 to 100) | |
| words | No | The text. Short reads best: 2 to 5 words. | |
| action | No | Animation id (library text_animations). | |
| preset | No | Text preset id (library text_presets). | |
| line_words | No | Words per line (2 if left out). |