类别 | 函数名 | 参数 | 功能 | 使用场景 | 经验值/注意事项 | 返回值 |
---|---|---|---|---|---|---|
图像 I/O | cv2.imread() |
filename (str): 文件路径。flags (int, 可选): 读取标志。常用值:* cv2.IMREAD_COLOR (默认): 读取彩色图像 (BGR)。* cv2.IMREAD_GRAYSCALE : 读取灰度图像。* cv2.IMREAD_UNCHANGED : 读取包含 Alpha 通道的图像。 |
读取图像文件。 | 加载图像进行处理、显示或分析。 | 确保文件路径正确,并根据需要选择合适的读取标志。如果文件不存在或无法读取,返回 None 。 |
Mat |
cv2.imwrite() |
filename (str): 文件路径。image (Mat): 要保存的图像。params (list, 可选): 编码参数 (例如,JPEG 的质量、PNG 的压缩级别)。 |
将图像保存到文件。 | 保存处理后的图像、生成结果图像。 | 确保文件路径和扩展名正确。params 参数取决于文件格式,例如 JPEG 的质量通常设置为 80-95。 |
bool | |
cv2.imshow() |
winname (str): 窗口名称。image (Mat): 要显示的图像。 |
在窗口中显示图像。 | 调试、可视化图像处理结果。 | 与 cv2.waitKey() 配合使用来控制显示时长。 |
None | |
cv2.waitKey() |
delay (int, 可选): 等待时间 (毫秒)。0 表示无限等待,直到按键。 |
等待按键事件。 | 与 cv2.imshow() 配合使用,控制图像显示时间,或等待用户交互。 |
返回值为按键的 ASCII 码 (如果按下了键),或者 -1 (如果超时)。 | int | |
图像基础操作 | cv2.cvtColor() |
src (Mat): 输入图像。code (int): 颜色空间转换代码。常用值:* cv2.COLOR_BGR2GRAY : BGR 转灰度。* cv2.COLOR_BGR2RGB : BGR 转 RGB。* cv2.COLOR_BGR2HSV : BGR 转 HSV。* cv2.COLOR_BGR2Lab : BGR 转 Lab。dst (Mat, 可选): 输出图像 (与 src 大小相同)。 |
颜色空间转换。 | 将图像转换为不同的颜色空间,以适应不同的处理算法或分析需求。例如,灰度图像通常用于边缘检测,HSV 空间更适合颜色分割。 | OpenCV 默认的颜色空间是 BGR,而不是 RGB。 | Mat |
cv2.resize() |
src (Mat): 输入图像。dsize (Size): 输出图像的大小 (宽度, 高度)。如果为 (0, 0),则根据 fx 和 fy 计算。fx (double, 可选): 水平方向的缩放因子。fy (double, 可选): 垂直方向的缩放因子。interpolation (int, 可选): 插值方法。常用值:* cv2.INTER_NEAREST : 最近邻插值。* cv2.INTER_LINEAR (默认): 双线性插值。* cv2.INTER_AREA : 区域插值 (缩小图像时效果较好)。* cv2.INTER_CUBIC : 双三次插值 (放大图像时效果较好)。* cv2.INTER_LANCZOS4 : Lanczos 插值。 |
调整图像大小。 | 缩放图像以适应显示、处理或模型输入要求。 |