树莓派作为一款低成本、高性能的单板计算机，凭借其扩展性和灵活性，在创客、教育及物联网领域得到了广泛应用，树莓派摄像头模块（Camera Module）的加入，使其具备了图像采集和视频处理能力，可用于安防监控、机器人视觉、数据记录等多种场景，要充分发挥树莓派摄像头的功能，熟练掌握相关命令是关键，本文将详细介绍树 raspicam 命令行工具的使用方法，涵盖图像拍摄、视频录制、参数调整及常见问题处理，帮助用户快速上手并实现个性化功能。
树莓派摄像头准备工作
在使用摄像头前,需确保硬件连接和系统配置正确，将摄像头模块排线插入树莓派的CSI接口（位于HDMI接口旁边），注意排线金属触面朝向HDMI口，并确保插紧，随后，通过树莓派配置工具启用摄像头：打开终端，输入sudo raspi-config，选择“Interface Options”→“Camera”，勾启“Enable”，重启树莓派后，输入vcgencmd get_camera，若返回“supported=1 detected=1”，则表示摄像头已成功识别。
需安装摄像头相关工具,默认情况下，树莓派系统已预装raspistill（静态图像拍摄）和raspivid（视频录制）命令，若需更高级功能（如摄像头控制库），可安装libcamera工具包：
sudo apt update sudo apt install libcamera-tools
静态图像拍摄命令
raspistill是树莓派拍摄静态图像的核心命令，支持多种参数调整，可满足不同场景需求，其基本语法为：
raspistill [选项] -o 输出路径
基础拍摄
拍摄一张默认分辨率的图像并保存为image.jpg：
raspistill -o image.jpg
分辨率与格式调整
通过-width和-height设置分辨率（如1920×1080）：
raspistill -w 1920 -h 1080 -o fullhd.jpg
支持多种图像格式,如PNG（-e png）、BMP（-e bmp）等，例如拍摄PNG格式图像：
raspistill -e png -o image.png
图像质量与预览
调整图像质量（0-100，默认85，数值越高画质越好但文件越大）：
raspistill -q 95 -o high_quality.jpg
启用预览模式（-t设置预览时间，单位毫秒，0表示持续预览）：
raspistill -t 5000 -p 0,0,640,480 -o preview.jpg # 预览5秒，预览窗口大小640×480
特效与参数
摄像头支持多种特效,通过-fx启用，如灰度（grayscale）、负片（negative）、棕褐色（sketch）等：
raspistill -fx sketch -o sketch.jpg
调整曝光参数（如-ex设置曝光模式，-ss设置快门速度，单位微秒）：
raspistill -ex night -ss 1000000 -o night_shot.jpg # 夜间模式，快门1秒
延时拍摄与连拍
实现延时拍摄（如3秒后拍摄）：
raspistill -t 3000 -o delayed.jpg
连拍多张照片（-tl设置拍摄间隔，单位毫秒，-n拍摄数量）：
raspistill -tl 1000 -n 5 -o burst_%03d.jpg # 每秒1张，共5张，文件名依次为burst_000.jpg~burst_004.jpg
视频录制命令
raspivid用于录制视频，支持分辨率、帧率、编码格式等参数调整，基本语法为：
raspivid [选项] -o 输出路径
基础录制
录制10秒默认分辨率的视频（H.264编码），保存为video.h264：
raspivid -o video.h264 -t 10000
分辨率与帧率
设置1080p分辨率、30帧视频：
raspivid -w 1920 -h 1080 -fps 30 -o 1080p_30fps.h264
视频格式与编码
默认输出为H.264裸流，需使用ffmpeg转换为MP4格式（若系统未安装ffmpeg，需先执行sudo apt install ffmpeg）：
raspivid -o - -t 10000 | ffmpeg -i - -c:v copy -f mp4 output.mp4 # 实时转换为MP4
录制模式调整
启用预览模式（-p设置预览窗口位置和大小）：
raspivid -o preview_video.h264 -t 10000 -p 0,0,640,480
调整比特率（-b，单位bps，默认17000000）：
raspivid -b 8000000 -o low_bitrate.h264 -t 10000 # 降低比特率以减小文件大小
libcamera命令行工具（替代方案）
随着树莓派系统更新,libcamera逐渐成为摄像头控制的默认工具，功能更强大且支持更多新型号摄像头（如Camera Module v3），其基本命令如下：
拍摄静态图像
libcamera-still -o libcamera_image.jpg # 基础拍摄 libcamera-still --width 1920 --height 1080 -o libcamera_fullhd.jpg # 设置分辨率 libcamera-still --mode 1280x960 --fps 30 -o libcamera_custom.jpg # 自定义模式与帧率
录制视频
libcamera-vid -o libcamera_video.h264 -t 10000 # 录制10秒视频 libcamera-vid --width 1920 --height 1080 --fps 30 -o libcamera_1080p.h264
实时预览
libcamera-hello # 开启实时预览（按Ctrl退出）
常见问题与解决
- 摄像头未识别：检查排线是否插紧，运行
sudo raspi-config重新启用摄像头，或确认树莓派系统版本是否支持（需较新系统）。 - 图像模糊或过曝：调整
-ss（快门速度）和-gain（增益）参数，如raspistill -ss 50000 -gain 2 -o adjusted.jpg。
相关问答FAQs
Q1: 如何实现树莓派摄像头的定时拍照功能？
A1: 可结合cron任务计划工具实现，每分钟拍摄一张照片并保存到/home/pi/timed_photos/目录：
- 创建目录：
mkdir -p /home/pi/timed_photos - 编辑cron任务：
crontab -e，添加以下行：* * * * * raspistill -o /home/pi/timed_photos/%Y%m%d_%H%M%S.jpg
保存后,系统会每分钟执行一次拍照，文件名包含时间戳。
Q2: 树莓派摄像头拍摄的视频如何转换为MP4格式？
A2: 若使用raspivid录制的是H.264裸流，需通过ffmpeg转换，将video.h264转换为video.mp4：
ffmpeg -i video.h264 -c:v copy -f mp4 video.mp4
若未安装ffmpeg，先执行sudo apt install ffmpeg，转换时，-c:v copy表示直接复制视频流，避免重新编码以提高速度。
