IMX219-77 攝像頭是一款性價比較高的嵌入式攝像頭，下面主要介紹一下此攝像頭的指令使用。

--help, -h

打印程序幫助信息，可以打印每個程序指令的可用設置選項，然后退出.

--version

打印軟件版本，打印libcamera和libcamera-app的軟件版本，然后退出.

--timeout, -t

-t選項 設置了libcamera程序運行時間， 如果運行的是視頻錄制指令，timeout選項設置的是錄制時長，如果運行的是圖像拍攝指令，timeout設置的拍攝并輸出圖像之前的預覽時間。
如果在運行libcamera程序的時候沒有設置timeout，默認的timeout數值就是5000（5秒）， 如果將timeout設置為0，那程序就會一直運行。
示例： libcamera-hello -t 0

--preview, -p

-p 設置預覽預覽窗口大小以及窗口的位置（則合格設置在 X和DRM版本的窗口中都有效）， 設置格式為 --preview 其中x y設置預覽窗口在顯示屏上的坐標位置， w和h設置的是預覽窗口的寬度和長度
預覽串口的設置不會影響攝像頭圖像預覽的分辨率和寬高比。 程序會將預覽圖像縮放到預覽窗口中顯示，并會按照原來的圖像寬高比做適配。
示例: libcamera-hello -p 100,100,500,500

--fullscreen, -f

-f選項設置預覽窗口全屏顯示，全屏顯示模式的預覽窗口和邊框。同-p一樣，不會影響分辨率和寬高比，會自動適配。
示例： libcamera-still -f -o test.jpg

--qt-preview

使用基于QT框架的預覽窗口， 正常情況下不推薦用這個設置，因為這個預覽程序不會使用零拷貝緩沖區共享以及GPU加速， 這個會導致占用資源過高。 QT預覽窗口支持X轉發（默認預覽程序不支持）.
Qt預覽串口不支持--fullscreen設置選項， 如果用戶要使用Qt預覽，建議保持小預覽窗口，避免資源占用過高影響系統正常運行。
示例： libcamera-hello --qt-preview

--nopreview, -n

不預覽圖像。這個設置會關掉圖像預覽功能.
示例：libcamera-hello -n

--info-text

設置預覽窗口的標題和信息顯示（只在X圖形窗口下有效）使用格式為 --info-text 。調用改選項，有多個參數可以設置，參數通常以%指令格式調用。 程序會按照指令調用圖形元數據中的對應數值。
如果沒有指定窗口信息，默認的--info-text設置為 "#%frame (%fps fps) exp %exp ag %ag dg %dg"
示例： libcamera-hello --info-test "Focus measure: %focus 可用參數:

--width --height

這兩個參數分別設置圖像的寬度和高度。對于libcamera-still， libcamera-jpeg和libcamera-vid指令，這兩個參數可以設置輸出圖像/視頻的分辨率。
如果使用libcamera-raw指令，這兩個參數會影響獲取的元數據幀的大小。 攝像頭有一個2x2的分塊讀取模式，如果設置的分辨率小于分開模式， 攝像頭會按照2x2的分塊大小獲取元數據幀。
libcamera-hello無法指定分辨率.< br /> 示例：
libcamera-vid -o test.h264 --width 1920 --height 1080 錄制1080p視頻
libcamera-still -r -o test.jpg --width 2028 --height 1520 拍攝一張分辨率為2028x1520的JPEG圖像。

--viewfinder-width --viewfinder-height

這個設置選項也是用來設置圖像的分辨率，不同的是只設置的預覽的圖像大小。并不會影響最終輸出的圖像或者視頻的分辨率。 預覽圖像大小的設備不會影響預覽窗口尺寸，會根據窗口適配。
示例: libcamera-hello --viewfinder-width 640 --viewfinder-height 480

--rawfull

這個設置強制感光芯片活了--width和--height的設置， 在全分辨率讀取模式下輸出靜態圖像和視頻。這個設置libcamera-hello無效。
使用該設置，會犧牲幀率。全分辨率模式下，幀讀取速度會比較慢。
示例： libcamera-raw -t 2000 --segment 1 --rawfull -o test%03d.raw 示例指令會捕獲多張全分辨率模式下的元數據幀。 如果你使用的是HQ攝像頭。 每個幀的大小為18MB， 而如果沒有設置--rawfull， HQ攝像頭默認的是2x2模式， 每幀的數據大小只有4.5MB.

--lores-width --lores-height

這個兩個選項設置低分辨率圖像。 低分辨率數據流會壓縮圖像，導致圖像的縱橫比改變。在使用libcamera-vid錄制視頻的時候，如果設置了低分辨率，會禁用掉顏色去噪處理等功能。
示例: libcamera-hello --lores-width 224 --lores-height 224 注意，低分辨率設置通常要結合圖像后處理使用，否則效用不大。

--hflip #水平翻轉圖像 --vflip #垂直翻轉圖像 --rotation #根據給出的角度，水平或者垂直翻轉圖像

這三個選項用來翻轉圖像。 --rotation的參數目前只支持0 和180， 其實就是相當于--hflip和--vflip.
示例： libcamera-hello --vflip --hflip

--roi #裁剪圖像,>

--roi允許用戶從傳感器提供的完整圖像中根據坐標裁剪自己想要的圖像區域，也就是數字縮放，注意坐標值要是在有效范圍的。 比如 --roi 0, 0, 1, 1就是無效的指令。
示例：libcamera-hello --roi 0.25,0.25,0.5,0.5 示例指令會從圖像中心裁剪1/4圖像出來。

--sharpness #設置圖像的銳度

通過數值調整圖像的銳度。 如果設置為0，就是不應用銳化。 如果設置的值超過1.0，會使用而外的銳化量。
示例: libcamera-still -o test.jpg --sharpness 2.0

--contrast #設置圖像對比度

審核編輯：湯梓紅