getpixel() 函数并不是 Python 的内置函数，它属于 Pillow 库（PIL, Python Imaging Library）中的 Image 对象，Pillow 是 Python 中最常用、最强大的图像处理库。
getpixel() 是什么？
getpixel() 方法用于获取图像中指定坐标（像素点）的颜色值。
语法:
image.getpixel((x, y))
参数:
(x, y): 一个包含两个整数的元组或列表，代表像素的坐标。x: 横坐标（列），从图像的 左边 开始，从 0 开始计数。y: 纵坐标（行），从图像的 上边 开始，从 0 开始计数。
返回值: 返回一个元组，表示该像素点的颜色,元组中的元素数量和类型取决于图像的模式：
- 对于 "L" 模式（灰度图）: 返回一个整数，代表灰度值（0-255）。
- 对于 "RGB" 模式（真彩色图）: 返回一个包含三个整数的元组
(R, G, B)，每个整数的范围是 0-255。 - 对于 "RGBA" 模式（带透明度的真彩色图）: 返回一个包含四个整数的元组
(R, G, B, A)，每个整数的范围是 0-255。
如何使用 getpixel()？ (分步指南)
第一步：安装 Pillow 库
如果你的 Python 环境中还没有安装 Pillow，请先打开终端或命令行工具,运行以下命令进行安装：
pip install Pillow
第二步：导入并打开图像
使用 PIL.Image 模块中的 open() 函数来打开一个图像文件，这会返回一个 Image 对象。
from PIL import Image
# 打开一个图像文件
# 请确保你的项目目录下有 'example.jpg' 这张图片
try:
img = Image.open('example.jpg')
print(f"图像模式: {img.mode}")
print(f"图像尺寸: {img.size}")
except FileNotFoundError:
print("错误：找不到 'example.jpg' 文件，请确保图片在正确的路径下。")
# 为了让代码能继续运行，我们创建一个示例图像
img = Image.new('RGB', (100, 50), color = 'red')
print("已创建一个 100x50 的红色图像作为示例。")
第三步：使用 getpixel() 获取像素颜色
现在你可以调用 getpixel() 方法,并传入一个坐标元组。
# 假设我们的图像是 'RGB' 模式
# 获取位于 (10, 20) 的像素颜色
pixel_color = img.getpixel((10, 20))
print(f"坐标 (10, 20) 处的像素颜色是: {pixel_color}")
示例输出:
图像模式: RGB
图像尺寸: (800, 600)
坐标 (10, 20) 处的像素颜色是: (255, 0, 0) # 假设这个点是纯红色完整代码示例
这个例子会打开一张图片，获取其中心点的颜色,并将其打印出来。
from PIL import Image
# --- 1. 打开图像 ---
# 创建一个示例图像，方便没有图片的用户也能运行
try:
# 尝试打开用户提供的图片
img = Image.open('my_image.png')
print(f"成功打开图片: my_image.png")
except FileNotFoundError:
print("未找到 'my_image.png'，将使用一个示例图像。")
# 创建一个 200x200 的渐变图像
img = Image.new('RGB', (200, 200))
pixels = img.load()
for i in range(img.size[0]):
for j in range(img.size[1]):
pixels[i, j] = (i, j, 128) # (R, G, B) 颜色
# --- 2. 获取图像信息 ---
width, height = img.size
print(f"图片尺寸: 宽度={width}, 高度={height}")
print(f"图片模式: {img.mode}")
# --- 3. 使用 getpixel() 获取像素颜色 ---
# 计算中心点坐标
center_x = width // 2
center_y = height // 2
print(f"图片中心点坐标: ({center_x}, {center_y})")
# 获取中心点的颜色
center_pixel_color = img.getpixel((center_x, center_y))
print(f"中心点 ({center_x}, {center_y}) 的像素颜色是: {center_pixel_color}")
# --- 4. 处理不同模式 ---
if img.mode == 'L':
print("这是一个灰度图，颜色值是一个整数。")
elif img.mode == 'RGB':
print("这是一个 RGB 图像，颜色值是一个 (R, G, B) 元组。")
elif img.mode == 'RGBA':
print("这是一个 RGBA 图像，颜色值是一个 (R, G, B, A) 元组。")
# 显示图片
img.show()
重要注意事项
getpixel() 的性能问题
getpixel() 在循环中（例如遍历图像的每一个像素）非常慢，这是因为每次调用它都需要进行一次函数调用和坐标查找,这对于数百万个像素来说是巨大的开销。
不推荐的做法 (非常慢):
# 错误示范：性能极差！
for y in range(height):
for x in range(width):
color = img.getpixel((x, y))
# ... 对 color 进行处理 ...
高性能的替代方案：Image.load()
如果你需要高效地访问或修改像素，应该使用 Image.load() 方法，它会创建一个像素访问对象,让你可以像访问数组一样快速地读写像素。
推荐的做法 (非常快):
from PIL import Image
# 创建或打开图像
img = Image.new('RGB', (200, 200), 'blue')
pixels = img.load() # 获取像素访问对象
# 高效地读取和写入像素
print(pixels[10, 20]) # 快速读取 (10, 20) 处的颜色，输出: (0, 0, 255)
# 快速修改像素
pixels[50, 50] = (255, 0, 0) # 将 (50, 50) 处的像素设为红色
# 修改后的图像
img.show()
坐标系统
Pillow 使用的坐标系统是：
- 左上角为原点 (0, 0)。
x轴向右递增。y轴向下递增。
这与许多数学坐标系不同,但与计算机图形学的标准一致。
| 特性 | getpixel() |
Image.load() |
|---|---|---|
| 用途 | 获取单个像素颜色 | 高效地访问和修改像素 |
| 性能 | 慢，不适合循环 | 快，适合循环和批量处理 |
| 使用场景 | 偶尔、随机地检查某个像素点的颜色 | 需要遍历图像、进行图像分析、滤镜处理等 |
| 方法 | img.getpixel((x, y)) |
pixels = img.load() pixels[x, y] |
- 想知道 某一个 像素是什么颜色？用
getpixel()。 - 想对 所有 或 很多 像素进行操作？用
load()。
