imaq.videodevice.
从视频设备一次获取一帧
句法
obj = imaq.videodevice.
obj = imaq.videodevice（AdaptorName）
obj = imaq.videodevice（AdaptorName，DeviceID）
obj = imaq.videodevice（AdaptorName，DeviceID，格式）
obj = imaq.videodevice（AdaptorName，DeviceID，格式，P1，V1，...）
帧=步骤（obj）
[帧元数据] =步骤（obj）
描述
videoDevice系统对象允许单帧图像采集和来自MATLAB的代码生成®。你用了imaq.videodevice.函数创建系统对象。它支持万博1manbetx相同的适配器和硬件videoInput.对象支持;万博1manbetx但是，它具有与其相关的不同功能和属性。例如，系统对象使用步获取单个框架的功能。
obj = imaq.videodevice.创建videodevice系统对象，obj.，从指定的图像采集设备获取图像。当您指定任何参数时，默认情况下，它会选择第一个适配器的第一个可用设备imaqhwinfo.。
obj = imaq.videodevice（AdaptorName）创建videodevice系统对象，obj.，使用指定的第一个设备AdaptorName.。AdaptorName.是一个字符向量，指定用于与设备通信的适配器的名称。使用imaqhwinfo.功能确定系统上可用的适配器。
obj = imaq.videodevice（AdaptorName，DeviceID）创建videodevice系统对象，obj.，指定的默认格式AdaptorName.和设备编号。设备编号是标识通过指定可用的特定设备的数字标量值AdaptorName.。使用Imaqhwinfo（AdductorName）语法确定可用的设备和相应的值设备编号。
obj = imaq.videodevice（AdaptorName，DeviceID，格式）创建videodevice系统对象，obj.， 在哪里格式是一个字符向量，指定设备或设备配置文件支持的特定视频格式（也称为相机文件）。万博1manbetx
obj = imaq.videodevice（AdaptorName，DeviceID，格式，P1，V1，...）创建videodevice系统对象，obj.，具有指定的属性值。如果指定了无效的属性名称或属性值，则不会创建对象。
在对象创建时指定属性是可选的。在创建对象后也可以指定它们。有关适用属性的列表，请参阅下表。
帧=步骤（obj）从videodevice系统对象获取单帧，obj.。
[帧元数据] =步骤（obj）从videodevice系统对象获取单个图像帧，obj.，加上Kinect的元数据®适用于Windows.®深度传感器。您可以使用Kinect深度传感器上的videodevice系统对象返回Kinect for Windows骨架数据。有关如何执行此操作的信息，请参阅Windows元数据的Kinect。
特性
您可以在创建对象时指定属性，或者在创建对象后可以指定和更改它们。可以与videodevice系统对象一起使用的属性包括：
| 财产 | 描述 |
|---|---|
设备 |
从中获取图像的设备。 指定用于获取帧的图像采集设备。它由设备名称，适配器和设备ID组成。默认设备是第一个返回的设备 |
Videoformat |
图像采集设备使用的视频格式。 在获取帧时指定要使用的视频格式。默认值 |
devicefile. |
指定视频格式的文件名。此属性仅显示Videoformat被设定为'从设备文件'。 |
deviceproperties. |
包含特定于图像采集设备的属性的对象。 |
ROI. |
收购的地点。这被设置为指定设备的默认ROI值，这是指定格式的最大分辨率。您可以更改值以更改捕获图像的大小。格式为基于1，即，它在1×4元素矢量中以像素中指定[x y宽度高]。请注意，这与之不同 |
硬刺穿 |
转动硬件触发开/关。将此属性设置为'在'启用硬件触发以获取图像。只有当设备支持硬件触发时，该属性才可见。万博1manbetx |
TriggerConfiguration. |
在采集之前指定触发源和触发条件。在获取帧之前，必须通过触发源满足触发条件。此属性仅在何时可见硬刺穿被设定为'在'。 |
reshcolorspace. |
指定返回的图像的颜色空间。属性的默认值取决于所选设备和所选视频格式。可能的值是{RGB.|灰度|ycbcr.当设备的默认返回颜色空间不是时灰度。可能的值是{RGB.|灰度|ycbcr.|拜耳}当设备的默认返回颜色空间是灰度 |
Bayersensoralign. |
表示2x2传感器对齐的字符矢量。指定由硬件返回的拜耳模式。指定拜耳脱染料的传感器对齐。此属性的默认值是'grbg'。可能的值是{GRBG.|GBRG.|RGGB.|BGGR.}。只有ifreshcolorspace.被设定为'拜耳'。 |
raptdatatype. |
所获取的帧的返回数据类型。默认值raptdatatype.是单身的。 |
ReadAllFrames. |
指定是否读取一个图像帧或所有可用帧。设置'在'捕获所有可用的图像帧。设置为默认值'离开'，系统对象采用一帧的快照，这是相当于的getsnapshot.工具箱中的功能。When the option is on, all available image frames are captured, which is the equivalent of thegetdata.工具箱中的功能。 |
在MATLAB中编码时，系统对象的设置支持选项卡完成以进行枚举属性。万博1manbetx使用选项卡完成是一种简单的方法，可以看到可用的属性值。键入属性名称后，键入逗号，然后键入一个空格，然后是值的第一个报价标记，然后点击选项卡以查看可能的值。
你也可以使用放使用对象名称和属性名称来获取该属性的可用值列表。例如：
SET（OBJ，'reshorcorspace'）
获取videodevice系统对象的可用颜色空间设置列表，obj.。
请注意，一旦完成步骤，才能更改属性或设置新的，您需要使用释放对象释放函数，在设置新属性之前。
笔记
要获取可以在功能上使用的选项列表，请按标签在MATLAB命令行上输入函数后键。列表展开，您可以滚动以选择属性或值。有关使用此高级选项卡完成功能的信息，请参阅使用Tab完成功能。
职能
您可以使用VideoDevice System对象使用这些函数。
| 功能 | 目的 |
|---|---|
步 |
从图像采集设备获取单帧。
框架=步骤（obj）; 从videodevice系统对象获取单帧， 请注意，第一次调用步骤时，它会获取独占使用硬件并开始流数据。 |
释放 |
发布videodevice资源并允许属性值更改。
释放（obj） 发布系统对象的系统资源（如内存，文件处理或硬件连接）， |
锁住了 |
返回一个值，指示videodevice资源是否已锁定。（用释放开锁。）
l = inslocked（obj） 返回逻辑值， |
预览 |
激活实时图像预览窗口。
预览（OBJ） 创建一个视频预览窗口，为videodevice系统对象显示实时视频数据， |
rotectpreview. |
关闭实时图像预览窗口。
关闭预览（OBJ） 关闭VideoDevice System对象的Live预览窗口， |
imaqhwinfo. |
返回有关该对象的信息。
imaqhwinfo（obj） 显示有关videodevice系统对象的信息， |
例子
构造与WinVideo适配器关联的videodevice系统对象，使用设备ID为1。
Vidobj = imaq.videodevice（'winvideo'，1）;
设置对象级属性，例如reshcolorspace.。对象级属性的语法使用对象名称，属性名称和属性值。
vidobj.returnedcolorspace ='grayscale';
设置特定于设备的属性，例如亮度。特定于设备特定属性的语法使用deviceproperties.对象，属性名称和属性值。
Vidobj.DeviceProperties.Brightness = 150;
预览图像。
预览（Vidobj）
获取单一帧。
帧=步骤（Vidobj）;
显示获取的帧。
imshow（框架）
释放硬件资源。
释放（Vidobj）;
清除videodevice系统对象。
清除Vidobj;
扩展能力
您还可以从以下列表中选择一个网站：
