樹莓派進階之路 (018) - raspberryPi攝像頭命令行軟件raspistill幫助文檔

文檔原文:https://www.raspberrypi.org/app/uploads/2013/07/RaspiCam-Documentation.pdf 

做用

　　在指定的時間運行攝像頭，並且若是須要能夠捕獲JPG圖片

使用格式

raspistill [options] 

圖像參數與命令

-?,  --help             : 幫助文檔
-w,  --width            : 設置圖像寬度 <尺寸>
-h, --height            : 設置圖像高度 <尺寸>
-q, --quality           : 設置jpeg品質 <0到100>
-r, --raw               : 增長raw原始拜爾數據到JPEG元數據
-o, --output            : 輸出文件名 <文件名>，若是要寫到stdout，使用`-o -`，若是不特別指定，圖像文件不會被保存
-l, --latest            : 連接最近的完整圖像到指定文件 <文件名>
-v, --verbose           : 在運行攝像頭時輸出詳細信息
-t, --timeout           : 拍照和關閉時的延時指定，未指定時默認是5s
-th, --thumb            : 設置預覽圖（小圖）參數（包括X、Y、品質）或者不設置
-d, --demo              : 運行一個demo模式（cycle through range of camera options, no capture），括號裏的我能夠理解成循環測試模式嗎？
-e, --encoding          : 編碼來輸出指定格式文件 （jpg, bmp, gif, png）
-x, --exif              :將可交換圖像文件應用到捕獲中（格式：`key=value`）或者不設置
-tl, --timelapse        : 間隔拍攝，每<ms>拍攝一張圖片
-fp, --fullpreview      : 用靜態捕捉分辨率運行預覽（可能會減少預覽幀率）
-k, --keypress          : 按鍵觸發，按`ENTER`鍵拍照，按`X`而後`ENTER`鍵退出
-s, -signal             : 信號觸發，等待另外一個進程信號來拍攝一張照片
-g, -gl                 : 繪製預覽到文本，而不是使用視頻渲染組件（啥意思？）
-gc, --glcapture        : 捕獲GL幀buffer而不是攝像機圖像
-set, --settings        : 檢索攝像機設置值而後寫出到stdout
-cs, --camselect        : 選擇攝像頭設備 <數字>，默認0
-bm, --burst            : 運行burst capture mode

預覽參數與命令

-p, --preview           : 預覽窗口大小設置 <x,y,w,h>
-f, --fullscreen        : 全屏幕預覽模式
-op, --opacity          : 預覽窗口透明度 （0-255）
-n, --nopreview         : 不顯示預覽窗口

圖像參數與命令2

-sh, --sharpness        : 設置圖像銳度 （-100 到 100）
-co, --contrast         : 設置圖像對比度 （-100 到 100）
-br, --brightness       : 設置圖像亮度 （0 到 100）
-sa, --saturation       : 設置圖像飽和度 （-100 到 100）
-ISO, --ISO             : 設置攝像頭感光度
-vs, --vstab            : Turn on video stabilisation 開啓攝像頭防抖模式（是這個意思嗎？）
-ev, --ev               : 設置EV補償
-ex, --exposure         : 設置曝光模式（參見提示）
-awb, --awb             : 設置AWB模式（參見提示）
-ifx, --imxfx           : 設置圖像效應（參見提示）
-cfx, --colfx           : 設置色彩效應（參見提示）
-mm, --metering         : 設置測光模式（參見提示）
-rot, --rotation        : 設置圖像旋轉 （0到359）
-hf, --hflip            : 設置水平翻轉 horizontal flip
-vf, --vflip            : 設置垂直翻轉 vertical flip
-roi, --roi             : 設置interest區域 （啥叫interset?）
--ss, --shutter         : 設置快門速度，微秒
--awbg, --awbgains      : 設置AWB閾值， AWB模式必須關閉
--drc, --drc            : 設置DRC水平

提示

曝光模式選項：

