OpenCV cv2.rectangle() method

Syntax of OpenCV cv2.rectangle() Method

The syntax of the OpenCV cv2.rectangle() method is as follows:

Parameters of OpenCV cv2.rectangle() Method

The cv2.rectangle() takes several parameters, including the image on which the rectangle is to be drawn, the coordinates of the top-left and bottom-right corners of the rectangle, the color of the rectangle, and the thickness of the lines.

The cv2.rectangle() method takes the following parameters:

Return Value of OpenCV cv2.rectangle() Method

When the cv2.rectangle() method is called, it modifies the input image by drawing a rectangle on it according to the specified parameters. The rectangle will appear on the specified position of the image with the specified color and thickness. The output of the function is the modified image with the rectangle drawn on it.

Here are some points to summarize the output of the cv2.rectangle() method:

• The cv2.rectangle() method modifies the input image by drawing a rectangle on it according to the specified parameters.
• The rectangle will appear on the specified position of the image with the specified color and thickness.
• The output of the function is the modified image with the rectangle drawn on it.
• The cv2.rectangle() method does not return anything explicitly.
• The modified image can be saved or displayed using other functions in the OpenCV library.

Exceptions of OpenCV cv2.rectangle() Method

The cv2.rectangle() method may raise the cv2.error exception when an error occurs while processing the image. Specifically, this exception is raised if the image provided to the method is not valid or has some issues that prevent the method from drawing a rectangle on it.

There are several reasons why the cv2.error exception may be raised when using the cv2.rectangle() method. For example:

• The image file provided may not exist or may be corrupted.
• The image may not be in a compatible format, such as not being a valid image file or being in an unsupported color space.
• The image may be of an unsupported size, such as being too large or too small to be processed by the method.
• When the cv2.error exception is raised, the program will terminate and an error message will be displayed indicating the nature of the error.

To prevent this exception, ensure that the image provided is in a supported format, such as .jpg, .png, or .bmp. Additionally, make sure that the image file exists and can be read by the cv2.imread() method.

How does the OpenCV cv2.rectangle() Method Work?

Under the hood, cv2.rectangle() uses the same low-level drawing functions as other OpenCV drawing methods, such as cv2.line() and cv2.circle(). These functions take the coordinates of the points to be connected and then calculate the color and thickness of the line segment based on the parameters provided. The result is a modified image with the desired shape drawn on it.

Step 1: Import the OpenCV Library and load the image

This code imports the OpenCV library and loads an image named 'testimage.jpg' using the cv2.imread() method, assigning it to the variable 'image'.

Step 2: Define the measurements of the rectangle

This code defines the points of a rectangle to be drawn on the image. The height, width, and number of channels of the image are determined using the image.shape attribute. The start_point and end_point variables define the top-left and bottom-right corners of the rectangle, respectively. The color variable defines the RGB color of the rectangle, and the thickness variable defines the thickness of the rectangle's border in pixels.

Step 3: Call the cv2.rectangle() method

This code calls the cv2.rectangle() method with the specified parameters to draw a rectangle on the loaded image. The modified image with the rectangle drawn on it is then reassigned to the 'image' variable.

Step 4: Display the output

This code displays the modified image with the rectangle drawn on it using the cv2.imshow() method. The first argument is the title of the window, and the second argument is the modified image. The image is displayed until the user presses a key or closes the window.

Output:

Original Image without Rectangle

Output Image with Rectangle

Examples

Here are three examples of using the OpenCV cv2.rectangle() method:

Example 1

Let's implement the code to draw a blue rectangle with a thickness of 2 pixels at the coordinates (100, 100) and (300, 200) on an image named img1.jpg.

Output

Input Image

Output Image

Example 2

Let's implement the code to draw a red rectangle with a thickness of 1 pixel at the coordinates (50, 50) and (150, 150) on a black background image.

Output

Input Image

Output Image

Example 3

Let's implement the code to draw a green rectangle with a thickness of 5 pixels at the coordinates (200, 200) and (400, 300) on a grey background image.

Output

Input Image

Output Image

See Also

OpenCV documentation: https://docs.opencv.org/master/d6/d6e/group__imgproc__draw.html#ga07d2f74cadcf8e305e810ce8eed13bc9

Tutorial on drawing shapes in OpenCV: https://docs.opencv.org/master/dc/da5/tutorial_py_drawing_functions.html