主要内容

getdata

获得的图像帧,MATLAB工作空间

语法

data = getdata (obj)
data = getdata (obj, n)
data = getdata (obj, n,类型)
data = getdata (obj, n,类型,格式)
(数据、时间)= getdata (…)
(数据、时间、元数据)= getdata (…)

描述

data = getdata (obj)返回数据,其中包含指定的帧的数量FramesPerTrigger视频输入对象的属性objobj必须是1×1视频输入对象。

数据作为一个返回H-by-W-by-B-by-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-by-W-by-B-by-F数组。如果没有指定这是默认格式。

“细胞”

返回数据作为F-by-1 H-by-W-by-B矩阵的单元阵列

(数据、时间)= getdata (…)返回时间,一个F-by-1矩阵F是返回的帧数数据。的每个元素时间显示的相对时间,在几秒钟内,相应的帧数据相对于第一个触发器。

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

(数据、时间、元数据)= getdata (…)返回元数据F-by-1数组的结构,F是返回的帧数数据。每个结构都包含相应的帧信息数据。的元数据结构包含这些字段:

元数据字段

描述

“AbsTime”

绝对时间框架了,表示为向量

“FrameNumber”

数字识别nth帧自开始命令发布

“RelativeFrame”

数字识别n坐标系相对于触发的开始

“TriggerIndex”

数的触发这个框架被收购

除了字段在上面的表中,一些适配器可以选择添加其他adaptor-specific元数据。

getdata是一个阻塞函数,它返回执行控制后的MATLAB工作区要求的帧数可用对象的指定的时间段内超时财产。对象的FramesAvailable属性自动减少返回的帧的数量getdata。如果请求帧的帧数大于被收购,getdata返回一个错误。

它可以发出Ctrl + Cgetdata是阻塞的。这并不阻止收购但MATLAB返回控制。

例子

构造一个视频输入对象与Matrox有关®设备ID 1。

obj = videoinput (' matrox ', 1);

发起一个采集和记录的数据的访问。

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

显示每个图像帧。

imaqmontage(数据);

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

删除(obj);

版本历史

之前介绍过的R2006a