使用格式
raspistill [options]
常用命令
常用命令:
# 两秒钟(时间单位为毫秒)延迟后拍摄一张照片,并保存为 image.jpg
raspistill -t 2000 -o image.jpg
# 拍摄一张自定义大小的照片。
raspistill -t 2000 -o image.jpg -w 640 -h 480
# 降低图像质量,减小文件尺寸
raspistill -t 2000 -o image.jpg -q 5
# 强制使预览窗口出现在坐标为 100,100 的位置,并且尺寸为宽 300 和高 200 像素。
raspistill -t 2000 -o image.jpg -p 100,100,300,200
# 禁用预览窗口
raspistill -t 2000 -o image.jpg -n
# 将图像保存为 PNG 文件(无损压缩格式,但是要比 JPEG 速度慢)。注意,当选择图像编码时,文件扩展名将被忽略。
raspistill -t 2000 -o image.png –e png
# 向 JPEG 文件中添加一些 EXIF 信息。该命令将会把作者名称标签设置为 Dreamcolor,GPS 海拔高度为 123.5米。
raspistill -t 2000 -o image.jpg -x IFD0.Artist=Dreamcolor -x GPS.GPSAltitude=1235/10
# 设置浮雕风格图像特效
raspistill -t 2000 -o image.jpg -ifx emboss
# 设置 YUV 图像的 U 和 V 通道为指定的值(128:128 为黑白图像)
raspistill -t 2000 -o image.jpg -cfx 128:128
# 仅显示两秒钟预览图像,而不对图像进行保存。
raspistill -t 2000
# 间隔获取图片,在 10 分钟(10 分钟 = 600000 毫秒)的时间里,每 10 秒获取一张,并且命名为 image_number_1_today.jpg,image_number_2_today.jpg... 的形式。
raspistill -t 600000 -tl 10000 -o image_num_%d_today.jpg
# 获取一张照片并发送至标准输出设备
raspistill -t 2000 -o -
# 获取一张照片并保存为一个文件
raspistill -t 2000 -o - > my_file.jpg
图像参数与命令
-?, --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
-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水平
预览参数与命令
-p, --preview : 预览窗口大小设置 <x,y,w,h>
-f, --fullscreen : 全屏幕预览模式
-op, --opacity : 预览窗口透明度 (0-255)
-n, --nopreview : 不显示预览窗口
-gs, -glscene : GL屏幕尺寸等参数
-gw, -glwin : GL窗口参数
其他说明
曝光模式参数说明:
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 : 阵列测光