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命令行上输入一个函数后，按。列表展开，您可以滚动选择属性或值。有关使用此高级选项卡完成功能的信息，请参见对函数使用Tab补全．

创建一个视频输入对象。

Obj = videoinput(' matrix '， 1);

获取并显示单帧数据。

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

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

删除(obj);

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

R2006a之前介绍过