主要内容

预习

预览实时视频数据

句法

预览(OBJ)
预览(OBJ,Hemage)
hemage = preview(...)

描述

预览(OBJ)创建一个视频预览窗口,显示视频输入对象的实时视频数据obj.。窗口还显示每个帧的时间戳和视频分辨率,当前帧速率和当前状态obj.。视频预览窗口以100%放大率显示视频数据。预览图像的大小由视频输入对象的值确定罗瓦定位财产。

视频预览窗口的组件

视频预览窗口保持活动状态,直到停止使用stoppreview.或使用rotectpreview.。如果通过调用删除对象删除(obj),视频预览窗口停止预览并自动关闭。

预览(OBJ,Hemage)显示视频输入对象的实时视频数据obj.在句柄指定的图像对象中优秀预习缩放图像数据以填充图像对象的整个区域,但不修改任何图像对象属性的值。使用此语法在您自己设计的自定义GUI中预览视频数据(请参阅示例)。

hemage = preview(...)回报优秀,一个包含预览数据的图像对象的句柄。要获取包含图像对象的图形窗口的句柄,请使用祖先功能。有关使用图像对象的更多信息,请参阅图像。有关返回的图像对象的更多信息,请参阅自定义更新功能部分。

笔记

视频预览窗口的行为取决于视频输入对象的当前状态和触发配置。

对象状态

预览窗口行为

跑步=关闭

显示所有触发类型的从设备获取的图像的实时视图。更新图像以反映对对象属性配置所做的更改。(这Framegrabinterval.在发生触发状态之前忽略了属性。)

跑步=上

如果triggertype.被设置为即时要么手动的,视频预览窗口继续更新显示的图像。

如果triggertype.被设置为硬件,视频预览窗口停止更新显示显示的图像,直到发生触发。

logging = ON.

视频预览窗口可能会丢弃一些数据帧,但这不会影响记录到内存或磁盘的帧。

笔记

图像采集工具箱™预览窗口和内置于图像采集工具中的预览窗口支持最多16位图像数据的显示。金宝app预览窗口仅设计为仅显示8位数据,但许多相机返回10-,12-,14或16位数据。预览窗口显示屏支持这些更高的位深度摄像机。金宝app然而,为了显示预览数据,将较大的比特数据缩放为8位。要在其完整位深度捕获预览窗口中的图像数据,用于灰度图像,请设置previewfullbitdepth.财产'在'

自定义更新功能

预习为图像对象创建应用程序定义的数据,优秀,分配它的名称'updatepreviewwindowfcn'并将其值设置为空数组([])。您可以配置该值'updatepreviewwindowfcn'应用数据并使用MATLAB检索其值®setappdata.getAppData.功能分别。

'updatepreviewwindowfcn'对于所获取的每个帧,不一定会调用。如果获得了新帧和'updatepreviewwindowfcn'对于前一个帧尚未完成执行,将为新帧生成未更新。如果您需要为每个获取的帧执行函数,请使用Framesacquiredfcn.反而。

您可以使用此功能来定义预览图像数据的自定义处理。什么时候预习调用您指定的函数句柄,它将三个参数传递给您的函数:

  • obj.- 正在预览视频输入对象

  • 事件- 包含图像帧信息的事件结构。有关更多信息,请参阅下文。

  • 优秀- 对正在更新的图像对象的句柄

事件结构包含以下字段:

场地

描述

数据

当前图像帧指定为h-by-by-b矩阵,其中h和w分别是图像高度和宽度,如图所示罗瓦定位属性,b是颜色频带的数量,如上所述NumberofBands.财产。

解决

字符向量,指定当前图像宽度和高度,如所定义的罗瓦定位财产。

地位

字符矢量描述视频输入对象的当前采集状态。

时间戳

字符矢量指定与当前图像帧相关联的时间戳。

fr

字符矢量在每秒帧中指定视频输入对象的当前帧速率。

例子

创建一个自定义的GUI。

数字('名称''我的自定义预览窗口');UICONTROL('细绳''关''打回来''关闭(GCF)');

创建用于预览的图像对象。

vidres = obj.videoratory;nbands = obj.numberofbands;Hemage =图像(Zeros(vidres(2),vidres(1),nbands));预览(OBJ,Hemage);

有关定制GUI的更多信息,请参阅预览定制的数据

在R2006A之前介绍