博客

当你在使用 PIL （Python 图像库）处理图像时，getcolors() 方法可以帮助你获取图像中出现过的所有颜色及其数量。该方法的使用也非常简单，下面是详细介绍。

语法

Image.getcolors(maxcolors=256, palette=None, colors=None)

参数

• maxcolors：最大颜色数，缺省值为256（表示最多获取256种颜色）；
• palette：指定一个存有文件格式（如SUN或X11）或名称列表的调色板；
• colors：指定一个列表（或数组）作为颜色。

返回值

• 返回一个由 (count, color) 元组构成的列表，其中 count 是对象图像中出现该颜色（color）的次数。

示例说明

示例一：获取图像中出现的颜色及其数量

下面的示例代码演示了如何获取一张图片中出现的颜色及其数量：

from PIL import Image

# 打开一张图片
img = Image.open("example.png")

# 获取图片每个像素的颜色及出现次数
color_counts = img.getcolors()

# 打印每个颜色及出现次数
for count, color in color_counts:
    print(f"Color {color} appears {count} times")

在该示例中，我们通过 Image.open() 打开了一张名为 “example.png” 的图片，然后使用 getcolors() 方法获取了图片每个像素的颜色及出现次数。最后，通过一个 for 循环打印了每个颜色及它的出现次数。

示例2：设定最大颜色数获取颜色及其数量

当图片非常大时，并不需要获取所有的颜色和它们的数量，因为这会浪费很多内存。下面的示例演示了如何通过设定 maxcolors 参数来获取指定颜色数量的计数：

from PIL import Image

# 打开一张图片
img = Image.open("example.png")

# 获取前20种出现次数最多的颜色
max_colors = 20
color_counts = img.getcolors(maxcolors=max_colors)

# 打印每个颜色及出现次数
for count, color in color_counts:
    print(f"Color {color} appears {count} times")

在该示例中，我们通过 img.getcolors(maxcolors=max_colors) 获取前20种出现次数最多的颜色及其数量。需要注意的是，该方法仅返回出现次数最多的20种颜色，相比于获取所有的颜色及其数量，可以有效降低内存使用。