raspberryPi摄像头命令行软件raspistill帮助文档<译>

翻译文档

固定地址：https://www.zybuluo.com/SiberiaBear/note/55101

请点击固定地址访问作业部落查看最新版原文，在文章上划选可以批注或高亮批注，并可回复批注

说明：对树莓派操作中关于摄像头控制的命令行软件操作说明的翻译文档，有待补充，欠缺请指正。

本文最后更新时间：2014-12-16

---

目录

---

raspistill

作用

在指定的时间运行摄像头，而且如果需要可以捕获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窗口参数

raspivid

采集视频信息，需要时会再补充翻译

raspiyuv

采集YUV格式的原始图像，需要时会补充翻译