Draw a circle to the current image

2.7M Downloads / Month

Open Source MIT License

You are viewing the documentation for Intervention Image 2, this version has reached EOL. Please consider upgrading to version 3.

public Intervention\Image\Image circle(integer $diameter, integer $x, integer $y, [Closure $callback])

Draw a circle at given x, y, coordinates with given diameter. You can define the appearance of the circle by an optional closure callback.



Diameter of the circle in pixels.


x-coordinate of the center.


y-coordinate of the center.

callback (optional)

Define appearance of circle. See examples below. Use the following methods to pass details.

public Intervention\Image\AbstractShape background(string $color)

Define the background-color of the circle in one of the available color formats.

public Intervention\Image\AbstractShape border(integer $width, string $color)

Define the border of the circle. Set width as pixels in the first and the border-color in one of the available color formats as second parameter.

Return Values

Instance of Intervention\Image\Image


// create empty canvas with background color
$img = Image::canvas(300, 200, '#ddd');

// draw a filled blue circle
$img->circle(100, 50, 50, function ($draw) {

// draw a filled blue circle with red border
$img->circle(10, 100, 100, function ($draw) {
    $draw->border(1, '#f00');

// draw an empty circle with 5px border
$img->circle(70, 150, 100, function ($draw) {
    $draw->border(5, '000000');

See also