getsnapshot

立即返回单个图像帧

语法

帧= getsnapshot (obj) [frame, metadata] = getsnapshot(obj)

帧= getsnapshot (obj)立即返回一个图像帧，框架，从视频输入对象obj．返回的数据帧独立于视频输入对象FramesPerTrigger对财产的价值没有任何影响FramesAvailable或FramesAcquired财产。

的对象obj必须是一个1乘1的视频输入对象。

框架返回的是一个h × w × b矩阵在哪里

H	中指定的图像高度`ROIPosition`财产
W	中指定的图像宽度`ROIPosition`财产
B	与之相关的波段数`obj`的规定`NumberOfBands`财产

框架返回到MATLAB^®属性指定的颜色空间ReturnedColorSpace财产。

你可以使用MATLAB图像或显示亮度图像函数查看返回的数据。

[frame, metadata] = getsnapshot(obj)返回元数据，一个1乘1的结构数组。这个结构包含了关于相应帧的信息。元数据结构包含该字段AbsTime表示为时间向量，表示为获取帧的绝对时间。除了该字段外，一些适配器还可能选择添加其他特定于适配器的元数据。

请注意

如果obj正在运行但未记录日志，且已配置硬件触发器，则将发生超时错误。

中断了getsnapshot函数和返回控制到MATLAB命令行，发出C ^（Ctrl + C)命令。

请注意

要获得可用于某个函数的选项列表，请按选项卡在MATLAB命令行上输入函数后键入。列表将展开，您可以滚动以选择属性或值。有关使用这个高级选项卡补全功能的信息，请参见使用制表符补全函数．

创建一个视频输入对象。

Obj = videoinput(' matrix '， 1);

获取和显示单帧数据。

帧= getsnapshot (obj);图像(框架);

从内存中移除视频输入对象。

删除(obj);

举个使用的例子getsnapshot，请参阅图像采集工具箱™示例在循环中获取单个图像在例子在图像采集工具箱主文档中心页面的顶部列表，或者打开文件demoimaq_GetSnapshot。m在MATLAB编辑器中。

之前介绍过的R2006a