draw_debug
Marks points, rays, and paths with temporary 2-pixel lines, polylines, spheres, or crosses in the Isaac Sim viewport for visual checks and viewport captures without altering the stage.
Instructions
Draw debug lines in the viewport, 2 pixels wide, for duration seconds: a line, a polyline, a sphere as
three crossing lines, or a small cross per point.
Use it to mark points, rays or paths, such as a raycast's hit, for a capture or the user to see: on Isaac Sim 6.x the lines show in capture_viewport's image. Nothing is added to the stage. In Isaac Sim, when a drawing expires, lines other code drew with isaacsim.util.debug_draw go too. A new stage drops the old one's drawings.
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": {
"shape": "<shape>"
},
"name": "draw_debug"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | For "line": its end [x, y, z] | |
| size | No | For "points": how far each point's cross reaches, in stage units | |
| color | No | [r, g, b] colour in 0-1; red when omitted | |
| shape | Yes | What to draw: "lines" joins the points in order | |
| start | No | For "line": its start [x, y, z] | |
| center | No | For "sphere": its centre [x, y, z] | |
| points | No | For "points" and "lines": a list of [x, y, z] | |
| radius | No | For "sphere": its radius | |
| duration | No | How long it shows, in seconds from the call, whether the simulation plays or not |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |