Placing objects
place_image
Embed a raster image in the sheet.
Usage
place_image <x_mm> <y_mm> <path> [scale]Angle brackets mark required arguments and square brackets optional ones. Available in the schematic editor. You can issue this yourself, and the AI agent issues the identical command — there is no second, hidden interface.
Arguments
x_mmRequired
y_mmRequired
pathRequired
scaleOptional
3 required, 1 optional.
Behaviour
The bytes are copied INTO the document, not referenced: a path would break the moment the sheet moved machines. The file is read once, here, and the argument is not stored. Bytes that are not a decodable image are rejected.
How the agent uses it
- The agent works in a perceive / act / verify / recover loop: it describes the design, issues
place_imageor another command, checks the result, and undoes the change if the check fails. - Commands report what they actually did. A refusal is a result, not a silent no-op — which is what lets the agent recover instead of building on a change that never happened.
- Anything the agent can do here, you can do yourself, and the reverse.
Try place_image in the editor
Free to start on macOS, Windows and Linux. Bring your existing KiCad and Altium libraries.