add_reference_image
Add a reference image as a faded, locked layer over every frame of the sprite without disturbing the active drawing layer. Adjust opacity and fit, then hide or delete the layer when done.
Instructions
Put a sketch or reference on a faded, locked layer on top of the sprite, across
every frame, and keep the active layer as it was, so drawing lands on the art.
image_path is a file on disk; a picture pasted into chat needs saving first.
fit shrinks a larger image to the canvas. opacity is 0-255. Hide or delete
the layer when done. Saving to a flat format would merge it in, so hide it first.
One undo step. Headless: pass file.
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": {
"image_path": "<image_path>"
},
"name": "add_reference_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fit | No | ||
| file | No | ||
| opacity | No | ||
| image_path | Yes | ||
| layer_name | No | Reference |