getdata

Полученные фреймы изображения к рабочему пространству MATLAB

Синтаксис

data = getdata(obj)
data = getdata(obj,n)
data = getdata(obj,n,type)
data = getdata(obj,n,type,format)
[data,time] = getdata(...)
[data, time, metadata] = getdata(...)

Описание

data = getdata(obj) возвращает data, который содержит количество кадров, заданных в свойстве FramesPerTrigger объекта obj ввода видео. obj должен быть объектом ввода видео 1 на 1.

data возвращен как H W B F матрицей где

H

Высота изображения, как задано в свойстве ROIPosition объекта

W

Ширина изображения, как задано в свойстве ROIPosition объекта

B

Количество цветных полос, как задано в свойстве NumberOfBands

F

Количество кадров возвращено

data возвращен в рабочую область MATLAB® в своем собственном типе данных, использующем цветовое пространство, заданное свойством ReturnedColorSpace.

Можно использовать image MATLAB или функции imagesc, чтобы просмотреть возвращенные данные. Используйте imaqmontage, чтобы просмотреть несколько кадров целиком.

data = getdata(obj,n) возвращает кадры n данных, сопоставленных с объектом obj ввода видео.

data = getdata(obj,n,type) возвращает кадры n данных, сопоставленных с объектом obj ввода видео, где type является одним из векторов символов в следующей таблице, которые указывают, что тип данных раньше хранил возвращенные данные.

Вектор символа текста

Тип данных

'uint8'

8-битное целое число без знака

'uint16'

16-битное целое число без знака

'uint32'

32-битное целое число без знака

'single'

Одинарная точность

'double'

Двойная точность

'native'

Собственный тип данных использования. Это значение по умолчанию.

Если type не задан, 'native' используется в качестве значения по умолчанию. Если нет никакого типа данных MATLAB, который совпадает с собственным типом данных объекта, getdata выбирает тип данных MATLAB, который сохраняет числовую точность. Например, компоненты 12-битных данных о цвете RGB были бы каждый возвращены как данные uint8.

data = getdata(obj,n,type,format) возвращает кадры n данных, сопоставленных с объектом obj ввода видео, где format является одним из векторов символов в следующей таблице, которые задают формат MATLAB data.

Примечание

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

Вектор символов формата

Описание

'numeric'

Возвращает data как H W B F массивом. Это - формат по умолчанию, если ни один не задан.

'cell'

Возвращает данные как массив ячеек F-1 H W B матрицами

[data,time] = getdata(...) возвращает time, матрицу F-1, где F является количеством кадров, возвращенных в data. Каждый элемент time указывает относительное время, в секундах, соответствующего кадра в data, относительно первого триггера.

time = 0 задан как точка, в которой начинается регистрация данных. Когда регистрация данных начинается, свойство Logging объекта установлено в 'On'. time измеряется постоянно относительно 0, пока приобретение не останавливается. Когда приобретение останавливается, свойство Running объекта установлено в 'Off'.

[data, time, metadata] = getdata(...) возвращает metadata, массив F-1 структур, где F является количеством кадров, возвращенных в data. Каждая структура содержит информацию о соответствующем кадре в data. Структура metadata содержит эти поля:

Поле метаданных

Описание

'AbsTime'

Абсолютное время кадр было получено, выражено как временной вектор

'FrameNumber'

Номер, идентифицирующий энный кадр начиная с команды start, был выпущен

'RelativeFrame'

Номер, идентифицирующий энный кадр относительно запуска триггера

'TriggerIndex'

Количество триггера, в котором был получен этот кадр

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

getdata является блокирующейся функцией, которая возвращает контроль выполнения в рабочее пространство MATLAB после того, как требуемое количество кадров становится доступным в периоде времени, заданном свойством Timeout объекта. Свойство FramesAvailable объекта автоматически уменьшается количеством кадров, возвращенных getdata. Если требуемое количество кадров больше, чем кадры быть полученным, getdata возвращает ошибку.

Возможно выпустить Ctrl+C, в то время как getdata блокируется. Это не останавливает приобретение, но действительно возвращает управление в MATLAB.

Примеры

Создайте объект ввода видео, сопоставленный с устройством Matrox® в ID 1.

obj = videoinput('matrox', 1);

Инициируйте приобретение и получите доступ к записанным данным.

start(obj);
data = getdata(obj);

Отобразите каждый полученный фрейм изображения.

imaqmontage(data);

Удалите объект ввода видео из памяти.

delete(obj);

Смотрите также

| | | |

Представлено до R2006a