文章來源： http://raspberry.dns8844.cn/documentation

原文網址

rpicam-apps 選項參考

常用選項

除非另有說明，否則以下選項適用于所有具有相似或相同語義學的 rpicam-apps 。

要將以下選項之一傳遞給應用程序，請在選項名稱前加上 -- .如果選項需要值，請在選項名稱后立即傳遞該值，并用單個空格分隔。如果值包含空格，請將值用引號括起來。

一些選項有速記別名，例如 -h 而不是 --help 。使用這些速記別名而不是完整的選項名稱可以節省空間和時間，但會降低易讀性。

help

別名： -h

打印完整的選項集，以及每個選項的簡要概要。不接受值。

version

打印 libcam 和 rpicam-apps 的版本字符串。不接受值。

示例輸出：

rpicam-apps build: ca559f46a97a 27-09-2021 (14:10:24)
libcamera build: v0.0.0+3058-c29143f7

list-cameras

列出連接到Raspberry Pi的檢測到的相機及其可用的傳感器模式。不接受值。

傳感器模式標識符具有以下形式： S<Bayer order><Bit-depth>_<Optional packing> : <Resolution list>

裁剪在本機傳感器像素中（即使在像素合并模式下）指定為 (<x>, <y>)/<Width>×<Height> . (x, y) 指定傳感器陣列中大小為 width x height 的裁剪窗口的位置。

例如，以下輸出顯示有關索引0的 IMX219 傳感器和索引1的 IMX477 傳感器的信息：

Available cameras
````````````-
0 : imx219 [3280x2464] (/base/soc/i2c0mux/i2c@1/imx219@10)Modes: 'SRGGB10_CSI2P' : 640x480 [206.65 fps - (1000, 752)/1280x960 crop]1640x1232 [41.85 fps - (0, 0)/3280x2464 crop]1920x1080 [47.57 fps - (680, 692)/1920x1080 crop]3280x2464 [21.19 fps - (0, 0)/3280x2464 crop]'SRGGB8' : 640x480 [206.65 fps - (1000, 752)/1280x960 crop]1640x1232 [41.85 fps - (0, 0)/3280x2464 crop]1920x1080 [47.57 fps - (680, 692)/1920x1080 crop]3280x2464 [21.19 fps - (0, 0)/3280x2464 crop]
1 : imx477 [4056x3040] (/base/soc/i2c0mux/i2c@1/imx477@1a)Modes: 'SRGGB10_CSI2P' : 1332x990 [120.05 fps - (696, 528)/2664x1980 crop]'SRGGB12_CSI2P' : 2028x1080 [50.03 fps - (0, 440)/4056x2160 crop]2028x1520 [40.01 fps - (0, 0)/4056x3040 crop]4056x3040 [10.00 fps - (0, 0)/4056x3040 crop]

對于上面示例中的IMX219傳感器：

• 所有模式都有 RGGB Bayer排序
• 所有模式均可在所列分辨率下提供 8 位或 10 位 CSI2 封裝讀數

camera

選擇要使用的相機。從 可用相機列表。

config

別名： -c

指定一個包含CLI選項和值的文件。考慮一個名為 example_configuration.txt 的文件，該文件包含以下文本，將選項和值指定為鍵值對，每行一個選項，僅長（非別名）選項名稱：

timeout=99000
verbose=

TIP: 省略您通常在命令行上傳遞的前導 -- 。對于缺少值的標志，例如上面示例中的 verbose ，您必須在后面添加 = 。

然后，您可以運行以下命令來指定99000毫秒的超時和詳細輸出：

$ rpicam-hello --config example_configuration.txt

timeout

別名： -t

默認值：5000毫秒（5秒）

指定應用程序在關閉前運行多長時間。這適用于視頻錄制和預覽窗口。捕獲靜止圖像時，應用程序會在捕獲輸出圖像之前顯示 timeout 毫秒的預覽窗口。

要無限期運行應用程序，請指定值 0 。

preview

別名： -p

設置桌面或DRM預覽窗口的位置（x，y坐標）和大小（w，h尺寸）。不影響相機請求的圖像的分辨率或長寬比。縮放圖像大小和柱子或信箱圖像長寬比以適應預覽窗口。

以逗號分隔的形式傳遞預覽窗口尺寸： x， y，w，h

示例： rpicam-hello --preview 100,100,500,500

fullscreen

別名： -f

強制預覽窗口使用整個屏幕，沒有邊框或標題欄。縮放圖像大小并調整圖像寬高比，使其適合整個屏幕。不接受數值。

qt-preview

使用Qt預覽窗口，它比替代窗口消耗更多資源，但支持X窗口轉發。與 fullscreen 標志不兼容。不接受值。

nopreview

別名： -n

使應用程序_不_顯示預覽窗口。不接受值。

info-text

默認值： "#%frame (%fps fps) exp %exp ag %ag dg %dg"

在桌面環境中運行時，將提供的字符串設置為預覽窗口的標題。支持以下圖像元數據替換：

width 和 height

每個都接受一個數字，定義捕獲圖像的尺寸（以像素為單位）。

對于 rpicam-still、 rpicam-jpeg 和 rpicam-vid ，指定輸出分辨率。

對于 rpicam-raw ，指定原始圖像的分辨率。對于采用 2×2 分檔讀出模式的相機，指定等于或小于分檔模式的分辨率可捕獲 2×2 分檔的原始圖像。

對于 rpicam-hello ，沒有效果。

例子：

• rpicam-vid -o test.h264 --width 1920 --height 1080 捕獲1080p視頻。

