树莓派摄像头命令

树莓派摄像头模块应用程序文档翻译 RaspiCam 文档 本文档将对 2013 年 12 月 7 日为止可用的三个 Raspberry Pi 摄像头应用程序进行介绍。 目前提供了三个应用程序，分别为：raspistill、raspivid、raspistillyuv。其中 raspistill 和 raspistillyuv 非常相似，并且都是用于捕捉图像，而 raspivid 用于捕捉视频。 所有应用程序均基于命令行方式运行，通过 OpenMAX 的 mmal API 进行编写。OpenMAX 的 mmal API 提供了更易使用的系统组件。注意，mmal 是一个由 Broadcom 为 Videocore 4 系统定制的 API。 应用程序使用了四个 OpenMAX（mmal）组件：camera（摄像）、preview（预览）、encoder（编码）、null_sink。所有应用程序均使用了摄像组件，raspistill 使用了图像编码组件，raspivid 使用了视频编码组件，raspistillyuv 没有使用编码组件，而是直接将 YUV 或 RGB 从摄像组件输出到文件。 预览显示为可选参数，但是可以用于全屏或输出到指定的显示器显示区域进行显示。如果预览被禁用，那么 null_silk 组件将会对预览帧进行“吸收”。这是由于尽管不需要摄像头生成供显示所用的的预览帧，但是仍需要使用它们进行曝光计算和白平衡设置的缘故。 此外，还可以省略文件名参数，这样既可以直接预览显示而不写入文件，或者直接输出到输出设备上。命令行帮助可以通过直接输入应用程序名称获得。 安装摄像头硬件 警告：摄像头对静电非常敏感。如果您在安装摄像头电路板时没有防静电手环，可以尝试触摸一下水龙头、金属水槽或其它类似的东西即可。 摄像头电路板与 Raspberry Pi 通过一条 15 芯的排线进行连接。仅有两个连接座需要连接，排线需要安装到摄像头电路板和 Raspberry Pi 上。您需要正确安装，否则摄像头无法工作。对于摄像头电路板，排线末端的蓝色标记应该背对着电路板。而 Raspberry Pi 部分，蓝色标记应该正对着网络接口方向（如果您使用的是 Model A，那么也是需要正对着网络接口预留位）。 尽管两部分连接座不尽相同，但它们的工作方式很相似。对于 Raspberry Pi，拉起连接座两端的卡扣。它应该很容易拉起，并能够轻微活动。把排线完全插入到连接座中，并保证竖直，然后轻轻按下两端的卡扣。摄像头电路板方面，也需要您将卡扣向电路板相反方向拉开，然后轻轻插入排线，最后将卡扣推回。摄像头电路板的连接座与 Pi 上的区别就在这里。 安装摄像头软件 执行下文介绍的命令行进行下载并安装最新的内核，GPU 固件及应用程序。您需要连接到互联网才可以实现以下操作。 1 2 sudo apt-get update sudo apt-get upgrade     接下来，您首先需要在 Raspberry Pi 的 raspi-config 程序中启用摄像头的支持。 1 sudo raspi-config     将光标移动到摄像头选项（Camera option）处，并选择启用（Enable）。在退出 raspi-config 时会要求您重新启动。启用选项是为了确保重启后 GPU 固件能够正确运行（包括摄像头驱动和调节电路），并且 GPU 从主内存划分到了足够的内存使摄像头能够正确运行。 测试系统已经完成安装并正常工作，可尝试以下命令： 1 raspistill -v -otest.jpg     这将显示来自摄像头 5 秒钟的预览图像，并且拍摄一张照片，然后保存为文件 test.jpg，同时显示出需要相关信息。 故障排除 如果摄像头工作不正常，您可以尝试以下操作。 l 连接排线是否连接正确？它们必须都垂直插入到插槽中。 l 摄像头模块的连接座是否紧密的贴合到了电路板上？摄像头模块电路板上连接座的黑色卡扣，有时会发生松动。用指甲轻轻拉开，并且重新将排线插入，并且把卡扣按回。 l 是否运行过 sudo apt-get update 和 sudo apt-get upgrade 了？ l 是否运行过 raspi-config 并启用了摄像头选项？ l 您的电源合适吗？除 Raspberry Pi 所要求的电量，摄像头将需要额外的 200-250mA 的电量。 如果仍然无法工作，可以尝试以下操作： Error : raspistill/raspivid not found. 该提示可以意味着您 update/upgrade 操作失败了。请重试。 Error : ENOMEM displayed. 摄像头没有启动。请再次检查所有的连接线。 Error : ENOSPC displayed. 摄像头可能使 GPU 内存溢出了。检查 /boot/ 目录下的 config.txt 文件内容。gpu_men 选项，最少应该为 128。 如果以上内容都尝试过了，摄像头仍然无法工作，那么它可能出现问题了。可以尝试在 Raspberry Pi 论坛的 Camera 板块找找是否有更多可用的帮助。 通用命令行参数 预览窗口 –preview, -p 预览窗口设置<‘x,y,w,h’> 允许用户在屏幕上定义预览窗口的大小和位置。注意，这将在所有其它窗口/图像的上层显示。 –fullscreen, -f 全屏预览模式 强制预览屏幕全屏显示。注意，这将会保留输入图像的长宽比例，所以可能会在图像的边缘出现填充条。 –nopreview, -n 不显示预览窗口 完全禁用预览窗口。注意，尽管预览窗口被禁用，但摄像头仍然在进行处理，所以会继续消耗资源。 –opacity, -op 设置预览窗口透明度 设置预览窗口的透明度。0 为完全透明，255 为完全不透明。 摄像头控制参数 –sharpness, -sh 设置图像锐度（-100 – 100） 设置图像的锐度，默认为 0。 –contrast, -co 设置图像对比度（-100 – 100） 设置图像的对比度，默认为 0。 –brightness, -br 设置图像亮度（0 – 100） 设置图像的亮度，默认为 50。0 为最暗，100 为最亮。 –saturation, -sa 设置图像饱和度（-100 – 100） 设置图像色彩饱和度。默认为 0。 –ISO, -ISO 设置捕捉 ISO 为捕捉图像设置 ISO。范围为 100 到 800。 –vstab, -vs 打开视频稳定 仅用于视频模式，用于开启视频稳定。 –ev, -ev 设置曝光补偿 设置图像的曝光补偿。范围为 -10 到 10，默认为 0。 –exposure, -ex 设置曝光模式 可能用到的参数为： l auto – 使用自动曝光模式 l night – 夜间拍摄模式 l nightpreview -夜间预览拍摄模式（暂且这么称呼） l backlight – 逆光拍摄模式 l spotlight – 聚光灯拍摄模式 l sports – 运动拍摄模式（高速快门等） l snow – 雪景优化拍摄模式 l beach – 海滩优化拍摄模式 l verylong – 长时间曝光拍摄模式 l fixedfps – 帧约束拍摄模式 l antishake – 防抖模式 l fireworks – 烟火优化拍摄模式 注意，不是所有的设置都会在对摄像头进行微调时得到相应作用。 –awb, -awb 设置自动白平衡 可能用到的参数为： l off – 关闭白平衡测算 l auto – 自动模式（默认） l sun – 日光模式 l cloud – 多云模式 l shade – 阴影模式 l tungsten – 钨灯模式 l fluorescent – 荧光灯模式 l incandescent – 白炽灯模式 l flash – 闪光模式 l horizon – 地平线模式 –imxfx, -ifx 设置图像特效 设置应用于图像上的特效 可能用到的参数为： l none – 无特效（默认） l negative – 反色图像 l solarise – 曝光过度图像 l posterize – 色调图像 l whiteboard – 白板特效 l blackboard – 黑板特效 l sketch – 素描风格特效 l denoise – 降噪图像 l emboss – 浮雕图像 l oilpaint – 油画风格特效 l hatch – 草图特效 l gpen – 马克笔特效 l pastel – 柔化风格特效 l watercolour – 水彩风格特效 l film – 胶片颗粒风格特效 l blur – 模糊图像 l saturation – 色彩饱和图像 l colourswap – 暂未可用 l washedout – 暂未可用 l posterise – 暂未可用 l colourpoint – 暂未可用 l colourbalance – 暂未可用 l cartoon – 暂未可用 –colfx, -cfx 设置色彩特效 指定图像 U 和 V 通道的参数（范围 0 到 255）。例如：–colfx 128:128 将得到一张单色图像。 –metering, -mm 设置测光模式 为预览和捕捉指定测光模式 可能用到的参数为： l average – 全画面平衡测光 l spot – 点测光 l backlit – 模拟背光图像 l matrix – 阵列测光 –rotation, -rot 设置图像旋转（0 – 359） 对取景器和最终得到的图像进行旋转。可以接受 0 以上任何值，但由于硬件限制，只支持 0、90、180、270 度。 –hflip, -hf 设置水平翻转 水平翻转预览和保存的图像。 –vflip, -vf 设置垂直翻转 垂直翻转预览和保存的图像。 –roi, -roi 设置传感器感光区域 允许指定用于预览和捕捉的源所使用的传感器区域。该功能中 x 和 y 参数指定了坐上角的坐标，以及定义了宽度和高度值，并且所有值都为标准化坐标（0.0 到 1.0）。那么，感光区域设置为横向和纵向都为一半，并且宽度和高度都为传感器的四分之一时，可以写为： -roi 0.5,0.5,0.25,0.25 –shutter, -ss 设置快门速度 设置快门的速度为指定的值（单位为微秒）。据当前的考证，目前未定义时，快门速度上限大约为 330000us（330ms 或 0.33s）。 应用程序专有设置 raspistill –width, -w 设置图像宽度 –height, -h 设置图像高度 –quality, -q 设置 JPEG 品质 继续阅读