主要内容

配置图像采集对象属性

关于图像采集对象属性

视频输入对象和视频源对象都支持使您能够控制视频图像的特征及其获取方式的属性。金宝app

视频输入对象属性控制对所有图像采集设备都通用的采集方面。例如,你可以使用FramesPerTrigger属性指定要获取的数据量。

视频源对象属性控制与特定源相关联的获取方面。视频源对象支持的属性集随设备的不同而不同。金宝app例如,一些图像采集设备支持使您能够控制所生成图像的质量的属性,例如金宝app亮度色调,饱和

对于任何类型的对象,您都可以使用相同的工具箱函数

  • 查看对象支持的所有属性及其当前值的列表金宝app

  • 查看特定属性的值

  • 获取关于属性的信息

  • 设置属性的值

请注意

三个视频输入对象的触发属性要求使用特殊的配置功能。有关更多信息,请参见设置触发属性

查看对象属性值

要查看图像采集对象的所有属性及其当前值,请使用得到函数。你也可以用the检查函数来查看属性检查器窗口中的对象属性列表,您还可以在其中编辑它们的值。

本示例使用得到函数显示视频输入对象的所有属性列表从视频查看视频源对象属性描述如何对视频源对象执行此操作。

如果不指定返回值,则得到函数将对象属性分为四类:常规设置、回调函数设置、触发器设置和采集源。

get (vid)一般设置:的DeviceID = 1 DiskLogger = [] DiskLoggerFrameCount = 0事件日志= [1 x0 struct] FrameGrabInterval = 1 FramesAcquired = 0 FramesAvailable = 0 FramesPerTrigger = 10日志=从LoggingMode =内存Name = M_RS170-matrox-1 NumberOfBands预览= 1 =从ReturnedColorSpace =灰度ROIPosition =[0 0 640 480] =关闭标签=运行超时= 10Type = videoinput UserData = [] VideoFormat = M_RS170 VideoResolution = [640 480] Callback Function Settings: ErrorFcn = @imaqcallback FramesAcquiredFcn = [] FramesAcquiredFcnCount = 0 StartFcn = [] StopFcn = [] TimerFcn = [] TimerPeriod = 1 TriggerFcn = [] Trigger Settings:InitialTriggerTime = [0 0 0 0 0 0] TriggerCondition = none TriggerFrameDelay = 0 TriggerRepeat = 0 TriggersExecuted = 0 TriggerSource = none TriggerType = immediate Acquisition Sources: SelectedSourceName = CH0 Source = [1x8 videosource]

查看视频源对象属性

要查看与视频输入对象关联的视频源对象(或对象)金宝app支持的属性,请使用getselectedsource函数检索当前选择的视频源对象。这个例子列出了与视频输入对象相关联的视频源对象所支持的属性金宝app从视频.注意其中包含的特定于设备的属性。

请注意

设备的视频源对象可能不包含设备特定的属性。例如,使用“winvideo”适配器,如网络摄像头,使用视频为Windows®(VFW)驱动程序,可能没有为工具箱提供一种方法以编程方式查询设备属性。请使用厂商提供的配置工具进行配置。

get(getselectedsource(vid)) General Settings: Parent = [1x1 videoinput] Selected = on SourceName = CH0 Tag = Type = videosource Device Specific Properties: InputFilter = lowpass UserOutputBit3 = off UserOutputBit4 = off XScaleFactor = 1 YScaleFactor = 1 . get(getselectedsource(vid)) General Settings: Parent = [1x1 videoinput] Selected = on SourceName = CH0

查看特定属性的值

要查看图像采集对象的特定属性的值,可以像在MATLAB中访问字段一样访问该属性的值®结构。

这个例子演示了如何通过引用对象来访问属性,就像它是使用点表示法的MATLAB结构一样。

从视频。预览ans =关闭

获取关于对象属性的信息

要获取关于特定属性的信息,请参见图像采集工具箱属性.属性还可以在命令行获取有关特定属性的信息propinfoimaqhelp功能。

propinfo函数返回一个结构,该结构包含有关属性的信息,例如它的数据类型、默认值和所有可能值的列表(如果属性支持这样的列表)。金宝app这个示例使用propinfo来获取关于LoggingMode财产。

proinfo (vid,' logingmode ') ans = Type: 'character vector' Constraint: 'enum' ConstraintValue: {'memory' 'disk' 'disk&memory'} DefaultValue: 'memory' ReadOnly: ' whilrunning ' DeviceSpecific: 0

imaqhelp函数返回具有完整描述的属性的引用信息。这个示例使用imaqhelp来获取关于LoggingMode财产。

imaqhelp(请看“LoggingMode”)

设置对象属性的值

要设置图像采集对象的特定属性的值,可以像在MATLAB结构中使用点表示法一样给属性赋值。

请注意

因为有些属性是只读的,所以只能设置所有视频输入和视频源属性的子集。

这个例子通过将属性的值赋给对象来设置属性的值,就像它是一个MATLAB结构一样。

从视频。LoggingMode =“磁盘”;%验证属性设置。从视频。logingmode ans =磁盘

查看所有可设置对象属性的列表

若要查看可设置的视频输入对象或视频源对象的所有属性列表,请使用函数。

集(vid)

设置触发属性

某些触发器属性的值,TriggerTypeTriggerCondition,TriggerSource,都是相互关联的。例如,一些TriggerCondition属性的特定值才有效TriggerType财产。

要确保只指定这些属性值的有效组合,必须使用两个函数:

  • triggerinfo函数返回指定视频输入对象的所有有效值组合。

  • triggerconfig函数设置这些属性的值。

有关更多信息,请参见指定触发类型、触发源和触发条件

请注意

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