How to Read Images in OpenCV Using Python

Reading an image is the first practical step in every computer vision and image processing project. Before applying filters, detecting faces, recognizing objects, or performing image transformations, you must first load the image into your Python program. OpenCV provides a simple yet powerful function called cv2.imread() that allows you to read images from your computer and store them as NumPy arrays.

In this lesson, you will learn how to read images using OpenCV, understand different image reading modes, verify whether an image has been loaded successfully, and explore how OpenCV internally stores image data.

What is cv2.imread()?

The cv2.imread() function is used to load an image from a file. It reads the image stored on your computer and converts it into a NumPy array that can be processed using OpenCV functions.

Syntax:

cv2.imread(filename, flags)

Parameters:

• filename – Path to the image file.
• flags – Specifies how the image should be loaded.

Return Value:

If the image is loaded successfully, OpenCV returns a NumPy array. If the file cannot be found or opened, it returns None.

Reading an Image

The simplest way to load an image is by providing its filename.

import cv2

image = cv2.imread("sample.jpg")

If sample.jpg exists in the current working directory, OpenCV will load it successfully.

Checking Whether the Image Loaded Successfully

Always verify that the image has been loaded before performing any operations. Attempting to process a missing image will result in errors.

import cv2

image = cv2.imread("sample.jpg")

if image is None:
    print("Error: Image not found.")
else:
    print("Image loaded successfully.")

Checking for None is considered a best practice in every OpenCV program.

Understanding File Paths

OpenCV can read images using either relative paths or absolute paths.

Relative Path

image = cv2.imread("images/sample.jpg")

The file is searched relative to the current project folder.

Absolute Path

image = cv2.imread("C:/Users/Student/Pictures/sample.jpg")

An absolute path specifies the exact location of the image on your computer.

Using forward slashes (/) is recommended because they work consistently across platforms and avoid escaping issues in Python strings.

How OpenCV Stores Images

When an image is loaded, OpenCV stores it as a multidimensional NumPy array. Each element in the array represents a pixel value.

import cv2

image = cv2.imread("sample.jpg")

print(type(image))

Output:

<class 'numpy.ndarray'>

This integration with NumPy makes OpenCV both efficient and flexible for image manipulation.

Finding Image Dimensions

You can determine the height, width, and number of color channels using the shape attribute.

import cv2

image = cv2.imread("sample.jpg")

print(image.shape)

Example output:

(720, 1280, 3)

The values represent:

• Height = 720 pixels
• Width = 1280 pixels
• Channels = 3 (Blue, Green, Red)

Common Reasons Why Images Fail to Load

• The filename is incorrect.
• The image is stored in a different folder.
• The file extension is incorrect.
• The image file is corrupted.
• The path contains typing errors.

Always verify the file path before debugging OpenCV code.

Best Practices When Reading Images

• Always check whether the image is None.
• Keep images inside a dedicated images folder.
• Use meaningful filenames.
• Prefer relative paths for portable projects.
• Verify image dimensions before processing.

Summary

In this lesson, you learned how to read images using cv2.imread(), verify successful loading, understand file paths, inspect image dimensions, and see how OpenCV stores images as NumPy arrays. In the next part, you will learn how to display images using OpenCV and Matplotlib, along with the differences between the two visualization methods.

Displaying Images in OpenCV

After reading an image successfully, the next step is to display it on the screen. Visualizing images helps you verify that they have been loaded correctly and allows you to observe the effects of image processing operations such as resizing, filtering, cropping, edge detection, and color conversion.

OpenCV provides the cv2.imshow() function to display images in a separate window. In Data Science and Machine Learning projects, developers also use Matplotlib to display images directly inside Jupyter Notebook.

The cv2.imshow() Function

The cv2.imshow() function creates a window and displays the specified image.

Syntax:

cv2.imshow(window_name, image)

Parameters:

• window_name – The title of the display window.
• image – The image object loaded using cv2.imread().

Example:

import cv2

image = cv2.imread("sample.jpg")

cv2.imshow("Original Image", image)

cv2.waitKey(0)

cv2.destroyAllWindows()

This program opens a new window displaying the image until a key is pressed.

Understanding cv2.waitKey()

The cv2.waitKey() function pauses the program and waits for keyboard input. Without this function, the image window will close immediately because the program finishes execution.

Example:

cv2.waitKey(0)

A value of 0 means the program waits indefinitely until any key is pressed.

You can also specify a time in milliseconds.

cv2.waitKey(5000)

The above example waits for 5 seconds before continuing execution.

Closing Image Windows

After displaying an image, it is good practice to close all OpenCV windows using:

cv2.destroyAllWindows()

This releases system resources and closes every OpenCV window currently open.

To close only a specific window:

cv2.destroyWindow("Original Image")

Displaying Multiple Images

OpenCV allows you to display multiple images simultaneously by assigning different window names.

import cv2

image1 = cv2.imread("sample.jpg")
image2 = cv2.imread("sample2.jpg")

cv2.imshow("Image One", image1)
cv2.imshow("Image Two", image2)

cv2.waitKey(0)

cv2.destroyAllWindows()

Displaying Images in Jupyter Notebook

The cv2.imshow() function may not work properly in Jupyter Notebook because notebooks run inside a web browser. In these cases, Matplotlib is the preferred visualization library.

Example:

import cv2
import matplotlib.pyplot as plt

image = cv2.imread("sample.jpg")

rgb = cv2.cvtColor(image, cv2.COLOR_BGR2RGB)

plt.imshow(rgb)
plt.title("Original Image")
plt.axis("off")