• rpicam-still -r -o test.jpg --width 2028 --height 1520 捕獲2028×1520分辨率的JPEG。如果與HQ相機一起使用，則使用2×2 像素合并模式，因此原始文件（ test.dng ）包含2028×1520原始Bayer圖像。

viewfinder-width 和 viewfinder-height

每個都接受一個數字，定義預覽窗口中顯示的圖像的尺寸（以像素為單位）。不影響預覽窗口尺寸，因為圖像會調整大小以適應。不影響捕獲的靜止圖像或視頻。

mode

允許您以下列以冒號分隔的格式指定攝像機模式： <寬度>:<高度>:<比特深度>:<包裝>。如果所提供的值不完全匹配，系統會為傳感器選擇最接近的可用選項。您可以使用打包 (P) 或未打包 (U) 的打包格式。影響存儲視頻和照片的格式，但不影響傳遞到預覽窗口的幀格式。

位深和封裝是可選的。
位深度默認為12。
打包默認為 P （打包）。

有關傳感器可用的位深度、分辨率和封裝選項的信息，請參閱 list-cameras。

例子：

• 4056:3040:12:P - 4056×3040 分辨率，每像素 12 位，打包。
• 1632:1224:10 - 1632×1224 分辨率，每個像素 10 位。
• 2592:1944:10:U - 2592×1944 分辨率，每像素 10 位，未打包。
• 3264:2448 - 3264×2448 分辨率。

打包格式詳細信息

打包格式使用較少的像素數據存儲空間。

在 Raspberry Pi 4 和更早的設備上，打包格式使用 MIPI CSI-2 標準打包像素。這意味著

• 10 位攝像頭模式將 4 個像素打包成 5 個字節。前 4 個字節包含每個像素的 8 個最有效位（MSB），最后一個字節包含 4 對最小有效位（LSB）。
• 12 位攝像機模式將 2 個像素打包成 3 個字節。前 2 個字節包含每個像素的 8 個最有效位 (MSB)，最后一個字節包含兩個像素的 4 個最小有效位 (LSB)。

在 Raspberry Pi 5 及更高版本的設備上_，打包格式通過視覺無損壓縮方案將像素值壓縮為每個像素 8 位（1 個字節）。

解壓格式詳細信息

解壓縮格式提供的像素值更易于手動操作，但像素數據的存儲空間卻更大。

在所有設備上，未打包格式每個像素使用 2 個字節。

在 Raspberry Pi 4 和更早的設備上，應用程序會在 most significant end 應用零填充。在未打包格式中，10 位相機模式的像素值不能超過 1023。

在 Raspberry Pi 5 及更早的設備上，應用程序會在 least significant end 應用零填充，因此圖像會使用傳感器提供的像素深度的全部 16 位動態范圍。

viewfinder-mode

與 mode 選項相同，但它適用于傳遞到預覽窗口的數據。有關詳細信息，請參閱 mode 文檔。

lores-width 和 lores-height

從相機傳送第二個分辨率較低的圖像流，縮小到指定的尺寸。

每個都接受一個數字，定義低分辨率流的維度（以像素為單位）。

可用于預覽和視頻模式。不適用于靜態捕獲。如果您指定的長寬比與正常分辨率流不同，則會生成非方形像素。

對于 rpicam-vid ，禁用額外的顏色去噪處理。

與 圖像后處理 結合使用時對圖像分析很有用。

hflip

水平翻轉圖像。不接受值。

vflip

垂直翻轉圖像。不接受值。

rotation

旋轉從傳感器提取的圖像。僅接受值0或180。

roi

裁剪從傳感器的完整字段中提取的圖像。接受四個十進制值，ranged0到1，格式如下： <x>，<y>，<w>， h> 。這些值中的每一個都代表可用寬度和高度的百分比，作為0到1之間的小數。

這些值定義了以下比例：

• <x> ：提取圖像前要跳過的X坐標
• <y> ：提取圖像前要跳過的Y坐標
• <w> ：要提取的圖像寬度
• <h> ：要提取的圖像高度

默認為 0,0,1,1 （從第一個X坐標和第一個Y坐標開始，使用100%的圖像寬度，使用100%的圖像高度）。

例子：

• rpicam-hello--roi 0.25,0.25,0.5,0.5 選擇從圖像中心裁剪的總像素數的一半（跳過X坐標的前25%，跳過Y坐標的前25%，使用總圖像寬度的50%，使用總圖像高度的50%）。
• rpicam-hello--roi 0,0,0.25,0.25 選擇從圖像左上角裁剪的總像素數的四分之一（跳過X坐標的前0%，跳過Y坐標的前0%，使用25%的圖像寬度，使用25%的圖像高度）。

hdr

默認值： off

以HDR模式運行相機。如果不帶值傳遞，則假定 auto 。接受以下值之一：

• off - 禁用 HDR。
• auto - 在支持的設備上啟用 HDR。使用傳感器的內置 HDR 模式（如果可用）。如果傳感器沒有內置 HDR 模式，則使用可用的板載 HDR 模式。
• single-exp - 使用板載 HDR 模式（如果可用），即使傳感器有內置 HDR 模式。如果板載 HDR 模式不可用，則禁用 HDR

Raspberry Pi 5及更高版本的設備具有板載HDR模式。

要檢查傳感器中的內置 HDR 模式，除了 list-cameras 之外，還需傳遞此選項。

上一篇 – 樹莓派超全系列教程文檔–(62)使用rpicam-app通過網絡流式傳輸視頻
下一篇 – 樹莓派超全系列教程文檔–(64)rpicam-apps可用選項介紹之相機控制選項