Picamera2 是一个 Python 库,可以方便地访问树莓派的相机系统。 它适用于使用专用的扁平线直接连接到树莓派CSI连接器上的相机(如下图),不适用于其他类型的相机,尽管对 USB 相机的支持有限。

树莓派 python 深度相机_python

另外,尽量使用树莓派官方的摄像头Raspberry Pi camera V1, V2或者module 3 以及HQ camera. 第三方的摄像头虽然可能有更高的分辨率,比如某宝上的16M像素的CSI摄像头,它们目前虽支持特定版本的libcamera, 并可以运行一些特定版本libcamera的命令行,但目前并不支持Picamera2和最新版libcamera库,也就无法使用Python来控制摄像头。

Picamera2 建立在开源 libcamera 项目之上,它在Linux系统中支持复杂的相机系统。 Picamera2 直接使用 libcamera 提供的Python绑定,尽管 Picamera2 API 提供访问权限在更高的层次上。 大多数用户会发现它比 libcamera更容易用于树莓派应用程序,Picamera2 专门针对树莓派内置相机和成像硬件。
Picamera2 是旧版 PiCamera Python 库的替代品。 尽管其中许多功能的实现方式不同,但它提供大致相同的功能。 Picamera2提供了更直接、直观的树莓派相机系统,通过Python可以轻松使用它们。

要求

Picamera2 专为运行 Raspberry Pi OS 版本或 Raspberry Pi OS Lite 的系统而设计,应使用 Bullseye 或更新的镜像。 从Raspberry Pi 网站下载的当前镜像中都已经预装,可以使用Raspberry Pi Imager 工具安装镜像。 使用旧镜像的用户应考虑更新它们或根据提示安装。

Picamera2 可以以无界面方式运行,不需要连接屏幕或键盘。 当第一次设置系统时,建议尽可能连接键盘和屏幕,因为它可以更容易故障排除。Raspberry Pi OS Bullseye 和更高版本的镜像默认运行libcamera 相机堆栈,libcamera是 Picamera2 所必需的。

您可以通过打开命令窗口并键入以下命令来检查 libcamera 是否正常工作:

libcamera-hello

应该会看到大约五秒钟的相机预览窗口。 如果没有,请参考树莓派摄像头文档。

安装和更新

截至 2022 年 9 月中旬,所有 Raspberry Pi OS 映像中都预装了 Picamera2。 你可以通过完全的系统更新来更新Picamera2,或通过终端:

sudo apt install -y python3-picamera2