读取相机图像

>## [读取相机图像]

![](/media/202601/2026-01-19_180102_6180590.38505614691810575.png)
>从实体相机已有的图像缓存中读取图像，清除图像缓存。
>
>## 模块原理
>调用相机接口，主要是抓图和清除缓存接口。
>
>## 使用场景
>相机触发出现异常或其他情况，导致产生了多余的图像缓存，才需要此模块将缓存读出或清除
>
>## 使用方法
>在需要清除时添加此模块，连接相机，根据需要调整模块参数
>
>### 前后序模块
>一般位于相机采图之后，辅助操作相机的缓存
>
>### 使用示例
<video width="640" height="360" controls>
  <source src="/media/attachment/2026/01/%E8%AF%BB%E5%8F%96%E7%9B%B8%E6%9C%BA%E5%9B%BE%E5%83%8F%E4%BD%BF%E7%94%A8%E7%A4%BA%E4%BE%8B.mp4">
</video>

>## 示例工程

> [点击下载工程](http://zhunyitec.local:30067/media/attachment/2026/01/%E8%AF%BB%E5%8F%96%E7%9B%B8%E6%9C%BA%E5%9B%BE%E5%83%8F%E6%B5%8B%E8%AF%95%E5%B7%A5%E7%A8%8B.zip)

>## 参数配置说明
>
>### 基本参数
>
![](/media/202601/2026-01-19_181551_0263730.45696049876599.png)
>【选择相机】连接想要操作的相机，根据实体相机，选择"相机0"，"相机1"。。。，选择"未设置"，则不会执行读取和清除操作
>【读图超时时间】读图所消耗的时间，超过该时间后仍读不到图像时则继续执行后续操作
>【读取图像后操作】选择"保留新采集图像", 在读一张图后仅从相机缓存中清除此张图像; 选择"清除新采集图像", 在读一张图后清空相机缓存
>
>## 输出说明

![](/media/202601/2026-01-19_181608_6443000.802124965411407.png)

>【运行结果】实体相机存在图像缓存且读取一张图像成功，输出为真，否则为假
>【黑白图像】从相机缓存中成功读取的一张图像，读取正常则输出图像尺寸，否则输出“N/A”
>
>## 注意事项
>一般情况下不需要用到此模块，只有在相机触发出现异常或其他意外情况，导致产生了多余的图像缓存，才需要此模块将缓存读出或清除
>

点击此处跳转到对应的中文说明书文章页:&nbsp;[Read Camera Image](/doc/598)