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 свойство.

Можно использовать MATLAB image или 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, смотрите Использование заполнения клавишей Tab для функций.

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

Описание

'numeric'

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

'cell'

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

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

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

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

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

Описание

'AbsTime'

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

'FrameNumber'

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

'RelativeFrame'

Номер, идентифицирующий n-й система координат относительно начала триггера

'TriggerIndex'

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

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

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

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

Примеры

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

obj = videoinput('matrox', 1);

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

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

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

imaqmontage(data);

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

delete(obj);
Представлено до R2006a