plt.show()

Notice that the image is converted from BGR to RGB before displaying it. This ensures that colors appear correctly in Matplotlib.

OpenCV vs Matplotlib

Common Display Errors

Image Window Closes Immediately

Cause: Missing cv2.waitKey().

Solution:

cv2.waitKey(0)

Colors Look Incorrect

Cause: OpenCV loads images in BGR format, while Matplotlib expects RGB.

Solution:

image = cv2.cvtColor(image, cv2.COLOR_BGR2RGB)

No Window Appears

Possible reasons include an incorrect image path, unsupported environment, or using cv2.imshow() inside Jupyter Notebook.

Best Practices

• Use cv2.imshow() for desktop applications.
• Use Matplotlib when working in Jupyter Notebook.
• Always call cv2.waitKey() after displaying an image.
• Close windows using cv2.destroyAllWindows().
• Convert BGR images to RGB before displaying them with Matplotlib.
• Verify that the image loaded successfully before displaying it.

Summary

In this lesson, you learned how to display images using cv2.imshow(), understood the role of cv2.waitKey() and cv2.destroyAllWindows(), displayed multiple images, and learned why Matplotlib is the preferred choice for Jupyter Notebook. You also explored common display errors and best practices. In the next part, you will learn how to save images using cv2.imwrite(), explore different image formats and reading modes, and complete the lesson with FAQs and practice exercises.

Saving Images Using OpenCV

After processing an image, you will usually want to save the result for later use. Whether you have resized an image, converted it to grayscale, applied filters, or detected objects, OpenCV provides a simple function called cv2.imwrite() to write images to your computer.

The cv2.imwrite() function saves the image in various formats such as JPEG, PNG, BMP, TIFF, and WebP. The output format is automatically determined from the file extension that you specify.

Syntax of cv2.imwrite()

cv2.imwrite(filename, image)

Parameters:

• filename – Name or path of the output image.
• image – The NumPy array representing the image.

Return Value:

The function returns True if the image is saved successfully and False if the operation fails.

Saving an Image

The following example saves the loaded image as a PNG file.

import cv2

image = cv2.imread("sample.jpg")

success = cv2.imwrite("output.png", image)

if success:
    print("Image saved successfully.")
else:
    print("Failed to save the image.")

Saving a Grayscale Image

You can also save processed images such as grayscale versions.

import cv2

image = cv2.imread("sample.jpg")

gray = cv2.cvtColor(image, cv2.COLOR_BGR2GRAY)

cv2.imwrite("gray_image.jpg", gray)

Common Image Formats

Understanding Image Reading Modes

The cv2.imread() function accepts an optional flag that controls how an image is loaded.

IMREAD_COLOR

image = cv2.imread("sample.jpg", cv2.IMREAD_COLOR)

Loads the image in color using the BGR color space. This is the default mode.

IMREAD_GRAYSCALE

image = cv2.imread("sample.jpg", cv2.IMREAD_GRAYSCALE)

Loads the image as a single-channel grayscale image, reducing memory usage and processing time.

IMREAD_UNCHANGED

image = cv2.imread("sample.png", cv2.IMREAD_UNCHANGED)

Loads the image without changing its original format, including the alpha (transparency) channel if present.

Choosing the Correct Reading Mode

JPEG vs PNG

Best Practices

• Always verify that the image loaded successfully before processing.
• Choose PNG when image quality is more important than file size.
• Use JPEG for photographs to reduce storage requirements.
• Store input and output images in separate folders.
• Use meaningful filenames for processed images.
• Check the return value of cv2.imwrite() to ensure the image was saved.

Frequently Asked Questions (FAQs)

Why does cv2.imwrite() return False?

This usually indicates an invalid file path, missing write permissions, or an unsupported file format.

Which image format should I use?

JPEG is suitable for photographs, while PNG is preferred for graphics, diagrams, and images requiring transparency or lossless quality.

Can OpenCV read transparent PNG images?

Yes. Use cv2.IMREAD_UNCHANGED to preserve the alpha channel.

Does OpenCV support WebP images?

Most modern OpenCV builds support WebP, provided the library was compiled with WebP support.

Key Takeaways

• Use cv2.imread() to load images.
• Use cv2.imshow() or Matplotlib to display images.
• Use cv2.imwrite() to save processed images.
• OpenCV supports multiple image formats including JPEG, PNG, BMP, TIFF, and WebP.
• Choose the appropriate reading mode based on your application.
• Always validate file paths and check for successful read/write operations.

Practice Exercises

1. Load a color image and verify that it was loaded successfully.
2. Display the image using cv2.imshow().
3. Display the same image in Jupyter Notebook using Matplotlib.
4. Convert the image to grayscale and save it as gray_output.jpg.
5. Save the original image as a PNG file.
6. Load the same image using IMREAD_GRAYSCALE and compare its dimensions with the color version.
7. Load a PNG image using IMREAD_UNCHANGED and inspect its number of channels.
8. Compare the file sizes of JPEG and PNG versions of the same image.
9. Create separate images and outputs folders for your project.
10. Write a program that reads an image, converts it to grayscale, displays it, and saves the result.

Lesson Summary

In this lesson, you learned how to read, display, and save images using OpenCV. You explored the cv2.imread(), cv2.imshow(), cv2.waitKey(), cv2.destroyAllWindows(), and cv2.imwrite() functions, understood different image reading modes, compared common image formats, and learned best practices for managing image files. These essential skills form the foundation for every OpenCV project. In the next lesson, you will begin performing basic image operations such as resizing, cropping, rotating, and flipping images.