主要内容

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)访问视频源对象,用于收购。

    属性

    全部展开

    一般性质

    拜耳demosaicing传感器校准,指定为“grbg”,“gbrg”,“rggb”,或“bggr”。如果ReturnedColorSpace属性设置为“拜耳”,那么图像采集工具箱™将demosaic拜耳模式返回的硬件。这种颜色空间设置成标准RGB图像篡改拜耳模式编码图像。如果你的相机使用拜耳过滤、工具箱支持拜耳模式和可以返回颜色如果需要。金宝app

    为了执行demosaicing,工具箱需要知道传感器的像素排列。这是订单的红色,绿色和蓝色的传感器,通常是通过描述指定四个像素传感器的左上角。这是乐队灵敏度的一致性解释的像素相机的内部硬件。你必须从相机获取这些信息的文档,然后指定对齐的值,如下表所述。

    有四种可能的传感器校准。

    价值 描述

    “gbrg”

    2×2传感器校准

    绿色蓝色红色绿色

    “grbg”

    2×2传感器校准

    绿红蓝绿

    “bggr”

    2×2传感器校准

    蓝绿绿红

    “rggb”

    2×2传感器校准

    红绿绿蓝

    这个属性的值是只如果使用ReturnedColorSpace属性设置为“拜耳”

    的例子显示如何将拜耳图片,明白了拜耳图像转换

    数据类型:字符|字符串

    这个属性是只读的。

    图像采集设备ID指定的适配器,指定为一个非负整数。这个属性标识设备由视频输入对象。

    设备ID是一个数字,由一个适配器,唯一地标识一个图像采集装置。适配器分配第一设备检测标识符1,第二个设备检测标识符2,等等。

    您可以指定的设备ID作为输入videoinput当您创建一个视频输入对象函数。对象存储中的值的DeviceID财产以及使用价值构建的缺省值的名字财产。

    得到的id列表的设备连接到您的系统,使用imaqhwinfo函数,指定一个特定的适配器的名称作为参数。

    数据类型:

    多长时间的视频输入对象获得一帧视频,指定为一个正整数。默认情况下,对象获取视频的每一帧,但是您可以使用这个属性来指定其他收购的间隔。

    请注意

    不要混淆抓帧间隔帧速率。帧率描述了一个图像采集装置的速度提供了框架,通常以秒,如30帧/秒。抓帧间隔以帧,不是秒。如果一个特定设备的帧率是可配置的,视频源对象可能包括帧速率作为一个特定于设备的属性。

    例如,当您指定一个FrameGrabInterval的价值3,对象获得每三帧的视频,见此图。对象获得第一帧的视频应用FrameGrabInterval

    图说明获得的帧与FrameGrabInterval视频设置为3。

    您指定的视频流的来源SelectedSourceName财产。

    数据类型:

    这个属性是只读的。

    的帧总数对象了,不管有多少帧被从内存缓冲区中提取,指定为一个非负整数。视频输入对象不断更新的值FramesAcquired财产获得帧。

    请注意

    当你发出开始指挥、视频输入对象的值重置FramesAcquired财产0(零)和刷新缓冲区。

    找出有多少帧可用的内存缓冲区,使用FramesAvailable财产。

    数据类型:

    这个属性是只读的。

    帧总数可用内存缓冲区,指定为一个非负整数。在提取数据时,对象减少的价值FramesAvailable属性的适当数量的帧。您使用getdataMATLAB函数来提取数据并移动它到工作区。

    请注意

    当你发出开始指挥、视频输入对象的值重置FramesAvailable财产0(零)和刷新缓冲区。

    查看的帧总数已经收购了自从上次开始命令,可以使用FramesAcquired财产。

    数据类型:

    图像采集对象的名称,指定为一个特征向量或字符串标量。

    工具箱创建默认名称相结合的价值VideoFormat的DeviceID用这种格式的适配器名称属性:VideoFormat+- - - - - -+适配器名称+- - - - - -+的DeviceID

    数据类型:字符|字符串

    这个属性是只读的。

    颜色的数量数据,指定为一个正整数。工具箱中定义乐队第三维度的三维数组,如这个图所示。

    颜色乐队的第三维度是一个三维图像数据的数组。

    的值NumberOfBands属性显示的数量颜色乐队在返回的数据getsnapshot,getdata,peekdata

    数据类型:

    预览窗口中的图像数据是否显示在完整的位深度,指定为“关闭”“上”

    请注意

    图像采集的工具箱预览窗口支持多达16位图像数据的显示。金宝app预览窗口是为了只显示8位数据,但是许多相机返回10 - 12 - 14或16位数据。预览窗口显示支持这些更高的位深度相机。金宝app然而,更大的一些数据是按比例缩小的8位显示预览数据的目的。捕获的图像数据完整的位深度的预览窗口灰度图像、设置PreviewFullBitDepth财产“上”

    如果你设定这个属性“关闭”预览窗口中,图像数据缩小从8位的位深度。如果你设定这个属性“上”,预览窗口中的图像数据被捕获在其完整的位深度。

    这个属性可以设置为“上”只有当的值ReturnedColorspace属性设置为“灰度”和视频格式高于8位深度。

    数据类型:字符|字符串

    这个属性是只读的。

    对象是否正在预览的数据在一个单独的窗口中,指定为“关闭”“上”

    对象集预览财产“上”当你打电话给预览函数。

    对象集预览财产“关闭”当你关闭预览窗口使用closepreview函数或通过单击关闭在预览窗口标题栏的按钮。

    数据类型:字符

    颜色你想要空间工具箱时使用它返回图像数据到MATLAB工作区,指定为“灰度”,“rgb”,“YCbCr”,或“拜耳”。这只是有关当你访问获得的图像数据getsnapshot,getdata,peekdata功能。

    这个属性可以有下列值:

    价值 描述
    “灰度”

    MATLAB的灰度空间。

    “rgb”

    MATLAB RGB颜色空间。

    “YCbCr”

    MATLAB YCbCr颜色空间。

    注意到YCbCr通常是不严密地称为YUV。(YUV是相似的,但又不完全相同。他们相差比例因子应用于结果。YUV指一个特定的比例因子用于复合NTSC和PAL格式。在大多数情况下,您可以指定YCbCr YUV颜色空间设备支持)。金宝app

    “拜耳”

    灰度拜耳颜色模式转换为RGB图像。的拜耳颜色空间的选择只有如果你的相机默认的返回颜色空间灰度

    使用BayerSensorAlignment财产,你必须设置ReturnedColorSpace财产拜耳

    请注意

    等一些适配器,GigE GenTL,如果您使用一个格式,从拜耳(如。BayerGB8_640x480),原始——拜耳模式自动转换颜色ReturnedColorSpace是RGB。如果你设置ReturnedColorSpace“灰度”,你会得到的原始模式。

    为一个例子,演示如何确定默认颜色空间和改变颜色空间设置,明白了指定的颜色空间

    数据类型:字符|字符串

    的收购窗口中,指定为1-by-4元素向量。ROI定义了框架的实际尺寸记录的工具箱,对测量图像的左上角。

    ROIPosition被指定为一个1-by-4元素向量[XOffset YOffset宽度高度)

    XOffset

    ROI的左上角的位置,以像素。

    YOffset

    ROI的左上角的位置,以像素。

    宽度

    ROI的宽度,单位为像素。的总和XOffset宽度不能超过规定的宽度VideoResolution

    高度

    ROI的高度,以像素。的总和YOffset高度不能超过规定的高度VideoResolution

    插图的ROI图像与XOffset YOffset,宽度和高度。

    请注意

    宽度不包括两个端点以及像素之间的宽度。它包括一个终点,加上像素之间的宽度。举个例子,如果你想捕捉一个ROI的像素20到30,包括像素20到30,设置一个XOffset19和一个宽度11。同样的规则也适用于高度

    在上面的图中,捕获的ROI的宽度包含像素51到170年,包括端点,因为XOffset被设置为50宽度被设置为120年

    数据类型:

    这个属性是只读的。

    视频输入对象是否准备获取数据,指定为“关闭”“上”

    随着日志记录财产,运行反映了视频输入对象的状态。的运行属性表明对象准备获得数据,而日志记录属性表明对象是获取数据。

    对象集运行财产“上”当你的问题开始命令。当运行“上”,你可以从一个视频源获取数据。

    对象集运行财产“关闭”当满足下列条件:

    • 获得指定的帧数。

    • 运行时发生错误。

    • 你的问题停止命令。

    运行“关闭”,你不能获得图像数据。然而,您可以获得一个图像帧的getsnapshot函数。

    数据类型:字符

    在秒的时间getdatagetsnapshot函数等待返回数据,指定为一个正整数。的超时财产只是与这些阻塞函数相关联。如果指定的时间到期,MATLAB的函数返回控制命令行。

    超时是阻止收购的条件之一。超时发生时,对象是跑步,MATLAB文件所指定的功能ErrorFcn被称为。

    请注意

    超时财产与硬件无关超时条件。

    数据类型:

    存储数据,你想结交一个图像采集对象,指定为任何MATLAB数据类型。

    请注意

    对象不使用的数据用户数据直接。然而,您可以访问数据通过引用属性将一个字段MATLAB结构使用点符号。

    这个属性是只读的。

    视频格式所使用的图像采集设备或设备的配置文件的名称,这取决于您指定在创建对象时,指定为一个特征向量。

    图像采集设备通常支持多种视频格式。金宝app当您创建一个视频输入对象时,您可以指定您想要的视频格式所使用的设备。如果你不指定视频格式作为参数,videoinput函数使用默认格式。使用imaqhwinfo函数来确定哪些视频格式特定设备支持并找出哪些是默认格式。金宝app

    作为一种替代方法,您可以指定一个设备配置文件的名称,也称为相机文件或数字化仪配置格式(DCF)文件。一些图像采集设备使用这些文件存储设备配置信息。的videoinput函数可以使用这个文件来确定视频格式和其他配置信息。

    使用imaqhwinfo函数来确定你的设备支持设备配置文件。金宝app

    数据类型:字符

    这个属性是只读的。

    宽度和高度的像素帧在传入的视频流,指定为一个双元素向量(宽高)

    请注意

    你创建时指定视频分辨率视频输入对象,通过视频格式的参数videoinput函数。如果你不指定一个视频格式,videoinput函数使用默认的视频格式。使用imaqhwinfo函数来确定哪些视频格式特定设备支持并找出哪些是默认格式。金宝app

    数据类型:

    数据日志记录属性

    这个属性是只读的。

    视频输入对象是目前测井资料,是否指定为“关闭”“上”

    当触发发生时,对象设置日志记录财产“上”和日志数据,内存,磁盘文件,或两者兼而有之,这取决于的价值LoggingMode财产。

    对象集日志记录财产“关闭”当它获得要求的帧数,出现错误,或者你发出停止命令。

    获取数据时,对象但不是日志,运行使用peekdata函数。的peekdata函数不保证所有返回所请求的图像数据。获取所有的数据没有差距,您必须对象记录数据到内存或磁盘文件。

    数据类型:字符

    目的地获取数据,指定为“记忆”,“磁盘”,或“磁盘和内存”。这个属性指定了要视频输入对象存储获取的数据。您可以指定下列值:

    价值

    描述

    “磁盘”

    日志获取数据到磁盘上的一个文件里。

    “磁盘和内存”

    日志获取数据到磁盘文件和内存缓冲区。

    “记忆”

    日志获取数据到内存缓冲区。

    如果您选择“磁盘”“磁盘和内存”AVI文件,您必须指定对象用于访问磁盘文件的价值DiskLogger财产。

    请注意

    日志数据内存时,必须及时提取获得的数据的getdata函数来避免使用系统上所有可用的内存。

    请注意

    peekdata函数不返回任何数据,如果在磁盘日志记录模式下运行。

    数据类型:字符|字符串

    MATLABVideoWriter文件用于记录数据,指定为一个VideoWriter对象。这个属性指定了VideoWriter当文件对象用于记录数据LoggingMode属性设置为“磁盘”“磁盘和内存”

    为了获得最佳的性能,记录到磁盘需要MATLABVideoWriter对象,该对象是一个MATLAB对象,而不是一个图像采集工具箱对象。在您创建和配置VideoWriter对象,您可以指定它DiskLogger财产。

    一个MATLABVideoWriter对象指定了文件名和其他特征。例如,您可以使用VideoWriter属性指定配置文件用于数据压缩和所需的输出质量。完整的信息VideoWriter对象及其属性,看到VideoWriter

    请注意

    不要使用返回的变量VideoWriter函数在执行任何操作VideoWriter文件时被一个视频输入对象数据日志记录。例如,不改变任何VideoWriter文件属性,添加帧或关闭对象。您的更改可以与视频输入对象发生冲突。

    日志记录运行了,可能吗DiskLogger可能仍然是写数据到磁盘。当DiskLogger完成数据写入磁盘,的值DiskLoggerFrameCount属性的值应该等于FramesAcquired财产。不要关闭或修改吗DiskLogger直到满足这个条件。

    关于日志记录图像数据使用的更多信息VideoWriter文件的更多信息,请参考日志记录图像数据到磁盘

    请注意

    peekdata函数不返回任何数据,如果在磁盘日志记录模式下运行。

    这个属性是只读的。

    的帧数写入磁盘,指定为任何非负整数。这个属性表示当前帧写入磁盘的数量DiskLogger。这个值时只更新LoggingMode属性设置为“磁盘”“磁盘和内存”

    日志记录运行了,可能吗DiskLogger可能仍然是写数据到磁盘。当DiskLogger完成数据写入磁盘,的值DiskLoggerFrameCount属性的值应该等于FramesAcquired财产。不要关闭或修改吗DiskLogger直到满足这个条件。

    数据类型:

    事件和回调属性

    这个属性是只读的。

    关于事件的信息,指定为一个结构数组。每一个结构数组中代表一个事件。事件记录在它们发生的顺序。第一个事件日志结构反映了第一个事件记录,第二个事件日志结构反映了第二个事件记录,等等。

    每个事件日志结构包含两个字段:类型数据

    类型字段存储字符数组标识事件类型。图像采集工具定义了许多不同的事件类型,表中列出。请注意,并不是所有的事件类型都记录下来。

    事件类型

    描述

    包括在日志

    错误

    运行时错误发生。运行时错误包括超时和硬件错误。

    是的

    帧收购

    中指定的帧的数量FramesAcquiredFcnCount财产已经被收购了。

    没有

    开始

    对象是通过调用创建的开始函数。

    是的

    停止

    对象停止执行。

    是的

    计时器

    计时器过期了。

    没有

    触发

    触发执行。

    是的

    数据字段存储与特定事件相关的信息。例如,所有事件返回绝对时间的事件发生AbsTime字段。其他相关的字段都包含在数据。有关更多信息,请参见获取事件信息

    事件日志最多可以储存1000事件。如果超过这个值,那么存储最近的1000事件。

    数据类型:结构体

    回调函数执行时一个错误事件发生时,指定为一个特征向量,处理函数,数组或单元。一个运行时错误事件后立即生成运行时发生错误。

    运行时错误包括硬件错误和超时。运行时错误不包括配置错误,例如设置无效的属性值。

    事件信息存储在运行时错误事件日志财产。您可以检索任何错误消息Data.Message领域的事件日志

    请注意

    回调函数,包括ErrorFcn执行,只有当视频对象运行状态。如果你需要使用ErrorFcn回调用于错误处理在预览,预览之前你必须启动视频对象。这样做没有日志数据,使用手动触发。

    数据类型:字符|字符串|细胞|function_handle

    每次回调函数执行预定义的帧数已经收购了,指定为一个特征向量,处理函数,数组或单元。

    帧收购事件后立即生成指定的帧的数量FramesAcquiredFcnCount从选中的视频源获得的财产。这个事件执行指定的MATLAB文件FramesAcquiredFcn

    使用FramesAcquiredFcn回调,如果你必须访问获得的每一帧。如果你没有这个需求,你可能想要使用TimerFcn财产。

    帧获取事件信息不是存储在事件日志财产。

    数据类型:字符|字符串|细胞|function_handle

    从选中的视频源的帧数获取帧生成收购事件之前,指定为一个正整数。

    对象生成一个帧事件后立即获得指定的帧的数量FramesAcquiredFcnCount从选中的视频源获得的。

    数据类型:

    执行回调函数,当一个事件发生时,指定为一个特征向量,处理函数,数组或单元。首先事件发生后立即发出开始命令。

    StartFcn回调执行同步。工具箱不设置对象的运行财产“上”直到回调函数执行完毕。如果遇到错误,回调函数对象从未开始运行。

    事件信息存储在开始事件日志财产。

    数据类型:字符|字符串|细胞|function_handle

    回调函数执行时停止事件发生时,指定为一个特征向量,处理函数,数组或单元。你问题后立即停止事件发生停止命令。

    StopFcn回调执行同步。在大多数情况下,图像采集对象将停下来运行属性将被设置为“关闭”通过MATLAB文件完成的时间执行。

    停止事件信息存储在事件日志财产。

    数据类型:字符|字符串|细胞|function_handle

    回调函数执行当一个计时器事件发生时,指定为一个特征向量,处理函数,数组或单元。一个计时器事件发生在指定的时间段TimerPeriod产权到期。

    工具箱措施时间相对于对象时开始的开始函数。计时器事件停止时生成图像采集对象停止运行。

    请注意

    一些计时器事件可能无法处理你的系统是显著放缓或者TimerPeriod您指定值太小了。

    数据类型:字符|字符串|细胞|function_handle

    以秒为单位的时间,必须通过触发计时器事件之前,指定为一个积极的价值大于0.01。

    工具箱措施时间相对于对象时开始的开始函数。计时器事件停止时生成图像采集对象停止运行。

    请注意

    一些计时器事件可能无法处理你的系统是显著放缓或者TimerPeriod您指定值太小了。

    数据类型:

    回调函数执行触发事件发生时,指定为一个特征向量,处理函数,数组或单元。工具箱生成一个触发事件触发时执行基于配置的TriggerType和数据日志记录开始。

    在大多数情况下,MATLAB文件回调函数是不能保证完整的执行直到工具箱后设置日志记录财产“上”

    信息存储在触发事件事件日志财产。

    数据类型:字符|字符串|细胞|function_handle

    触发属性

    这个属性是只读的。

    视频输入对象使用的触发类型,指定为“立即”,“硬件”,或“手动”。触发启动数据采集。

    您使用triggerconfig函数来为这个属性指定以下值之一。

    TriggerType价值

    描述

    “硬件”你的设备(如果有的话)

    当满足指定条件触发执行。你使用指定条件TriggerCondition财产和您指定的硬件源监测的条件TriggerSource财产。您使用triggerconfig函数来设置这些属性的值。

    “立即”

    你电话后立即触发执行开始函数。

    “手动”

    你电话后立即触发执行触发函数。

    数据类型:字符

    这个属性是只读的。

    必须满足的条件,通过TriggerSource,在触发事件发生时,指定为一个特征向量。触发条件,您可以指定依赖的价值TriggerType财产。

    TriggerType价值

    可用的条件

    “硬件”你的设备(如果有的话)

    特定于设备的。例如,一些Matrox®硬件支持条件等金宝app“risingEdge”“fallingEdge”。使用triggerinfo功能视图的有效值列表与图像采集硬件使用。

    “立即”

    “没有”

    “手动”

    “没有”

    你必须使用triggerconfig函数来设置这个属性的值。

    数据类型:字符

    这个属性是只读的。

    硬件源图像采集对象监视器触发条件,指定为一个特征向量。中指定的条件TriggerCondition对象属性,执行触发器并开始获取数据。

    您使用triggerconfig函数来指定这个值。的值TriggerSource房地产是设备特定的。你指定任何特定设备用来生成触发机制。

    例如,对于Matrox硬件,TriggerSource属性值等“Port0”“端口1”。使用triggerinfo功能视图的列表值是有效的为你的图像采集设备。

    你必须使用triggerconfig函数来设置这个属性的值。

    请注意

    TriggerSource属性时才使用TriggerType属性设置为“硬件”

    数据类型:字符

    视频的帧数输入对象获得每次执行触发器使用选定的视频源,指定为一个正整数。

    当的值FramesPerTrigger属性设置为,对象获取帧直到出现错误或者问题停止命令。

    请注意

    FramesPerTrigger属性设置为,对象忽略的价值TriggerRepeat财产。

    数据类型:

    这个属性是只读的。

    绝对时间的第一个触发器,作为MATLAB时钟返回向量。

    对于所有类型的触发器,InitialTriggerTime记录时日志记录属性设置为“上”

    找到随后触发执行的时候,查看Data.AbsTime场的事件日志属性为特定触发。

    数据类型:

    之前获取帧之后的帧数跳过一个触发器时,指定为一个整数。对象等待触发后的指定数量的帧之前开始日志框架。

    在这个图中,TriggerFrameDelay被设置为5,所以对象让五帧传递开始前获得帧。定义的帧捕获的数量FramesPerTrigger财产。

    图说明跳过的帧与TriggerFrameDelay视频设置为5。

    数据类型:

    你想要额外的次数对象执行触发器,指定为一个非负整数。此表描述了几种典型的行为TriggerRepeat值。

    价值

    行为

    0(默认)

    执行触发一次当触发条件满足。

    任何正整数

    执行触发指定数量的额外的时候触发条件满足。

    每次保持执行触发器触发条件满足,直到停止函数被调用或发生错误。

    确定有多少触发执行,检查的价值TriggersExecuted财产。

    请注意

    如果FramesPerTrigger属性设置为,对象忽略的价值TriggerRepeat财产。

    数据类型:

    这个属性是只读的。

    总数的触发器执行视频输入对象,指定为一个非负整数。

    数据类型:

    视频源对象属性

    这个属性是只读的。

    视频输入对象的父一个视频源对象,指定为一个videoinput对象。

    视频源的父对象被定义为视频输入对象拥有视频源对象。

    这个属性是只读的。

    是否视频源对象将用于收购,指定为“关闭”“上”。你选择一个视频源对象通过指定名称的值输入对象的视频SelectedSourceName财产。视频输入对象所有视频源的属性是一个数组对象与视频输入对象相关联。

    如果选择“上”,视频源对象被选中。如果该值为“关闭”,视频源对象不是选择。

    一个视频源被定义的一个或多个物理数据源的集合被当作一个单一的实体。例如,硬件支持多个RGB的来源,这是由三个物金宝app理连接(红、绿、蓝),被视为一个视频源对象。

    数据类型:字符

    这个属性是只读的。

    一个视频源对象的名称,指定为一个特征向量。

    SourceName是一种视频输入对象中的值的吗SelectedSourceName财产。

    数据类型:字符

    描述性的文本,你想要结交一个图像采集对象,指定为一个特征向量或字符串标量。

    标签属性可以是有用的,当你构建程序,否则需要定义图像采集对象作为一个全局变量,或回调例程之间传递的对象作为参数。

    您可以使用的价值标签属性来搜索特定的图像采集对象在使用imaqfind函数。

    数据类型:字符|字符串

    这个属性是只读的。

    类型的图像采集对象,指定为“videoinput”“videosource”。一个图像采集对象可以是两种类型:

    • 视频输入对象

    • 视频源对象

    数据类型:字符

    采集源属性

    视频源对象的视频名称输入对象获取数据,指定为一个特征向量。默认情况下,视频输入对象选择对象存储在第一个可用的视频源财产。

    工具箱将一个视频源定义为一个或多个硬件投入,被视为一个单一的实体。例如,硬件支持多个RGB的来源,这是由三个物金宝app理连接(红绿蓝),被视为一个视频源对象。

    数据类型:字符|字符串

    这个属性是只读的。

    视频源对象的向量表示物理数据源的连接到一个设备。创建一个视频输入对象时,工具箱创建一个向量与视频相关的视频源对象输入对象。

    提供每个视频源对象创建一个独特的名字来源。您可以使用源名称来选择所需的采集源通过配置SelectedSourceName视频输入对象的属性。

    一个视频源对象存储在它的名字是SourceName财产。如果一个视频源对象的SourceName相当于视频输入对象的SelectedSourceName,视频对象的来源选择属性的值为“上”

    视频源对象支持一组共同的属性,比如金宝appSourceName。每个视频源对象还可以支持特定于设备的属性,物理设备的控制特征如亮度、金宝app色调和饱和度。不同的图像采集设备暴露不同的属性。

    一个视频源被定义的一个或多个物理数据源的集合被当作一个单一的实体。例如,硬件支持多个RGB的来源,这是由三个物金宝app理连接(红绿蓝),被视为一个视频源对象。

    属性封装了一个或多个视频源。引用一个视频源,你使用一个数值的整数索引视频源对象的向量。

    GigE属性

    收购是否继续当遇到掉帧,指定为“关闭”“上”

    如果将此属性设置为“关闭”,收购停止当它遇到了框架。如果将此属性设置为“上”,收购继续忽略掉帧。

    当这个属性“上”跟踪帧的数量下降,而收购的NumDroppedFrames财产。

    请注意

    此属性仅支持金宝appvideoinput对象的使用gige适配器,不支持金宝appgigecam对象。

    数据类型:字符|字符串

    这个属性是只读的。

    的帧数收购运行时如果下降IgnoreDroppedFrames属性设置为“上”,指定为一个非负整数。

    这个属性并不跟踪预览时的帧数下降。

    请注意

    此属性仅支持金宝appvideoinput对象的使用gige适配器,不支持金宝appgigecam对象。

    数据类型:

    对象的功能

    配置

    得到 返回图像采集对象的属性
    配置或显示图像采集对象属性

    执行

    getselectedsource 返回当前选择的视频源对象
    开始 获得独家使用的图像采集设备
    停止 停止视频输入对象
    等待 等到图像采集对象停止运行或日志记录

    触发功能

    触发 启动数据记录
    triggerconfig 配置视频输入对象触发属性
    triggerinfo 提供可用触发配置信息

    数据功能

    flushdata 把数据从内存缓冲区用于存储获取的图像帧
    getdata 获得的图像帧,MATLAB工作空间
    getsnapshot 立即回复单帧图像
    peekdata 最近获得的图像数据

    工具

    closepreview 关闭视频预览窗口
    imaqmontage 序列图像帧的蒙太奇
    预览 实时视频数据的预览

    一般

    删除 去除图像采集对象从内存中
    imaqfind 找到图像采集对象
    imaqreset 断开和删除所有图像采集对象
    isvalid 确定图像采集对象与图像采集设备

    信息和帮助

    imaqhelp 图像采集对象功能和属性的帮助
    imaqhwinfo 图像采集硬件可用的信息
    propinfo 图像采集对象的属性特征

    例子

    全部折叠

    构造一个视频输入对象。

    obj = videoinput (“matrox”1);

    选择源用于收购。

    obj。SelectedSourceName =“input1”

    视图选择视频源对象的属性。

    src_obj = getselectedsource (obj);get (src_obj)

    预览图像帧的流。

    预览(obj);

    获取并显示一个图像帧。

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

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

    删除(obj);

    创建一个视频输入对象访问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。)结束

    你可以验证FramesAcquiredDiskLoggerFrameCount属性完全相同的值通过使用这些命令和输出比较。

    vidobj。FramesAcquired vidobj.DiskLoggerFrameCount

    视频输入对象不再需要时,从工作区中删除它和清晰。

    删除(vidobj)清晰vidobj

    版本历史

    之前介绍过的R2006a