videoinput
创建视频输入对象
描述
一个videoinput
对象表示一个MATLAB之间的联系®和一个特定的图像采集设备。
创建
语法
描述
vid = videoinput (
创建一个视频输入对象适配器
)从视频
。适配器
是一个特征向量指定适配器的名称用于与设备进行通信。使用imaqhwinfo
确定系统上可用的适配器。
vid = videoinput (
创建一个视频输入对象适配器
,的deviceID
)从视频
,在那里的deviceID
是一个数字标量值,确定一个特定的设备可以通过指定的适配器,适配器
。使用imaqhwinfo(适配器)
确定指定的设备可以通过适配器。如果的deviceID
没有指定,使用第一个可用的设备ID。您还可以使用一个设备的名字代替的deviceID
。如果多个设备具有相同的名称,第一个可用的设备使用。
vid = videoinput (
创建一个视频输入对象适配器
,的deviceID
,格式
)从视频
,在那里格式
是一个特征向量,用于指定一个特定的视频格式支持的设备或设备配置文件的完整路径(有时也称为一个相机文件)。金宝app得到一个特定设备支持的格式列表,查看金宝appDeviceInfo
返回的结构装置imaqhwinfo
。每一个DeviceInfo
结构包含一个金宝appSupportedFormats
字段。如果格式
没有指定,那么将使用设备的默认格式。创建视频输入对象时,它的VideoFormat
属性包含格式名称或您指定的设备配置文件。
vid = videoinput (___,
创建一个视频输入对象和设置附加属性使用一个或多个名称参数除了输入参数在以前的语法。如果一个无效的属性名称或指定属性值,不是创建的对象。使用tab补齐来查看属性的完整列表,您可以设置您的适配器使用名称-值参数。名称,值
)
查看视频输入对象的功能和属性的完整列表,使用imaqhelp
。
请注意
工具箱中选择第一个可用的视频源对象选择的这个视频源和指定对象的源对象的名字SelectedSourceName
财产。使用getselectedsource (obj)
访问视频源对象,用于收购。
属性
一般性质
BayerSensorAlignment
- - - - - -拜耳demosaicing传感器校准
“grbg”
(默认)|“gbrg”
|“rggb”
|“bggr”
拜耳demosaicing传感器校准,指定为“grbg”
,“gbrg”
,“rggb”
,或“bggr”
。如果ReturnedColorSpace
属性设置为“拜耳”
,那么图像采集工具箱™将demosaic拜耳模式返回的硬件。这种颜色空间设置成标准RGB图像篡改拜耳模式编码图像。如果你的相机使用拜耳过滤、工具箱支持拜耳模式和可以返回颜色如果需要。金宝app
为了执行demosaicing,工具箱需要知道传感器的像素排列。这是订单的红色,绿色和蓝色的传感器,通常是通过描述指定四个像素传感器的左上角。这是乐队灵敏度的一致性解释的像素相机的内部硬件。你必须从相机获取这些信息的文档,然后指定对齐的值,如下表所述。
有四种可能的传感器校准。
价值 | 描述 |
---|---|
|
2×2传感器校准 绿色蓝色红色绿色 |
|
2×2传感器校准 绿红蓝绿 |
|
2×2传感器校准 蓝绿绿红 |
|
2×2传感器校准 红绿绿蓝 |
这个属性的值是只如果使用ReturnedColorSpace
属性设置为“拜耳”
。
的例子显示如何将拜耳图片,明白了拜耳图像转换。
数据类型:字符
|字符串
的DeviceID
- - - - - -图像采集设备ID
1(默认)|非负整数
这个属性是只读的。
图像采集设备ID指定的适配器,指定为一个非负整数。这个属性标识设备由视频输入对象。
设备ID是一个数字,由一个适配器,唯一地标识一个图像采集装置。适配器分配第一设备检测标识符1
,第二个设备检测标识符2
,等等。
您可以指定的设备ID作为输入videoinput
当您创建一个视频输入对象函数。对象存储中的值的DeviceID
财产以及使用价值构建的缺省值的名字
财产。
得到的id列表的设备连接到您的系统,使用imaqhwinfo
函数,指定一个特定的适配器的名称作为参数。
数据类型:双
FrameGrabInterval
- - - - - -多长时间获得从视频帧
1
(默认)|正整数。
多长时间的视频输入对象获得一帧视频,指定为一个正整数。默认情况下,对象获取视频的每一帧,但是您可以使用这个属性来指定其他收购的间隔。
请注意
不要混淆抓帧间隔帧速率。帧率描述了一个图像采集装置的速度提供了框架,通常以秒,如30帧/秒。抓帧间隔以帧,不是秒。如果一个特定设备的帧率是可配置的,视频源对象可能包括帧速率作为一个特定于设备的属性。
例如,当您指定一个FrameGrabInterval
的价值3
,对象获得每三帧的视频,见此图。对象获得第一帧的视频应用FrameGrabInterval
。
您指定的视频流的来源SelectedSourceName
财产。
数据类型:双
FramesAcquired
- - - - - -帧总数
0
(默认)|非负整数
这个属性是只读的。
的帧总数对象了,不管有多少帧被从内存缓冲区中提取,指定为一个非负整数。视频输入对象不断更新的值FramesAcquired
财产获得帧。
请注意
当你发出开始
指挥、视频输入对象的值重置FramesAcquired
财产0
(零)和刷新缓冲区。
找出有多少帧可用的内存缓冲区,使用FramesAvailable
财产。
数据类型:双
FramesAvailable
- - - - - -的帧数可用的内存缓冲区
0
(默认)|非负整数
这个属性是只读的。
帧总数可用内存缓冲区,指定为一个非负整数。在提取数据时,对象减少的价值FramesAvailable
属性的适当数量的帧。您使用getdata
MATLAB函数来提取数据并移动它到工作区。
请注意
当你发出开始
指挥、视频输入对象的值重置FramesAvailable
财产0
(零)和刷新缓冲区。
查看的帧总数已经收购了自从上次开始
命令,可以使用FramesAcquired
财产。
数据类型:双
的名字
- - - - - -图像采集对象的名称
特征向量|字符串标量
图像采集对象的名称,指定为一个特征向量或字符串标量。
工具箱创建默认名称相结合的价值VideoFormat
和的DeviceID
用这种格式的适配器名称属性:VideoFormat
+”
- - - - - -”
+适配器名称+”
- - - - - -”
+的DeviceID
数据类型:字符
|字符串
NumberOfBands
- - - - - -颜色的数量获得数据
正整数
这个属性是只读的。
颜色的数量数据,指定为一个正整数。工具箱中定义乐队第三维度的三维数组,如这个图所示。
的值NumberOfBands
属性显示的数量颜色乐队在返回的数据getsnapshot
,getdata
,peekdata
。
数据类型:双
PreviewFullBitDepth
- - - - - -是否显示在预览数据完整的位深度
“关闭”
(默认)|“上”
预览窗口中的图像数据是否显示在完整的位深度,指定为“关闭”
或“上”
。
请注意
图像采集的工具箱预览窗口支持多达16位图像数据的显示。金宝app预览窗口是为了只显示8位数据,但是许多相机返回10 - 12 - 14或16位数据。预览窗口显示支持这些更高的位深度相机。金宝app然而,更大的一些数据是按比例缩小的8位显示预览数据的目的。捕获的图像数据完整的位深度的预览窗口灰度图像、设置PreviewFullBitDepth
财产“上”
。
如果你设定这个属性“关闭”
预览窗口中,图像数据缩小从8位的位深度。如果你设定这个属性“上”
,预览窗口中的图像数据被捕获在其完整的位深度。
这个属性可以设置为“上”
只有当的值ReturnedColorspace
属性设置为“灰度”
和视频格式高于8位深度。
数据类型:字符
|字符串
预览
- - - - - -是否目前在单独的窗口预览数据对象
“关闭”
(默认)|“上”
这个属性是只读的。
对象是否正在预览的数据在一个单独的窗口中,指定为“关闭”
或“上”
。
对象集预览
财产“上”
当你打电话给预览
函数。
对象集预览
财产“关闭”
当你关闭预览窗口使用closepreview
函数或通过单击关闭在预览窗口标题栏的按钮。
数据类型:字符
ReturnedColorSpace
- - - - - -颜色空间中使用MATLAB
“灰度”
|“rgb”
|“YCbCr”
|“拜耳”
颜色你想要空间工具箱时使用它返回图像数据到MATLAB工作区,指定为“灰度”
,“rgb”
,“YCbCr”
,或“拜耳”
。这只是有关当你访问获得的图像数据getsnapshot
,getdata
,peekdata
功能。
这个属性可以有下列值:
价值 | 描述 |
---|---|
“灰度” |
MATLAB的灰度空间。 |
“rgb” |
MATLAB RGB颜色空间。 |
“YCbCr” |
MATLAB YCbCr颜色空间。 注意到YCbCr通常是不严密地称为YUV。(YUV是相似的,但又不完全相同。他们相差比例因子应用于结果。YUV指一个特定的比例因子用于复合NTSC和PAL格式。在大多数情况下,您可以指定YCbCr YUV颜色空间设备支持)。金宝app |
“拜耳” |
灰度拜耳颜色模式转换为RGB图像。的 使用 |
请注意
等一些适配器,GigE GenTL,如果您使用一个格式,从拜耳(如。BayerGB8_640x480
),原始——拜耳模式自动转换颜色ReturnedColorSpace
是RGB。如果你设置ReturnedColorSpace
来“灰度”
,你会得到的原始模式。
为一个例子,演示如何确定默认颜色空间和改变颜色空间设置,明白了指定的颜色空间。
数据类型:字符
|字符串
ROIPosition
- - - - - -的窗口(ROI)
[0 0宽度高度)
(默认)|1-by-4元素向量
的收购窗口中,指定为1-by-4元素向量。ROI定义了框架的实际尺寸记录的工具箱,对测量图像的左上角。
ROIPosition
被指定为一个1-by-4元素向量[XOffset YOffset宽度高度)
。
XOffset |
ROI的左上角的位置,以像素。 |
YOffset |
ROI的左上角的位置,以像素。 |
宽度 |
ROI的宽度,单位为像素。的总和 |
高度 |
ROI的高度,以像素。的总和 |
请注意
的宽度
不包括两个端点以及像素之间的宽度。它包括一个终点,加上像素之间的宽度。举个例子,如果你想捕捉一个ROI的像素20到30,包括像素20到30,设置一个XOffset
的19
和一个宽度
的11
。同样的规则也适用于高度
。
在上面的图中,捕获的ROI的宽度包含像素51到170年,包括端点,因为XOffset
被设置为50
和宽度
被设置为120年
。
数据类型:双
运行
- - - - - -视频输入对象是否准备获取数据
“关闭”
(默认)|“上”
这个属性是只读的。
视频输入对象是否准备获取数据,指定为“关闭”
或“上”
。
随着日志记录
财产,运行
反映了视频输入对象的状态。的运行
属性表明对象准备获得数据,而日志记录
属性表明对象是获取数据。
对象集运行
财产“上”
当你的问题开始
命令。当运行
是“上”
,你可以从一个视频源获取数据。
对象集运行
财产“关闭”
当满足下列条件:
获得指定的帧数。
运行时发生错误。
你的问题
停止
命令。
当运行
是“关闭”
,你不能获得图像数据。然而,您可以获得一个图像帧的getsnapshot
函数。
数据类型:字符
超时
- - - - - -的时间等图像数据
10(默认)|正整数
在秒的时间getdata
和getsnapshot
函数等待返回数据,指定为一个正整数。的超时
财产只是与这些阻塞函数相关联。如果指定的时间到期,MATLAB的函数返回控制命令行。
超时是阻止收购的条件之一。超时发生时,对象是跑步,MATLAB文件所指定的功能ErrorFcn
被称为。
请注意
的超时
财产与硬件无关超时条件。
数据类型:双
用户数据
- - - - - -存储数据与图像采集对象
任何类型
存储数据,你想结交一个图像采集对象,指定为任何MATLAB数据类型。
请注意
对象不使用的数据用户数据
直接。然而,您可以访问数据通过引用属性将一个字段MATLAB结构使用点符号。
VideoFormat
- - - - - -视频格式或设备配置文件的名称
特征向量
这个属性是只读的。
视频格式所使用的图像采集设备或设备的配置文件的名称,这取决于您指定在创建对象时,指定为一个特征向量。
图像采集设备通常支持多种视频格式。金宝app当您创建一个视频输入对象时,您可以指定您想要的视频格式所使用的设备。如果你不指定视频格式作为参数,videoinput
函数使用默认格式。使用imaqhwinfo
函数来确定哪些视频格式特定设备支持并找出哪些是默认格式。金宝app
作为一种替代方法,您可以指定一个设备配置文件的名称,也称为相机文件或数字化仪配置格式(DCF)文件。一些图像采集设备使用这些文件存储设备配置信息。的videoinput
函数可以使用这个文件来确定视频格式和其他配置信息。
使用imaqhwinfo
函数来确定你的设备支持设备配置文件。金宝app
数据类型:字符
VideoResolution
- - - - - -宽度和高度的视频流
(宽高)
这个属性是只读的。
宽度和高度的像素帧在传入的视频流,指定为一个双元素向量(宽高)
。
请注意
你创建时指定视频分辨率视频输入对象,通过视频格式的参数videoinput
函数。如果你不指定一个视频格式,videoinput
函数使用默认的视频格式。使用imaqhwinfo
函数来确定哪些视频格式特定设备支持并找出哪些是默认格式。金宝app
数据类型:双
数据日志记录属性
日志记录
- - - - - -是否目前测井数据对象
“关闭”
(默认)|“上”
这个属性是只读的。
视频输入对象是目前测井资料,是否指定为“关闭”
或“上”
。
当触发发生时,对象设置日志记录
财产“上”
和日志数据,内存,磁盘文件,或两者兼而有之,这取决于的价值LoggingMode
财产。
对象集日志记录
财产“关闭”
当它获得要求的帧数,出现错误,或者你发出停止
命令。
获取数据时,对象但不是日志,运行使用peekdata
函数。的peekdata
函数不保证所有返回所请求的图像数据。获取所有的数据没有差距,您必须对象记录数据到内存或磁盘文件。
数据类型:字符
LoggingMode
- - - - - -获得数据的目的地
“记忆”
(默认)|“磁盘”
|“磁盘和内存”
目的地获取数据,指定为“记忆”
,“磁盘”
,或“磁盘和内存”
。这个属性指定了要视频输入对象存储获取的数据。您可以指定下列值:
价值 |
描述 |
---|---|
“磁盘” |
日志获取数据到磁盘上的一个文件里。 |
“磁盘和内存” |
日志获取数据到磁盘文件和内存缓冲区。 |
“记忆” |
日志获取数据到内存缓冲区。 |
如果您选择“磁盘”
或“磁盘和内存”
AVI文件,您必须指定对象用于访问磁盘文件的价值DiskLogger
财产。
请注意
日志数据内存时,必须及时提取获得的数据的getdata
函数来避免使用系统上所有可用的内存。
请注意
的peekdata
函数不返回任何数据,如果在磁盘日志记录模式下运行。
数据类型:字符
|字符串
DiskLogger
- - - - - -MATLABVideoWriter
文件用于记录数据
[]
(默认)|VideoWriter
对象
MATLABVideoWriter
文件用于记录数据,指定为一个VideoWriter
对象。这个属性指定了VideoWriter
当文件对象用于记录数据LoggingMode
属性设置为“磁盘”
或“磁盘和内存”
。
为了获得最佳的性能,记录到磁盘需要MATLABVideoWriter
对象,该对象是一个MATLAB对象,而不是一个图像采集工具箱对象。在您创建和配置VideoWriter
对象,您可以指定它DiskLogger
财产。
一个MATLABVideoWriter
对象指定了文件名和其他特征。例如,您可以使用VideoWriter
属性指定配置文件用于数据压缩和所需的输出质量。完整的信息VideoWriter
对象及其属性,看到VideoWriter
。
请注意
不要使用返回的变量VideoWriter
函数在执行任何操作VideoWriter
文件时被一个视频输入对象数据日志记录。例如,不改变任何VideoWriter
文件属性,添加帧或关闭对象。您的更改可以与视频输入对象发生冲突。
后日志记录
和运行
了,可能吗DiskLogger
可能仍然是写数据到磁盘。当DiskLogger
完成数据写入磁盘,的值DiskLoggerFrameCount
属性的值应该等于FramesAcquired
财产。不要关闭或修改吗DiskLogger
直到满足这个条件。
关于日志记录图像数据使用的更多信息VideoWriter
文件的更多信息,请参考日志记录图像数据到磁盘。
请注意
的peekdata
函数不返回任何数据,如果在磁盘日志记录模式下运行。
DiskLoggerFrameCount
- - - - - -的帧数写入磁盘
非负整数
这个属性是只读的。
的帧数写入磁盘,指定为任何非负整数。这个属性表示当前帧写入磁盘的数量DiskLogger
。这个值时只更新LoggingMode
属性设置为“磁盘”
或“磁盘和内存”
。
后日志记录
和运行
了,可能吗DiskLogger
可能仍然是写数据到磁盘。当DiskLogger
完成数据写入磁盘,的值DiskLoggerFrameCount
属性的值应该等于FramesAcquired
财产。不要关闭或修改吗DiskLogger
直到满足这个条件。
数据类型:双
事件和回调属性
事件日志
- - - - - -事件信息
数组的结构
这个属性是只读的。
关于事件的信息,指定为一个结构数组。每一个结构数组中代表一个事件。事件记录在它们发生的顺序。第一个事件日志
结构反映了第一个事件记录,第二个事件日志
结构反映了第二个事件记录,等等。
每个事件日志结构包含两个字段:类型
和数据
。
的类型
字段存储字符数组标识事件类型。图像采集工具定义了许多不同的事件类型,表中列出。请注意,并不是所有的事件类型都记录下来。
事件类型 |
描述 |
包括在日志 |
---|---|---|
错误 |
运行时错误发生。运行时错误包括超时和硬件错误。 |
是的 |
帧收购 |
中指定的帧的数量 |
没有 |
开始 |
对象是通过调用创建的 |
是的 |
停止 |
对象停止执行。 |
是的 |
计时器 |
计时器过期了。 |
没有 |
触发 |
触发执行。 |
是的 |
的数据
字段存储与特定事件相关的信息。例如,所有事件返回绝对时间的事件发生AbsTime
字段。其他相关的字段都包含在数据
。有关更多信息,请参见获取事件信息。
事件日志
最多可以储存1000事件。如果超过这个值,那么存储最近的1000事件。
数据类型:结构体
ErrorFcn
- - - - - -回调函数执行时,运行时发生错误
imaqcallback
(默认)|特征向量|函数处理|单元阵列
回调函数执行时一个错误事件发生时,指定为一个特征向量,处理函数,数组或单元。一个运行时错误事件后立即生成运行时发生错误。
运行时错误包括硬件错误和超时。运行时错误不包括配置错误,例如设置无效的属性值。
事件信息存储在运行时错误事件日志
财产。您可以检索任何错误消息Data.Message
领域的事件日志
。
请注意
回调函数,包括ErrorFcn
执行,只有当视频对象运行状态。如果你需要使用ErrorFcn
回调用于错误处理在预览,预览之前你必须启动视频对象。这样做没有日志数据,使用手动触发。
数据类型:字符
|字符串
|细胞
|function_handle
FramesAcquiredFcn
- - - - - -回调函数执行时指定的帧数已经收购了
[]
(默认)|特征向量|函数处理|单元阵列
每次回调函数执行预定义的帧数已经收购了,指定为一个特征向量,处理函数,数组或单元。
帧收购事件后立即生成指定的帧的数量FramesAcquiredFcnCount
从选中的视频源获得的财产。这个事件执行指定的MATLAB文件FramesAcquiredFcn
。
使用FramesAcquiredFcn
回调,如果你必须访问获得的每一帧。如果你没有这个需求,你可能想要使用TimerFcn
财产。
帧获取事件信息不是存储在事件日志
财产。
数据类型:字符
|字符串
|细胞
|function_handle
FramesAcquiredFcnCount
- - - - - -之前必须获得帧的帧数收购事件生成
0
(默认)|正整数
从选中的视频源的帧数获取帧生成收购事件之前,指定为一个正整数。
对象生成一个帧事件后立即获得指定的帧的数量FramesAcquiredFcnCount
从选中的视频源获得的。
数据类型:双
StartFcn
- - - - - -回调函数执行时开始事件发生
[]
(默认)|特征向量|函数处理|单元阵列
执行回调函数,当一个事件发生时,指定为一个特征向量,处理函数,数组或单元。首先事件发生后立即发出开始
命令。
的StartFcn
回调执行同步。工具箱不设置对象的运行
财产“上”
直到回调函数执行完毕。如果遇到错误,回调函数对象从未开始运行。
事件信息存储在开始事件日志
财产。
数据类型:字符
|字符串
|细胞
|function_handle
StopFcn
- - - - - -停止事件发生时执行的回调函数
[]
(默认)|特征向量|函数处理|单元阵列
回调函数执行时停止事件发生时,指定为一个特征向量,处理函数,数组或单元。你问题后立即停止事件发生停止
命令。
的StopFcn
回调执行同步。在大多数情况下,图像采集对象将停下来运行
属性将被设置为“关闭”
通过MATLAB文件完成的时间执行。
停止事件信息存储在事件日志
财产。
数据类型:字符
|字符串
|细胞
|function_handle
TimerFcn
- - - - - -回调函数执行计时器事件发生时
[]
(默认)|特征向量|函数处理|单元阵列
回调函数执行当一个计时器事件发生时,指定为一个特征向量,处理函数,数组或单元。一个计时器事件发生在指定的时间段TimerPeriod
产权到期。
工具箱措施时间相对于对象时开始的开始
函数。计时器事件停止时生成图像采集对象停止运行。
请注意
一些计时器事件可能无法处理你的系统是显著放缓或者TimerPeriod
您指定值太小了。
数据类型:字符
|字符串
|细胞
|function_handle
TimerPeriod
- - - - - -计时器事件之间的秒数
1(默认)|积极的价值大于0.01
以秒为单位的时间,必须通过触发计时器事件之前,指定为一个积极的价值大于0.01。
工具箱措施时间相对于对象时开始的开始
函数。计时器事件停止时生成图像采集对象停止运行。
请注意
一些计时器事件可能无法处理你的系统是显著放缓或者TimerPeriod
您指定值太小了。
数据类型:双
TriggerFcn
- - - - - -回调函数执行触发事件发生时
[]
(默认)|特征向量|函数处理|单元阵列
回调函数执行触发事件发生时,指定为一个特征向量,处理函数,数组或单元。工具箱生成一个触发事件触发时执行基于配置的TriggerType
和数据日志记录开始。
在大多数情况下,MATLAB文件回调函数是不能保证完整的执行直到工具箱后设置日志记录
财产“上”
。
信息存储在触发事件事件日志
财产。
数据类型:字符
|字符串
|细胞
|function_handle
触发属性
TriggerType
- - - - - -通过视频输入对象使用的触发类型
“立即”
(默认)|“硬件”
|“手动”
这个属性是只读的。
视频输入对象使用的触发类型,指定为“立即”
,“硬件”
,或“手动”
。触发启动数据采集。
您使用triggerconfig
函数来为这个属性指定以下值之一。
|
描述 |
---|---|
|
当满足指定条件触发执行。你使用指定条件 |
|
你电话后立即触发执行 |
|
你电话后立即触发执行 |
数据类型:字符
TriggerCondition
- - - - - -在触发事件发生时所需的状态
特征向量
这个属性是只读的。
必须满足的条件,通过TriggerSource
,在触发事件发生时,指定为一个特征向量。触发条件,您可以指定依赖的价值TriggerType
财产。
|
可用的条件 |
---|---|
|
特定于设备的。例如,一些Matrox®硬件支持条件等金宝app |
|
|
|
|
你必须使用triggerconfig
函数来设置这个属性的值。
数据类型:字符
TriggerSource
- - - - - -源监控硬件触发条件
特征向量
这个属性是只读的。
硬件源图像采集对象监视器触发条件,指定为一个特征向量。中指定的条件TriggerCondition
对象属性,执行触发器并开始获取数据。
您使用triggerconfig
函数来指定这个值。的值TriggerSource
房地产是设备特定的。你指定任何特定设备用来生成触发机制。
例如,对于Matrox硬件,TriggerSource
属性值等“Port0”
或“端口1”
。使用triggerinfo
功能视图的列表值是有效的为你的图像采集设备。
你必须使用triggerconfig
函数来设置这个属性的值。
请注意
的TriggerSource
属性时才使用TriggerType
属性设置为“硬件”
。
数据类型:字符
FramesPerTrigger
- - - - - -的帧数获得每触发使用选定的视频源
10
(默认)|正整数
视频的帧数输入对象获得每次执行触发器使用选定的视频源,指定为一个正整数。
当的值FramesPerTrigger
属性设置为正
,对象获取帧直到出现错误或者问题停止
命令。
请注意
当FramesPerTrigger
属性设置为正
,对象忽略的价值TriggerRepeat
财产。
数据类型:双
InitialTriggerTime
- - - - - -绝对时间的第一个触发器
[]
(默认)|MATLAB时钟向量
这个属性是只读的。
绝对时间的第一个触发器,作为MATLAB时钟返回向量。
对于所有类型的触发器,InitialTriggerTime
记录时日志记录
属性设置为“上”
。
找到随后触发执行的时候,查看Data.AbsTime
场的事件日志
属性为特定触发。
数据类型:双
TriggerFrameDelay
- - - - - -之前获取帧之后的帧数跳过触发发生
0(默认)|整数
之前获取帧之后的帧数跳过一个触发器时,指定为一个整数。对象等待触发后的指定数量的帧之前开始日志框架。
在这个图中,TriggerFrameDelay
被设置为5
,所以对象让五帧传递开始前获得帧。定义的帧捕获的数量FramesPerTrigger
财产。
数据类型:双
TriggerRepeat
- - - - - -额外的次数执行触发器
0(默认)|非负整数
你想要额外的次数对象执行触发器,指定为一个非负整数。此表描述了几种典型的行为TriggerRepeat
值。
价值 |
行为 |
---|---|
|
执行触发一次当触发条件满足。 |
任何正整数 |
执行触发指定数量的额外的时候触发条件满足。 |
|
每次保持执行触发器触发条件满足,直到 |
确定有多少触发执行,检查的价值TriggersExecuted
财产。
请注意
如果FramesPerTrigger
属性设置为正
,对象忽略的价值TriggerRepeat
财产。
数据类型:双
TriggersExecuted
- - - - - -总数执行触发器
0(默认)|非负整数
这个属性是只读的。
总数的触发器执行视频输入对象,指定为一个非负整数。
数据类型:双
视频源对象属性
父
- - - - - -视频输入视频源对象的父对象
videoinput
对象
这个属性是只读的。
视频输入对象的父一个视频源对象,指定为一个videoinput
对象。
视频源的父对象被定义为视频输入对象拥有视频源对象。
选择
- - - - - -是否视频源对象将用于收购
“关闭”
(默认)|“上”
这个属性是只读的。
是否视频源对象将用于收购,指定为“关闭”
或“上”
。你选择一个视频源对象通过指定名称的值输入对象的视频SelectedSourceName
财产。视频输入对象源
所有视频源的属性是一个数组对象与视频输入对象相关联。
如果选择
是“上”
,视频源对象被选中。如果该值为“关闭”
,视频源对象不是选择。
一个视频源被定义的一个或多个物理数据源的集合被当作一个单一的实体。例如,硬件支持多个RGB的来源,这是由三个物金宝app理连接(红、绿、蓝),被视为一个视频源对象。
数据类型:字符
SourceName
- - - - - -视频源对象的名称
特征向量
这个属性是只读的。
一个视频源对象的名称,指定为一个特征向量。
SourceName
是一种视频输入对象中的值的吗SelectedSourceName
财产。
数据类型:字符
标签
- - - - - -描述性的文本与图像采集对象
特征向量|字符串标量
描述性的文本,你想要结交一个图像采集对象,指定为一个特征向量或字符串标量。
的标签
属性可以是有用的,当你构建程序,否则需要定义图像采集对象作为一个全局变量,或回调例程之间传递的对象作为参数。
您可以使用的价值标签
属性来搜索特定的图像采集对象在使用imaqfind
函数。
数据类型:字符
|字符串
类型
- - - - - -图像采集对象的类型
“videoinput”
|“videosource”
这个属性是只读的。
类型的图像采集对象,指定为“videoinput”
或“videosource”
。一个图像采集对象可以是两种类型:
视频输入对象
视频源对象
数据类型:字符
采集源属性
SelectedSourceName
- - - - - -当前选择的视频源
特征向量
视频源对象的视频名称输入对象获取数据,指定为一个特征向量。默认情况下,视频输入对象选择对象存储在第一个可用的视频源源
财产。
工具箱将一个视频源定义为一个或多个硬件投入,被视为一个单一的实体。例如,硬件支持多个RGB的来源,这是由三个物金宝app理连接(红绿蓝),被视为一个视频源对象。
数据类型:字符
|字符串
源
- - - - - -视频源对象与视频输入对象相关联
视频源对象
这个属性是只读的。
视频源对象的向量表示物理数据源的连接到一个设备。创建一个视频输入对象时,工具箱创建一个向量与视频相关的视频源对象输入对象。
提供每个视频源对象创建一个独特的名字来源。您可以使用源名称来选择所需的采集源通过配置SelectedSourceName
视频输入对象的属性。
一个视频源对象存储在它的名字是SourceName
财产。如果一个视频源对象的SourceName
相当于视频输入对象的SelectedSourceName
,视频对象的来源选择
属性的值为“上”
。
视频源对象支持一组共同的属性,比如金宝appSourceName
。每个视频源对象还可以支持特定于设备的属性,物理设备的控制特征如亮度、金宝app色调和饱和度。不同的图像采集设备暴露不同的属性。
一个视频源被定义的一个或多个物理数据源的集合被当作一个单一的实体。例如,硬件支持多个RGB的来源,这是由三个物金宝app理连接(红绿蓝),被视为一个视频源对象。
的源
属性封装了一个或多个视频源。引用一个视频源,你使用一个数值的整数索引视频源对象的向量。
GigE属性
IgnoreDroppedFrames
- - - - - -收购是否继续当它遇到了框架
“关闭”
(默认)|“上”
收购是否继续当遇到掉帧,指定为“关闭”
或“上”
。
如果将此属性设置为“关闭”
,收购停止当它遇到了框架。如果将此属性设置为“上”
,收购继续忽略掉帧。
当这个属性“上”
跟踪帧的数量下降,而收购的NumDroppedFrames
财产。
请注意
此属性仅支持金宝appvideoinput
对象的使用gige
适配器,不支持金宝appgigecam
对象。
数据类型:字符
|字符串
NumDroppedFrames
- - - - - -收购是运行时的帧数下降
0(默认)|非负整数
这个属性是只读的。
的帧数收购运行时如果下降IgnoreDroppedFrames
属性设置为“上”
,指定为一个非负整数。
这个属性并不跟踪预览时的帧数下降。
请注意
此属性仅支持金宝appvideoinput
对象的使用gige
适配器,不支持金宝appgigecam
对象。
数据类型:双
对象的功能
配置
执行
getselectedsource |
返回当前选择的视频源对象 |
开始 |
获得独家使用的图像采集设备 |
停止 |
停止视频输入对象 |
等待 |
等到图像采集对象停止运行或日志记录 |
触发功能
触发 |
启动数据记录 |
triggerconfig |
配置视频输入对象触发属性 |
triggerinfo |
提供可用触发配置信息 |
数据功能
flushdata |
把数据从内存缓冲区用于存储获取的图像帧 |
getdata |
获得的图像帧,MATLAB工作空间 |
getsnapshot |
立即回复单帧图像 |
peekdata |
最近获得的图像数据 |
工具
closepreview |
关闭视频预览窗口 |
imaqmontage |
序列图像帧的蒙太奇 |
预览 |
实时视频数据的预览 |
一般
信息和帮助
imaqhelp |
图像采集对象功能和属性的帮助 |
imaqhwinfo |
图像采集硬件可用的信息 |
propinfo |
图像采集对象的属性特征 |
例子
创建视频输入对象
构造一个视频输入对象。
obj = videoinput (“matrox”1);
选择源用于收购。
obj。SelectedSourceName =“input1”
视图选择视频源对象的属性。
src_obj = getselectedsource (obj);get (src_obj)
预览图像帧的流。
预览(obj);
获取并显示一个图像帧。
帧= getsnapshot (obj);图像(框架);
输入对象从内存中删除视频。
删除(obj);
使用VideoWriter
创建一个视频输入对象访问GigE愿景®图像采集设备和使用灰度格式10位/像素。
vidobj = videoinput (“gige”,1“Mono10”);
你可以日志获取数据到内存,磁盘,或两者兼而有之。默认情况下,数据记录到内存中。更改日志记录到磁盘模式,配置视频输入对象的LoggingMode
财产。
vidobj。日志记录Mode =“磁盘”
创建一个VideoWriter
对象的概要集运动JPEG 2000。运动JPEG 2000允许完整的10位/像素数据写入该文件。
vidobj。DiskLogger = VideoWriter (“logfile.mj2”,“运动JPEG 2000”)
现在的视频输入对象配置日志数据运动JPEG 2000文件,发起收购。
开始(vidobj)
等待收购完成。
等待(vidobj)
当记录大量数据到磁盘,磁盘写偶尔滞后于收购。是否所有的框架都写入磁盘,您可以选择使用DiskLoggerFrameCount
财产。
而(vidobj。FramesAcquired ~ = vidobj.DiskLoggerFrameCount)暂停(1。)结束
你可以验证FramesAcquired
和DiskLoggerFrameCount
属性完全相同的值通过使用这些命令和输出比较。
vidobj。FramesAcquired vidobj.DiskLoggerFrameCount
视频输入对象不再需要时,从工作区中删除它和清晰。
删除(vidobj)清晰vidobj
版本历史
之前介绍过的R2006a
MATLAB명령
다음MATLAB명령에해당하는링크를클릭했습니다。
명령을실행하려면MATLAB명령창에입력하십시오。웹브라우저는MATLAB명령을지원하지않습니다。
你也可以从下面的列表中选择一个网站:
表现最好的网站怎么走吗
选择中国网站(中文或英文)最佳站点的性能。其他MathWorks国家网站不优化的访问你的位置。