auto                    : 自動曝光模式
night                   : 夜間拍攝模式
nightpreview            : 夜間預覽拍攝模式
backlight               : 逆光拍攝模式
spotlight               : 聚光燈拍攝模式
sports                  : 運動拍攝模式
snow                    : 雪景拍攝模式
beach                   : 海灘拍攝模式
verylong                : 長時間曝光拍攝模式
fixedfps                : 幀約束拍攝模式
antishake               : 防抖模式
fireworks               : 煙火拍攝模式

自動白平衡選項：

off                     : 關閉白平衡測算
auto                    : 自動模式（默認）
sun                     : 日光模式
cloud                   : 多雲模式
shade                   : 陰影模式
tungsten                : 鎢燈模式
fluorescent             : 熒光燈模式
incandescent            : 白熾燈模式
flash                   : 閃光模式
horizon                 : 地平線模式

圖像特效選項：

none                    : 無特效（默認）
negative                : 反色圖像
solarise                : 曝光過分圖像
posterize               : 色調圖像
whiteboard              : 白板特效
blackboard              : 黑板特效
sketch                  : 素描風格特效
denoise                 : 降噪圖像
emboss                  : 浮雕圖像
oilpaint                : 油畫風格特效
hatch                   : 草圖特效
gpen                    : 馬克筆特效
pastel                  : 柔化風格特效
watercolour             : 水彩風格特效
film                    : 膠片顆粒風格特效
blur                    : 模糊圖像
saturation              : 色彩飽和圖像
colourswap              : 暫未可用
washedout               : 暫未可用
posterise               : 暫未可用
colourpoint             : 暫未可用
colourbalance           : 暫未可用
cartoon                 : 暫未可用

測光模式選項：

average                 : 全畫面平衡測光
spot                    : 點測光
backlit                 : 模擬背光圖像
matrix                  : 陣列測光

預覽參數與命令2

-gs, -glscene           : GL屏幕尺寸等參數
-gw, -glwin             : GL窗口參數

 

經常使用命令:

 1 經常使用命令：
 2 # 兩秒鐘（時間單位爲毫秒）延遲後拍攝一張照片，並保存爲 image.jpg
 3 raspistill -t 2000 -o image.jpg
 4 
 5 # 拍攝一張自定義大小的照片。
 6 raspistill -t 2000 -o image.jpg -w 640 -h 480
 7 
 8 # 下降圖像質量，減少文件尺寸
 9 raspistill -t 2000 -o image.jpg -q 5
10 
11 # 強制使預覽窗口出如今座標爲 100,100 的位置，而且尺寸爲寬 300 和高 200 像素。
12 raspistill -t 2000 -o image.jpg -p 100,100,300,200
13 
14 # 禁用預覽窗口
15 raspistill -t 2000 -o image.jpg -n
16 
17 # 將圖像保存爲 PNG 文件（無損壓縮格式，可是要比 JPEG 速度慢）。注意，當選擇圖像編碼時，文件擴展名將被忽略。
18 raspistill -t 2000 -o image.png –e png
19 
20 # 向 JPEG 文件中添加一些 EXIF 信息。該命令將會把做者名稱標籤設置爲 Dreamcolor，GPS 海拔高度爲 123.5米。
21 raspistill -t 2000 -o image.jpg -x IFD0.Artist=Dreamcolor -x GPS.GPSAltitude=1235/10
22 
23 # 設置浮雕風格圖像特效
24 raspistill -t 2000 -o image.jpg -ifx emboss
25 
26 # 設置 YUV 圖像的 U 和 V 通道爲指定的值（128:128 爲黑白圖像）
27 raspistill -t 2000 -o image.jpg -cfx 128:128
28 
29 # 僅顯示兩秒鐘預覽圖像，而不對圖像進行保存。
30 raspistill -t 2000
31 
32 # 間隔獲取圖片，在 10 分鐘（10 分鐘 = 600000 毫秒）的時間裏，每 10 秒獲取一張，而且命名爲 image_number_1_today.jpg，image_number_2_today.jpg... 的形式。
33 raspistill -t 600000 -tl 10000 -o image_num_%d_today.jpg
34 
35 # 獲取一張照片併發送至標準輸出設備
36 raspistill -t 2000 -o -
37 
38 # 獲取一張照片並保存爲一個文件
39 raspistill -t 2000 -o - > my_file.jpg