计算机视觉 / 系统课时

绘制圆形与多边形

绘制圆形与多边形

圆、椭圆和多边形比矩形多了半径、长短轴、旋转角度和顶点集合等参数。本课用 OpenCV 4.x 在同一画布上完成轮廓与填充绘制,并说明椭圆轴长和多边形点集最容易写错的地方。

学习目标

  • 使用 cv2.circle、cv2.ellipse 和 cv2.polylines 绘制基础形状
  • 正确设置圆心、半径、椭圆半轴、角度和多边形顶点
  • 使用 thickness=-1 与 cv2.fillPoly 控制填充效果

圆心、半轴与角度

cv2.circle 需要圆心 (x,y) 和半径,例如中心 (90,80)、radius=45。cv2.ellipse 的 axes=(55,30) 表示两个半轴长度,而不是完整宽高,因此该椭圆未旋转时总体尺寸约为 110×60 像素。

椭圆的 angle 控制整体旋转角度,startAngle 和 endAngle 控制绘制的弧段。需要完整椭圆时使用 startAngle=0、endAngle=360;例如 0~180 只绘制约半圈弧线。

圆形椭圆与多边形参数关系

绘制圆、椭圆和多边形

下面示例创建 420×300 的浅色画布:上方依次绘制空心圆、实心圆和椭圆弧,下方绘制一个五边形轮廓以及一个带边框的实心多边形。多边形顶点显式转换为 np.int32,避免浮点坐标导致接口报错。

python
import cv2
import numpy as np

image = np.full((300, 420, 3), 245, dtype=np.uint8)

# 空心圆与实心圆
cv2.circle(image, (80, 75), 42, (0, 0, 220), 3, cv2.LINE_AA)
cv2.circle(image, (200, 75), 34, (0, 170, 0), -1, cv2.LINE_AA)

# axes 是半轴长度;0 到 300 度故意留出一段缺口
cv2.ellipse(
    image,
    (330, 80),
    (55, 30),
    25,
    0,
    300,
    (220, 80, 0),
    3,
    cv2.LINE_AA,
)

# 五边形轮廓,reshape 后得到 OpenCV 常用的 N×1×2 点集
outline = np.array(
    [[45, 185], [120, 160], [175, 215], [115, 270], [50, 235]],
    dtype=np.int32,
).reshape((-1, 1, 2))
cv2.polylines(image, [outline], True, (120, 40, 180), 3, cv2.LINE_AA)

# 需要“填充 + 边框”时,先 fillPoly,再 polylines
filled = np.array(
    [[235, 175], [350, 175], [390, 245], [275, 270]],
    dtype=np.int32,
).reshape((-1, 1, 2))
cv2.fillPoly(image, [filled], (0, 200, 255))
cv2.polylines(image, [filled], True, (40, 40, 40), 2, cv2.LINE_AA)

saved = cv2.imwrite("circle_polygon.png", image)
print(f"saved={saved}, shape={image.shape}, polygon_points={len(outline)}")

预期输出

text
saved=True, shape=(300, 420, 3), polygon_points=5

图片上方应出现红色圆环、绿色实心圆和带缺口的蓝色椭圆弧;下方左侧是五边形轮廓,右侧是黄色填充并带深色边框的四边形。实际颜色仍遵循 OpenCV 的 BGR 通道顺序。

控制填充与边框

对 cv2.circle、cv2.ellipse 和 cv2.rectangle,thickness=-1 表示填充内部,正整数则表示边框宽度。例如半径 40 的圆使用 thickness=3 时得到约 3 像素边框,改成 -1 后整个圆盘都会着色。

多边形通常使用 cv2.fillPoly 负责填充,再调用 cv2.polylines 补边框。这样可以分别指定填充色和边框色,也能独立控制边框粗细。只调用 cv2.polylines 不会把多边形内部填满。

组织多边形顶点

多边形顶点必须按轮廓顺序排列。若顶点顺序在图形内部来回跳跃,例如先放左上、再右下、再右上,边线可能相互交叉。对于一个普通凸五边形,应沿顺时针或逆时针依次提供各顶点。

常用做法是创建 dtype=np.int32 的 N×2 数组,再通过 reshape((-1,1,2)) 转换为明确的点集形状。cv2.polylines 的 isClosed=True 会自动连接最后一个点与第一个点;设为 False 时则得到折线而不是闭合多边形。

典型参数错误

如果期望绘制 120×60 的椭圆,却把 axes=(120,60) 传给 cv2.ellipse,最终尺寸会接近 240×120;正确的半轴应写成 (60,30)。这是椭圆绘制中最常见的尺寸翻倍问题。

多边形出现异常时优先检查三项:顶点是否按轮廓顺序排列、数组是否为整数坐标、isClosed 是否符合需求。需要同时获得填充和清晰边框时,采用“先 cv2.fillPoly、后 cv2.polylines”的两步方式最容易控制最终效果。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

绘制圆形与多边形

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通