vidgear项目PiGear API使用指南：Raspberry Pi相机模块开发全解析-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00187/article/details/148575919

vidgear项目PiGear API使用指南：Raspberry Pi相机模块开发全解析

vidgear A High-performance cross-platform Video Processing Python framework powerpacked with unique trailblazing features :fire: 项目地址: https://gitcode.com/gh_mirrors/vi/vidgear

前言

在物联网和嵌入式视觉应用开发中，Raspberry Pi因其出色的性价比和丰富的扩展能力成为首选平台。而vidgear项目中的PiGear API则为Raspberry Pi相机模块提供了高度优化的Python接口，极大简化了视频流处理流程。本文将全面解析PiGear API的使用方法，帮助开发者快速掌握这一强大工具。

PiGear API简介

PiGear是vidgear项目中专为Raspberry Pi相机模块设计的视频流处理API，具有以下核心特性：

双后端支持：同时兼容新一代picamera2和传统picamera库
硬件加速：充分利用Raspberry Pi的GPU资源
实时处理：低延迟视频流捕获和处理能力
跨平台：支持多种Linux发行版

基础使用

准备工作

在使用PiGear前，需确保：

已完成Raspberry Pi相机模块的硬件连接和系统配置
已安装vidgear库及其依赖项

最小示例代码

from vidgear.gears import PiGear
import cv2

# 初始化视频流
stream = PiGear().start()

while True:
    frame = stream.read()
    if frame is None:
        break
        
    # 在此处添加帧处理逻辑
    
    cv2.imshow("Output", frame)
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

# 释放资源
cv2.destroyAllWindows()
stream.stop()

这段代码展示了PiGear的最基本用法，实现了：

相机初始化
连续帧捕获
实时显示
资源释放

高级配置

使用picamera2后端

PiGear默认优先使用picamera2后端，该后端提供了更丰富的配置选项：

from vidgear.gears import PiGear
from libcamera import Transform
import cv2

# 高级配置参数
options = {
    "queue": True,  # 启用帧队列
    "buffer_count": 4,  # 缓冲区数量
    "controls": {"Brightness": 0.5, "ExposureValue": 2.0},  # 相机控制
    "transform": Transform(hflip=1),  # 水平翻转
    "sensor": {"output_size": (480, 320)},  # 传感器输出尺寸
}

stream = PiGear(resolution=(640,480), framerate=60, logging=True, **options).start()

# 处理循环...

关键配置参数说明：

queue: 启用帧缓冲队列，提高稳定性
buffer_count: 设置缓冲区数量，影响内存占用和延迟
controls: 实时相机参数控制
transform: 图像变换操作
sensor: 传感器级配置

使用传统picamera后端

当picamera2不可用时，PiGear会自动回退到picamera后端：

options = {
    "hflip": True,  # 水平翻转
    "exposure_mode": "auto",  # 自动曝光
    "iso": 800,  # ISO感光度
    "exposure_compensation": 15,  # 曝光补偿
    "awb_mode": "horizon",  # 白平衡模式
}

色彩空间处理

PiGear支持实时色彩空间转换，极大简化了计算机视觉预处理流程：

# 初始化HSV色彩空间
stream = PiGear(colorspace="COLOR_BGR2HSV").start()

while True:
    frame = stream.read()
    
    # 按键切换色彩空间
    key = cv2.waitKey(1) & 0xFF
    if key == ord('w'):
        stream.color_space = cv2.COLOR_BGR2GRAY  # 切换至灰度
    elif key == ord('e'):
        stream.color_space = cv2.COLOR_BGR2LAB   # 切换至LAB
    elif key == ord('s'):
        stream.color_space = None                # 恢复默认BGR

与WriteGear集成

PiGear可以无缝对接vidgear的WriteGear模块，实现视频捕获和编码的一体化处理：

from vidgear.gears import WriteGear

# 初始化写入器
writer = WriteGear(output="output.mp4", 
                  **{"-vcodec":"libx264", "-crf":0, "-preset":"fast"})

while True:
    frame = stream.read()
    gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
    writer.write(gray)  # 写入处理后的帧