Draw Circle

draw_circle

Draw a circle.

Arguments

All listed arguments are required.

Name	Type	Meaning
x, y	integer	Center
radius	integer	Nonnegative radius in pixels
color	string	Opaque palette color
width	string	1x1, 2x2, 3x3, or 4x4
fill	string	empty for outline; full for filled

Example

{
  "cmd": "draw_circle",
  "args": {
    "x": 45,
    "y": 95,
    "radius": 20,
    "color": "red",
    "width": "1x1",
    "fill": "empty"
  }
}

Behavior

The center plus and minus the radius must be within the display on both axes. A circle crossing the display boundary is rejected. Width controls the outline mode; the filled-circle implementation uses single-pixel points regardless of the requested width.

See Command Reference, Color Palette, and Renderer Notes.

Implementation references

• Arduino/src/core/command/draw_circle.cpp
• Arduino/src/canvas/gui_paint.cpp