Opentoonz Import Images As Level
opentoonz_import_images_as_levelImport an ordered image sequence as a raster level in OpenToonz onto the xsheet; re-importing the same level name overwrites its drawings, so art can be iterated without duplicating levels.
Instructions
Import an ordered image sequence as a raster level and place it on the xsheet.
Additive: an existing scene is loaded first, so you can call this repeatedly with different level_name/column to build a multi-level scene. Images are converted to RGBA PNG named <level_name>.%04d.png, and levels composite 1:1 and centred — draw at the scene's size (1920x1080 by default) for full-frame output.
Re-importing the same level_name reuses that level and overwrites its drawings, so you can iterate on art without the level being duplicated.
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": {
"workspace": "<workspace>",
"level_name": "<level_name>",
"image_paths": "<image_paths>"
},
"name": "opentoonz_import_images_as_level"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scene | No | main | |
| column | No | ||
| start_row | No | ||
| workspace | Yes | ||
| level_name | Yes | ||
| image_paths | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |