Python OpenCV | cv2.circle() method

Last Updated : 04 Jan, 2023

OpenCV-Python is a library of Python bindings designed to solve computer vision problems. cv2.circle() method is used to draw a circle on any image. The syntax of cv2.circle() method is:

Syntax:

cv2.circle(image, center_coordinates, radius, color, thickness)

Parameters:

image: It is the image on which the circle is to be drawn.
center_coordinates: It is the center coordinates of the circle. The coordinates are represented as tuples of two values i.e. (X coordinate value, Y coordinate value).
radius: It is the radius of the circle.
color: It is the color of the borderline of a circle to be drawn. For BGR, we pass a tuple. eg: (255, 0, 0) for blue color.
thickness: It is the thickness of the circle border line in px. Thickness of -1 px will fill the circle shape by the specified color.

Return Value: It returns an image.

The steps to create a circle on an image are:

Read the image using imread() function.
Pass this image to the cv2.circle() method along with other parameters such as center_coordinates, radius, color and thickness.
Display the image using cv2.imshow() method.

Implementation:

Image used for all the below examples:

Example #1:

Python3

# Python program to explain cv2.circle() method 
  
# importing cv2 
import cv2 
  
# path 
path = r'C:\Users\Rajnish\Desktop\geeksforgeeks\geeks.png'
  
# Reading an image in default mode
image = cv2.imread(path)
  
# Window name in which image is displayed
window_name = 'Image'
 
# Center coordinates
center_coordinates = (120, 50)

# Radius of circle
radius = 20
 
# Blue color in BGR
color = (255, 0, 0)
 
# Line thickness of 2 px
thickness = 2
 
# Using cv2.circle() method
# Draw a circle with blue line borders of thickness of 2 px
image = cv2.circle(image, center_coordinates, radius, color, thickness)
 
# Displaying the image 
cv2.imshow(window_name, image)

Output:

Example #2: Using thickness of -1 px to fill the circle with red color.

Python3

# Python program to explain cv2.circle() method 
  
# importing cv2 
import cv2 
  
# path 
path = r'C:\Users\Rajnish\Desktop\geeksforgeeks\geeks.png'
  
# Reading an image in default mode
image = cv2.imread(path)
  
# Window name in which image is displayed
window_name = 'Image'
 
# Center coordinates
center_coordinates = (120, 100)

# Radius of circle
radius = 30
 
# Red color in BGR
color = (0, 0, 255)
 
# Line thickness of -1 px
thickness = -1
 
# Using cv2.circle() method
# Draw a circle of red color of thickness -1 px
image = cv2.circle(image, center_coordinates, radius, color, thickness)
 
# Displaying the image 
cv2.imshow(window_name, image)

Output:

Example # 3: To display a circle on a black screen created using NumPy library.

Python3

import cv2
import numpy as np
   

# Reading an image in default mode
Img = np.zeros((512, 512, 3), np.uint8)
   
# Window name in which image is displayed
window_name = 'Image'
  
# Center coordinates
center_coordinates = (220, 150)
 
# Radius of circle
radius = 100
  
# Red color in BGR
color = (255, 133, 233)
  
# Line thickness of -1 px
thickness = -1
  
# Using cv2.circle() method
# Draw a circle of red color of thickness -1 px
image = cv2.circle(Img, center_coordinates, radius, color, thickness)
  
# Displaying the image
cv2.imshow(window_name, image)
cv2.waitKey(0)
cv2.destroyAllWindows()

Output:

Python OpenCV | cv2.rectangle() method

Rajnis09

Improve

Article Tags :

Practice Tags :

python

Python OpenCV | cv2.circle() method

Similar Reads

Getting Started

Working with Images - Getting Started

Working with Images - Image Processing

Working with Images - Feature Detection and Description

Working with Images - Drawing Functions

Working with Videos

Applications and Projects

OpenCV Projects