主要内容

getdata

获取的图像帧MATLAB工作空间

语法

data = getdata (obj)
data = getdata (obj, n)
data = getdata (obj, n,类型
data = getdata (obj, n,类型格式
(数据、时间)= getdata(…)
[data, time, metadata] = getdata(…)

描述

data = getdata (obj)返回数据中指定的帧数FramesPerTrigger属性的视频输入对象objobj必须是一个1乘1的视频输入对象。

数据返回的是一个h × w × b × f矩阵

H

在对象中指定的图像高度ROIPosition财产

W

图像宽度,在对象中指定ROIPosition财产

B

颜色带的数目,如NumberOfBands财产

F

返回的帧数

数据返回到MATLAB®属性指定的颜色空间ReturnedColorSpace财产。

你可以使用MATLAB图像显示亮度图像函数查看返回的数据。使用imaqmontage一次查看多个帧。

data = getdata (obj, n)返回n与视频输入对象相关联的数据帧obj

data = getdata (obj, n,类型返回n与视频输入对象相关联的数据帧obj,在那里类型是下表中指定用于存储返回数据的数据类型的字符向量之一。

输入特征向量

数据类型

“uint8”

Unsigned 8位整数

“uint16”

16位无符号整数

“uint32”

32位无符号整数

“单一”

单精度

“双”

双精度

“本地”

使用本机数据类型。这是默认值。

如果类型没有指定,“本地”作为默认值。如果没有匹配对象原生数据类型的MATLAB数据类型,getdata选择MATLAB数据类型保持数值精度。例如,12位RGB颜色数据的每个组件将返回为uint8数据。

data = getdata (obj, n,类型格式返回n与视频输入对象相关联的数据帧obj,在那里格式是下表中指定的MATLAB格式的字符向量之一数据

请注意

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

格式特征向量

描述

“数字”

返回数据作为一个h × w × b × f数组。如果没有指定,这是默认格式。

“细胞”

返回数据为h × w × b矩阵的f × 1单元格数组

(数据、时间)= getdata(…)返回时间,一个F × 1矩阵,其中F是返回的帧数数据.的每个元素时间对应帧的相对时间,以秒为单位数据,相对于第一个触发器。

时间= 0定义为数据记录开始的点。当数据记录开始时,对象的日志记录属性设置为“上”时间相对于0连续测量,直到采集停止。当获取停止时,对象的运行属性设置为“关闭”

[data, time, metadata] = getdata(…)返回元数据,一个F乘1的结构数组,其中F是返回的帧数数据.每个结构都包含关于中相应框架的信息数据.的元数据结构包含以下字段:

元数据字段

描述

“AbsTime”

获得帧的绝对时间,表示为时间向量

“FrameNumber”

数字识别n开始命令发布

“RelativeFrame”

数字识别n相对于触发器开始的帧

“TriggerIndex”

获取帧的触发器的编号

除了上表中的字段外,一些适配器还可能选择添加其他特定于适配器的元数据。

getdata是一个阻塞函数,在请求的帧数在指定的时间内可用后返回执行控制到MATLAB工作空间超时财产。对象的FramesAvailable属性将根据返回的帧数自动减少getdata.如果请求的帧数大于要获取的帧数,getdata返回一个错误。

有可能发出一个Ctrl + Cgetdata是阻塞的。这并不会停止获取,但会将控制返回到MATLAB。

例子

构造一个与矩阵关联的视频输入对象®ID为1的设备

Obj = videoinput(' matrix ', 1);

发起采集并访问已记录的数据。

开始(obj);data = getdata (obj);

显示所获取的图像帧。

imaqmontage(数据);

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

删除(obj);
之前介绍过的R2006a