imaq.VideoDevice

Получайте по одной системе координат за раз с видеоустройства

Синтаксис

obj = imaq.VideoDevice
obj = imaq.VideoDevice(adaptorname)
obj = imaq.VideoDevice(adaptorname, deviceid)
obj = imaq.VideoDevice(adaptorname, deviceid, format)
obj = imaq.VideoDevice(adaptorname, deviceid, format, P1, V1, ...)
frame = step(obj)
[frame metadata] = step(obj)

Описание

Объект VideoDevice System позволяет собирать изображения в одном кадре и генерировать код из MATLAB®. Вы используете imaq.VideoDevice функция для создания системного объекта. Он поддерживает те же адаптеры и оборудование, что и videoinput поддержки объектов; однако с ним связаны другие функции и свойства. Для примера Системного объекта использует step функция для получения одиночных систем координат.

obj = imaq.VideoDevice создает объект VideoDevice System, obj, который получает изображения от заданного устройства сбора изображений. Когда вы не задаете параметры, по умолчанию он выбирает первое доступное устройство для первого адаптера, возвращенного imaqhwinfo.

obj = imaq.VideoDevice(adaptorname) создает объект VideoDevice System, obj, с использованием первого устройства указанного adaptorname. adaptorname - вектор символов, которая задает имя адаптера, используемого для связи с устройством. Используйте imaqhwinfo функция для определения адаптеров, доступных в вашей системе.

obj = imaq.VideoDevice(adaptorname, deviceid) создает объект VideoDevice System, obj, с форматом по умолчанию для заданных adaptorname и deviceid. deviceid является числовой скаляр значением, которое идентифицирует конкретное устройство, доступное через указанное adaptorname. Используйте imaqhwinfo(adaptorname) синтаксис для определения доступных устройств и соответствующих значений для deviceid.

obj = imaq.VideoDevice(adaptorname, deviceid, format) создает объект VideoDevice System, obj, где format является вектор символов, которая задает конкретный формат видео, поддерживаемый устройством или файлом строения устройства (также известным как файл камеры).

obj = imaq.VideoDevice(adaptorname, deviceid, format, P1, V1, ...) Создает объект VideoDevice System, obj, с заданными значениями свойств. Если задано недопустимое имя свойства или значение свойства, объект не создается.

Установка свойств во время создания объекта опциональна. Они также могут быть заданы после создания объекта. Список применимых свойств см. в таблице ниже.

frame = step(obj) получает одну систему координат от объекта VideoDevice System, obj.

[frame metadata] = step(obj) получает одну систему координат изображения от объекта VideoDevice System, obj, плюс метаданные из Kinect® для Windows® Датчик глубины. Можно вернуть данные скелета Kinect для Windows с помощью объекта VideoDevice System на датчике Глубины Kinect. Дополнительные сведения о том, как это сделать, см. в разделе Kinect для метаданных Windows.

Свойства

Можно задать свойства во время создания объекта, или их можно задать и изменить после создания объекта. Свойства, которые могут использоваться с объектом VideoDevice System, включают:

СвойствоОписание
DeviceУстройство, с которого можно получить изображения.

Укажите устройство сбора изображений, которое будет использоваться для получения системы координат. Он состоит из имени устройства, адаптера и идентификатора устройства. Устройство по умолчанию является первым устройством, возвращаемым imaqhwinfo.

VideoFormatВидеосигнал формата который будет использоваться устройством сбора изображений.

Укажите формат видео, который будет использоваться при приеме системы координат. Значение по умолчанию VideoFormat - формат по умолчанию, возвращаемый imaqhwinfo для выбранного устройства. Чтобы задать формат видео с использованием файла устройства, установите VideoFormat свойство к 'From device file' Эта опция существует, только если ваше устройство поддерживает файлы строения устройства.

DeviceFileИмя файла, задающего формат видео. Это свойство видим только тогда, когда VideoFormat установлено в 'From device file'.
DevicePropertiesОбъект, содержащий свойства, характерные для устройства сбора изображений.
ROIНеобходимая область для приобретения. Для указанного устройства задано значение информация только для чтения по умолчанию, которое является максимально возможным разрешением для заданного формата. Можно изменить значение, чтобы изменить размер захваченного изображения. Формат основан на 1, то есть задан в пикселях в векторе элемента 1 на 4 [x y width height].

Обратите внимание, что это отличается от videoinput объект, Image Acquisition Tool и блок From Video Device, все из которых основаны на 0.

