---
application: "Intervention Image"
version: "Version 2"
status: "eol"
---

# Image::circle

## Draw a circle to the current image



> 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.

### Parameters

#### diameter
Diameter of the circle in pixels.

#### pos_x
x-coordinate of the center.

#### pos_y
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](https://image.intervention.io/v2/getting-started/formats.md).


> 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](https://image.intervention.io/v2/getting-started/formats.md) as second parameter.

### Return Values
Instance of `Intervention\Image\Image`

### Examples

```php
// 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->background('#0000ff');
});

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

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


### See also

- [pixel](https://image.intervention.io/v2/api/pixel.md)
- [line](https://image.intervention.io/v2/api/line.md)
- [rectangle](https://image.intervention.io/v2/api/rectangle.md)
- [ellipse](https://image.intervention.io/v2/api/ellipse.md)
- [polygon](https://image.intervention.io/v2/api/polygon.md)

---

## Become a Sponsor

### Intervention Image needs your help to keep the project going

Intervention Image is non-commercial, open source licensed and completely free to use. The considerable
effort required to maintain and develop the software is only possible with the financial support
of sponsors. There are two ways in which you can support this project.

- Support via [GitHub Sponsors](https://github.com/sponsors/Intervention)
- Support via [Ko-Fi](https://ko-fi.com/interventionphp)