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

--help, -h

打印程序幫助信息，可以打印每個(gè)程序指令的可用設(shè)置選項(xiàng)，然后退出.

--version

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

--timeout, -t

-t選項(xiàng) 設(shè)置了libcamera程序運(yùn)行時(shí)間， 如果運(yùn)行的是視頻錄制指令，timeout選項(xiàng)設(shè)置的是錄制時(shí)長(zhǎng)，如果運(yùn)行的是圖像拍攝指令，timeout設(shè)置的拍攝并輸出圖像之前的預(yù)覽時(shí)間。
如果在運(yùn)行l(wèi)ibcamera程序的時(shí)候沒(méi)有設(shè)置timeout，默認(rèn)的timeout數(shù)值就是5000（5秒）， 如果將timeout設(shè)置為0，那程序就會(huì)一直運(yùn)行。
示例： libcamera-hello -t 0

--preview, -p

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

--fullscreen, -f

-f選項(xiàng)設(shè)置預(yù)覽窗口全屏顯示，全屏顯示模式的預(yù)覽窗口和邊框。同-p一樣，不會(huì)影響分辨率和寬高比，會(huì)自動(dòng)適配。
示例： libcamera-still -f -o test.jpg

--qt-preview

使用基于QT框架的預(yù)覽窗口， 正常情況下不推薦用這個(gè)設(shè)置，因?yàn)檫@個(gè)預(yù)覽程序不會(huì)使用零拷貝緩沖區(qū)共享以及GPU加速， 這個(gè)會(huì)導(dǎo)致占用資源過(guò)高。 QT預(yù)覽窗口支持X轉(zhuǎn)發(fā)（默認(rèn)預(yù)覽程序不支持）.
Qt預(yù)覽串口不支持--fullscreen設(shè)置選項(xiàng)， 如果用戶要使用Qt預(yù)覽，建議保持小預(yù)覽窗口，避免資源占用過(guò)高影響系統(tǒng)正常運(yùn)行。
示例： libcamera-hello --qt-preview

--nopreview, -n

不預(yù)覽圖像。這個(gè)設(shè)置會(huì)關(guān)掉圖像預(yù)覽功能.
示例：libcamera-hello -n

--info-text

設(shè)置預(yù)覽窗口的標(biāo)題和信息顯示（只在X圖形窗口下有效）使用格式為 --info-text 。調(diào)用改選項(xiàng)，有多個(gè)參數(shù)可以設(shè)置，參數(shù)通常以%指令格式調(diào)用。 程序會(huì)按照指令調(diào)用圖形元數(shù)據(jù)中的對(duì)應(yīng)數(shù)值。
如果沒(méi)有指定窗口信息，默認(rèn)的--info-text設(shè)置為 "#%frame (%fps fps) exp %exp ag %ag dg %dg"
示例： libcamera-hello --info-test "Focus measure: %focus 可用參數(shù):

--width --height

這兩個(gè)參數(shù)分別設(shè)置圖像的寬度和高度。對(duì)于libcamera-still， libcamera-jpeg和libcamera-vid指令，這兩個(gè)參數(shù)可以設(shè)置輸出圖像/視頻的分辨率。
如果使用libcamera-raw指令，這兩個(gè)參數(shù)會(huì)影響獲取的元數(shù)據(jù)幀的大小。 攝像頭有一個(gè)2x2的分塊讀取模式，如果設(shè)置的分辨率小于分開(kāi)模式， 攝像頭會(huì)按照2x2的分塊大小獲取元數(shù)據(jù)幀。
libcamera-hello無(wú)法指定分辨率.< 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

這個(gè)設(shè)置選項(xiàng)也是用來(lái)設(shè)置圖像的分辨率，不同的是只設(shè)置的預(yù)覽的圖像大小。并不會(huì)影響最終輸出的圖像或者視頻的分辨率。 預(yù)覽圖像大小的設(shè)備不會(huì)影響預(yù)覽窗口尺寸，會(huì)根據(jù)窗口適配。
示例: libcamera-hello --viewfinder-width 640 --viewfinder-height 480

--rawfull

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

--lores-width --lores-height

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

--hflip #水平翻轉(zhuǎn)圖像 --vflip #垂直翻轉(zhuǎn)圖像 --rotation #根據(jù)給出的角度，水平或者垂直翻轉(zhuǎn)圖像

這三個(gè)選項(xiàng)用來(lái)翻轉(zhuǎn)圖像。 --rotation的參數(shù)目前只支持0 和180， 其實(shí)就是相當(dāng)于--hflip和--vflip.
示例： libcamera-hello --vflip --hflip

--roi #裁剪圖像,>

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

--sharpness #設(shè)置圖像的銳度

通過(guò)數(shù)值調(diào)整圖像的銳度。 如果設(shè)置為0，就是不應(yīng)用銳化。 如果設(shè)置的值超過(guò)1.0，會(huì)使用而外的銳化量。
示例: libcamera-still -o test.jpg --sharpness 2.0

--contrast #設(shè)置圖像對(duì)比度

審核編輯：湯梓紅