ImageList Processing¶

This tutorial explains how multiple images can be handled and transformed with the ImageList class.

Note

All operations on an ImageList return a new ImageList. The original ImageList will not be changed.

Load data into an ImageList:¶

1. Load images via files in an ImageList:

In [1]:

from safeds.data.image.containers import ImageList

planes = ImageList.from_files(["data/plane.png", "data/small_plane.png"])
planes

from safeds.data.image.containers import ImageList planes = ImageList.from_files(["data/plane.png", "data/small_plane.png"]) planes

Out[1]:

2. Create an ImageList from multiple Image objects:

In [2]:

from safeds.data.image.containers import Image

plane = Image.from_file("data/plane.png")
small_plane = Image.from_file("data/small_plane.png")

ImageList.from_images([plane, small_plane])

from safeds.data.image.containers import Image plane = Image.from_file("data/plane.png") small_plane = Image.from_file("data/small_plane.png") ImageList.from_images([plane, small_plane])

Out[2]:

Process the image¶

1. Resize the images in the ImageList to have the width 200 and height 200:

In [3]:

planes.resize(200, 200)

planes.resize(200, 200)

Out[3]:

2. Convert the images in the ImageList to grayscale:

In [4]:

planes.convert_to_grayscale()

planes.convert_to_grayscale()

Out[4]:

3. Crop the images in the ImageList to be 200x200 with the top-left corner being at (115, 30):

In [5]:

planes.crop(x=115, y=30, width=200, height=200)

planes.crop(x=115, y=30, width=200, height=200)

Out[5]:

4. Flip the images in the ImageList horizontally (or vertically):

In [6]:

planes.flip_left_and_right()

planes.flip_left_and_right()

Out[6]:

5. Adjust the brightness of the images in the ImageList.

Giving a factor below 1 will result in darker images, a factor above 1 will return brighter images.

In [7]:

planes.adjust_brightness(1.5)

planes.adjust_brightness(1.5)

Out[7]:

6. Adjust the contrast of the images in the ImageList.

Giving a factor below 1 will decrease the contrast of the images, a factor above 1 will increase the contrast of the images.

In [8]:

planes.adjust_contrast(1.5)

planes.adjust_contrast(1.5)

Out[8]:

7. Adjust the color balance of the images in the ImageList.

A factor of 0 will return black and white images, a factor of 1 will return a copy of the original ImageList.

In [9]:

planes.adjust_color_balance(0.5)

planes.adjust_color_balance(0.5)

Out[9]: