render_pcb
Generate a 3D image of a KiCad PCB for visual layout review, with configurable camera side, resolution, rotation, and quality.
Instructions
Render a 3D view of a board as an image with kicad-cli (KiCad 9 or later).
The image has the board and the 3D models of the footprints: a footprint with no 3D model has no body in the image. Use the image for a visual review of the layout.
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": {
"pcb_path": "<pcb_path>"
},
"name": "render_pcb"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| side | No | The side of the camera: "top" (default), "bottom", "left", "right", "front" or "back". | top |
| width | No | The width of the image in pixels (default 1600). | |
| height | No | The height of the image in pixels (default 900). | |
| rotate | No | Optional rotation of the board "X,Y,Z" in degrees, for example "-30,0,25". | |
| quality | No | "basic" (default, fast), "high" (ray tracing, slower), "user" or "job_settings" (the settings of KiCad). | basic |
| pcb_path | Yes | The .kicad_pcb file. | |
| output_path | No | Optional image file: .png, or .jpg or .jpeg for a JPEG image. Default: <board>_render_<side>.png next to the board. |