PythonPIL绘制矩形框的常用方法总结

基础代码

from PIL import Image, ImageDraw

# 打开图片
img = Image.open('your_image.jpg')

# 创建绘图对象
draw = ImageDraw.Draw(img)

# 矩形坐标 (x1, y1, x2, y2)
coords = (23, 21, 69, 76)

# 画矩形框（红色，线宽2）
draw.rectangle(coords, outline='red', width=2)

# 保存图片
img.sa ve('output.jpg')
img.show()

效果说明

更多用法

1.填充矩形（实心）

draw.rectangle(coords, fill='blue', outline='red', width=2)

2.半透明矩形（Pillow 9.0+）

draw.rectangle(coords, fill=(255, 0, 0, 128), outline='red', width=2)
# RGBA，最后一个值是透明度 0-255

3.多种颜色样式

# 绿色虚线框
draw.rectangle(coords, outline='green', width=3)

# 黄色粗框
draw.rectangle(coords, outline='yellow', width=5)

# 白色细框
draw.rectangle(coords, outline='white', width=1)

完整示例（含新建图片）

from PIL import Image, ImageDraw

# 如果没有图片，可以新建一个
img = Image.new('RGB', (200, 200), color='white')
draw = ImageDraw.Draw(img)

# 画矩形
draw.rectangle((23, 21, 69, 76), outline='red', width=2)

img.sa ve('result.jpg')
img.show()

坐标示意

(23,21) ───────── (69,21)

│ │

│ 矩形区域 │

│ │

(23,76) ───────── (69,76)

提示：如果图片路径包含中文，建议用 Image.open(r'路径') 或处理编码问题。

知识扩展

在 Python 中，要用 PIL（准确来说是它的升级版 Pillow）绘制矩形框，操作其实非常直接。通过 ImageDraw.Draw 对象的 rectangle() 方法，寥寥几行代码就能搞定。

1. 安装 Pillow

pip install Pillow

2. 基本用法

from PIL import Image, ImageDraw
# 创建一个 400x300 的白色图像（RGB模式）
img = Image.new('RGB', (400, 300), color='white')
# 获取绘图上下文
draw = ImageDraw.Draw(img)
# 绘制矩形框：(x1, y1) 左上角，(x2, y2) 右下角
draw.rectangle((50, 50, 350, 250), outline='red', width=3)
# 显示或保存图像
img.show()
img.sa ve('rectangle.png')

3. 参数详解

rectangle(xy, fill=None, outline=None, width=1)

4. 示例：实心矩形 + 边框

draw.rectangle((50, 50, 150, 150), fill='lightblue', outline='black', width=3)

5. 示例：多个矩形，支持 RGBA 透明度

from PIL import Image, ImageDraw
img = Image.new('RGBA', (400, 300), color=(255,255,255,0))  # 透明背景
draw = ImageDraw.Draw(img)
# 半透明填充（需要 RGBA 模式）
draw.rectangle((30, 30, 180, 130), fill=(255,0,0,128), outline=(0,0,0,255))
draw.rectangle((200, 50, 350, 200), outline='green', width=4)
img.sa ve('rect_alpha.png')

6. 在现有图像上绘制矩形框（例如标注人脸）

from PIL import Image, ImageDraw
img = Image.open('photo.jpg')
draw = ImageDraw.Draw(img)
# 在坐标区域绘制红色框
draw.rectangle((120, 80, 250, 210), outline='red', width=5)
img.show()
img.sa ve('annotated.jpg')

7. 使用相对坐标（通过 bounding box）

# 对 PIL 图像对象本身获取宽度高度
width, height = img.size
left = width * 0.2
top = height * 0.2
right = width * 0.8
bottom = height * 0.8
draw.rectangle((left, top, right, bottom), outline='yellow', width=4)

总结

• 核心是 ImageDraw.Draw 的 rectangle() 方法。
• 可以自由指定颜色、边框宽度、是否填充。
• 支持 RGB / RGBA 颜色模式，实现透明或半透明效果。
• 配合 Image.new() 可以创建全新矩形图像，配合 Image.open() 可以在已有图片上标注。