树莓派超全系列教程文档--(64)rpicam-apps可用选项介绍之相机控制选项

原文网址

rpicam-apps可用选项介绍

相机控制选项

以下选项控制影响相机画质的图像处理和算法。

sharpness 锐化

设置图像清晰度。接受以下光谱的数值：

• 0.0 不适用锐化
• 大于 0.0 但小于 1.0 的值适用于小于默认锐化量
• 1.0 应用默认的锐化量
• 大于 1.0 的值应用额外的锐化

contrast 对比度

指定图像对比度。接受以下光谱的数值：

• 0.0 应用最小对比度
• 大于 0.0 但小于 1.0 的值应用于小于默认对比度量
• 1.0 应用默认对比度量
• 大于 1.0 的值应用额外的对比度

brightness 亮度

指定图像亮度，作为输出图像中所有像素的偏移量添加。接受以下光谱的数值：

• -1.0 适用于最小亮度（黑色）
• 0.0 适用标准亮度
• 1.0 适用于最大亮度（白色）

对于许多用例，更喜欢 ev。

saturation 饱和度

• 0.0 适用于最小饱和度（灰度）
• 大于 0.0 但小于 1.0 的值适用于小于默认饱和量
• 1.0 应用默认的饱和度量
• 大于 1.0 的值应用额外的饱和度

ev

指定图像的 曝光值（EV） 补偿。接受一个数值，该数值控制沿着以下光谱传递给自动曝光/增益控制（AEC/AGC）处理算法的目标值：

• -10.0 应用最小目标值
• 0.0 应用标准目标值
• 10.0 适用最大目标值

shutter 快门

使用快门以_microseconds_指定曝光时间。使用此选项时，增益仍然会有所不同。如果相机以帧速率运行得太快，以至于不允许指定的曝光时间（例如，帧速率为1fps，曝光时间为10000微秒），传感器将使用帧速率允许的最大曝光时间。

有关官方相机的最小和最大快门时间列表，请参阅 相机硬件文档。高于最大值的值会导致未定义的行为。

gain 增益

别名： --analoggain

设置模拟和数字增益的组合。当传感器驱动器可以提供请求的增益时，仅使用模拟增益。当模拟增益达到最大值时，ISP应用数字增益。接受一个数值。

有关官方相机的模拟增益限制列表，请参阅 相机硬件文档。

有时，即使没有超过模拟增益限制，数字增益也可能超过1.0。这可能发生在以下情况下：

• 任一颜色增益低于1.0，这将导致数字增益稳定在1.0/min（red_gain，blue_gain）。这使应用于任何颜色通道的总数字增益保持在1.0以上，以避免变色伪影。
• 自动曝光/增益控制（AEC/AGC）更改期间的轻微差异。

metering 测光

默认值： centre

设置自动曝光/增益控制（AEC/AGC）算法的计量模式。接受以下值：

• 中心 -中心加权计量
• spot -点计量
• 平均 -平均或整个帧计量
• 自定义 -相机调谐文件中定义的自定义测光模式

有关定义自定义计量模式和调整现有计量模式中的区域权重的更多信息，请参阅 https://datasheets.raspberrypi.com/camera/raspberry-pi-camera-guide.pdf[Raspberry Pi相机和lib相机的调整指南]。

exposure 曝光

设置曝光配置文件。更改曝光配置文件不应影响图像曝光。相反，不同模式会调整增益设置以实现相同的净结果。接受以下值：

• 运动 ：短曝光，大收益
• normal ：正常曝光，正常增益
• long ：长期敞口，收益较小

您可以使用调谐文件编辑曝光配置文件。有关详细信息，请参阅 树莓派相机和lib相机的调整指南。

awb 白平衡

设置自动白平衡（AWB）模式。接受以下值：

这些值只是近似值：值可能会根据相机调整而有所不同。

没有模式完全禁用AWB。相反，您可以使用 awbgains 修复颜色增益。

有关AWB模式的更多信息，包括如何定义自定义模式，请参阅 树莓派相机和lib相机的调整指南。

awbgains

设置要使用的固定红色和蓝色增益值，而不是自动白平衡（AWB）算法。设置非零值以禁用AWB。接受逗号分隔的数字输入，格式如下： <red_gain>,<blue_gain>

denoise 降噪

默认值： auto

设置去噪模式。接受以下值：

• auto ：启用标准空间去噪。对视频使用超快的色彩去噪，对图像使用高质量的色彩去噪。在预览窗口中不启用额外的色彩去噪。

• off ： 禁用空间和色彩去噪

• cdn_off ：禁用颜色降噪。

• cdn_fast ：使用快速颜色降噪。

• cdn_hq ：使用高质量的色彩去噪。由于吞吐量降低，不适合视频/取景器。

即使是快速的色彩去噪也能降低帧率。高质量的色彩去噪_大幅地_降低帧率。

