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'Время измеряется постоянно относительно 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