HardwareTriggeringВключите/отключите аппаратное обеспечение. Установите это свойство на 'on' чтобы включить запуск оборудования для получения изображений. Свойство видим только, когда устройство поддерживает оборудование запуск.
TriggerConfigurationЗадает источник триггера и условие триггера перед поступлением. Условие запуска должно быть выполнено через источник триггера перед получением системы координат. Это свойство видим только тогда, когда HardwareTriggering установлено в 'on'.
ReturnedColorSpaceЗадайте цветовое пространство возвращаемого изображения. Значение по умолчанию свойства зависит от устройства и выбранного формата видео. Возможные значения: {rgb| grayscale| YCbCr} когда возвращенное по умолчанию цветовое пространство для устройства не grayscale. Возможные значения: {rgb| grayscale| YCbCr| bayer} когда возвращенное по умолчанию цветовое пространство для устройства grayscale
BayerSensorAlignmentВектор символов, указывающий выравнивание датчика 2x2. Задает шаблоны Bayer, возвращаемые оборудованием. Задайте выравнивание датчика для демозащищения Байера. Значение по умолчанию этого свойства 'grbg'. Возможные значения: {grbg| gbrg| rggb| bggr}. Видим только, если ReturnedColorSpace установлено в 'bayer'.
ReturnedDataTypeВозвращенный тип данных полученной системы координат. Значение по умолчанию ReturnedDataType является single.
ReadAllFramesУкажите, считать ли одну систему координат изображения или все доступные системы координат. Установите значение 'on' для захвата всех доступных систем координат изображений. Когда установлено значение по умолчанию 'off'системный объект делает моментальный снимок одной системы координат, который является эквивалентным getsnapshot функция в тулбоксе. Когда опция включена, захватываются все доступные системы координат изображения, что эквивалентно getdata функция в тулбоксе.

Установка свойств для системного объекта поддерживает заполнение клавишей Tab для перечисленных свойств во время кодирования в MATLAB. Использование заполнения клавишей Tab является простым способом увидеть доступные значения свойств. После ввода имени свойства введите запятую, затем пространство, затем первую кавычку для значения, а затем нажмите вкладка, чтобы увидеть возможные значения.

Можно также использовать set функция с именем объекта и именем свойства, чтобы получить список доступных значений для этого свойства. Для примера:

set(obj, 'ReturnedColorSpace')

получает список доступных настроек цветового пространства для объекта VideoDevice System, obj.

Обратите внимание, что после того, как вы сделали шаг, в порядок изменить свойство или задать новое, необходимо освободить объект с помощью release function, перед установкой нового свойства.

Примечание

Чтобы получить список опций, которые можно использовать для функции, нажмите клавишу Tab после ввода функции в командной строке MATLAB. Список расширяется, и можно прокрутить, чтобы выбрать свойство или значение. Для получения информации об использовании этой расширенной функции заполнения клавишей Tab, смотрите Использование заполнения клавишей Tab для функций.

Функции

Можно использовать эти функции с объектом VideoDevice System.

ФункцияЦель
  
stepПолучите одну систему координат от устройства сбора изображений.

frame = step(obj);

получает одну систему координат от объекта VideoDevice System, obj.

Обратите внимание, что при первом вызове шага оно приобретает эксклюзивное использование оборудования и начнет потоковую передачу данных.

releaseОтпустите ресурсы VideoDevice и допустите изменение значения свойства.

release(obj)

освобождает системные ресурсы (такие как память, указатели на файлы или аппаратные подключения) системного объекта, obj, и позволяет изменять все его свойства и входные характеристики.

isLockedВозвращает значение, указывающее, заблокирован ли ресурс VideoDevice. (Использование release чтобы разблокировать.)

L = isLocked(obj)

возвращает логическое значение, L, что указывает, заблокированы ли свойства для системного объекта, obj. объект выполняет внутреннюю инициализацию при первом step выполняется функция. Эта инициализация блокирует свойства и входные спецификации. Когда это происходит, isLocked функция возвращает значение true.

previewАктивируйте окно предварительного просмотра изображения.

preview(obj)

создает окно Video Preview, которое отображает live video данных для Системного объекта VideoDevice, obj. Окно Video Preview отображает данные видео с 100% -ным увеличением. Размер изображения для предварительного просмотра определяется значением объекта VideoDevice System ROI свойство. Если не указано, для устройства используется разрешение по умолчанию.

closepreviewЗакройте окно предварительного просмотра изображения.

closepreview(obj)

закрывает окно предварительного просмотра для объекта VideoDevice System, obj.

imaqhwinfoВозвращает информацию об объекте.

imaqhwinfo(obj)

отображает информацию об объекте VideoDevice System, obj.

Примеры

Создайте объект VideoDevice System, сопоставленный с адаптером Winvideo с идентификатором устройства 1.

vidobj = imaq.VideoDevice('winvideo', 1);

Установите свойство уровня объекта, такое как ReturnedColorSpace. Синтаксис свойства уровня объекта использует имя объекта, имя свойства и значение свойства.

vidobj.ReturnedColorSpace = 'grayscale';

Установите свойство конкретного устройства, например Brightness. Синтаксис свойства конкретного устройства использует DeviceProperties объект, имя свойства и значение свойства.

vidobj.DeviceProperties.Brightness = 150;

Предварительный просмотр изображения.

preview(vidobj)

Получите одну систему координат.

frame = step(vidobj);

Отобразите полученную систему координат.

imshow(frame)

Отпустите аппаратный ресурс.

release(vidobj);

Очистить объект VideoDevice System.

clear vidobj;

Расширенные возможности

.
Введенный в R2012a