tuning-file 调谐文件

指定相机调谐文件。调谐文件允许您控制图像处理的许多方面，包括自动曝光/增益控制（AEC/AGC）、自动白平衡（AWB）、颜色阴影校正、颜色处理、去噪等。接受调谐文件路径作为输入。

有关调优文件的详细信息，请参见 调谐文件。

autofocus-mode 自动对焦模式

默认值： default

指定自动对焦模式。接受以下值：

• default ：lens-position 或 autofocus-on-capture 将模式改成手动
• manual ：根本不会移动镜头，除非手动配置 lens-position
• auto ：仅在相机启动时或拍摄前移动镜头进行自动对焦扫描，如果还使用了 autofocus-on-capture
• continuous ：随着场景的变化自动调整镜头位置

此选项仅适用于某些相机模块。

autofocus-window

默认值： normal

指定自动对焦范围。接受以下值：

• normal ：从合理接近到无穷大的焦点
• macro ：只关注近距离物体，包括相机支持的最近焦距
• full ：关注整个范围，从最接近的物体到无穷大

此选项仅适用于某些相机模块。

autofocus-speed 自动对焦速度

默认值： normal

指定自动对焦速度。接受以下值：

• normal ：以正常速度改变镜头位置
• fast ：快速改变镜头位置

此选项仅适用于某些相机模块。

autofocus-range 自动对焦范围

指定传感器完整字段内的自动对焦窗口。接受四个十进制值，范围0到1，格式如下： <x>,<y>,<w>,h> 。这些值中的每一个都表示可用宽度和高度的百分比，作为0到1之间的小数。

这些值定义了以下比例：

• <x> ：在应用自动对焦之前要跳过的X坐标
• <y> ：在应用自动对焦之前要跳过的Y坐标
• <w> ：自动对焦区域宽度
• <h> ：自动对焦区域高度

默认值使用两个维度中输出图像的中间三分之一（总图像区域的1/9）。

例子：

• rpicam-hello --autofocus-window 0.25,0.25,0.5,0.5 选择从图像中心裁剪的总像素数的一半（跳过X坐标的前25%，跳过Y坐标的前25%，使用总图像宽度的50%，使用总图像高度的50%）。
• rpicam-hello --autofocus-window 0,0,0.25,0.25 选择从图像左上角裁剪的总像素数的四分之一（跳过X坐标的前0%，跳过Y坐标的前0%，使用25%的图像宽度，使用25%的图像高度）。

此选项仅适用于某些相机模块。

lens-position 镜头位置

默认值： default

将镜头移动到固定焦距，通常以屈光度（单位为1/distancemetres）给出。接受以下值光谱：

• 0.0 ：将镜头移动到 无穷大 位置
• 任何其他 number ：将镜头移动到1/ 数字 位置。例如，值 2.0 将聚焦在大约0.5m
• default ：将镜头移动到与镜头超焦位置相对应的默认位置

镜头校准不完美，因此同一型号的不同相机模块可能会有所不同。

verbose

别名： -v

默认值： 1

设置详细级别。接受以下值：

• 0 ：无输出
• 1 ：正常输出
• 2 ：详细输出

输出文件选项

输出

别名： -o

设置用于录制图像或视频的文件的名称。除了明文文件名外，还接受以下特殊值：

• - : 写入标准输出。
• udp:// （前缀）：UDP流的网络地址。
• tcp:// （前缀）：TCP流的网络地址。
• 在文件名中包含 %d 指令，以替换为每打开一个文件就递增一次的计数指令。该指令支持标准 C 格式指令修饰符。

例子：

• rpicam-vid -t 100000 --segment 10000 -o chunk%04d.h264 在10秒段中记录一个100秒的文件，其中每个文件都包含一个递增的四位数计数器，并用前导零填充：例如 chunk0001.h264、 chunk0002.h264 等。

• rpicam-vid -t 0 --inline -o udp://192.168.1.13:5000 在端口5000上使用UDP将H.264视频流式传输到网络地址192.168.1.13。

wrap 包装

设置 输出 %d 指令使用的计数器的最大值。计数器在达到此值后重置为零。接受一个数值。

flush 刷新

帧完成写入后立即将输出文件刷新到磁盘，而不是等待系统处理它。不接受值。

post-process-file 处理后文件

指定一个 JSON 文件，用于配置成像管道应用的后处理。这适用于相机图像到达应用程序之前。其工作原理类似于传统的 raspicam “图像特效”。接受文件名路径作为输入。

后处理是一个大课题，需要使用 OpenCV 和 TensorFlowLite 等第三方软件来分析和处理图像。有关详细信息，请参阅 后处理。

上一篇 – 树莓派超全系列教程文档–(63) rpicam-apps可用选项介绍之常用选项
下一篇 –