preview

Предварительный просмотр видео в прямом эфире данных

Синтаксис

preview(obj)
preview(obj,himage)
himage = preview(...)

Описание

preview(obj) создает окно Video Preview, в котором отображаются live video данных для объекта video входа obj. В окне также отображаются временная метка и разрешение видео каждой системы координат, текущая частота систем координат и текущее состояние obj. Окно Video Preview отображает данные видео с 100% -ным увеличением. Размер изображения для предварительного просмотра определяется значением объекта входа видео ROIPosition свойство.

Компоненты окна предварительного просмотра видео

Окно Video Preview остается активным, пока не будет остановлено использование stoppreview или закрыто с использованием closepreview. Если вы удаляете объект, вызывая delete(obj)окно «Предварительный просмотр видео» останавливает предварительный просмотр и автоматически закрывается.

preview(obj,himage) Отображения live video данных для видео входа объекта obj в объекте изображения, заданном указателем himage. preview масштабирует данные изображения, чтобы заполнить всю область объекта изображения, но не изменяет значения каких-либо свойств объекта изображения. Используйте этот синтаксис для предварительного просмотра видео данных в пользовательском графическом интерфейсе пользователя собственного проекта (см. Примеры).

himage = preview(...) возвращает himageуказатель на объект изображения, содержащий данные предварительного просмотра. Чтобы получить указатель на окно рисунка, содержащее объект изображения, используйте ancestor функция. Для получения дополнительной информации об использовании объектов изображений смотрите image. Дополнительные сведения о возвращенном объекте изображения см. в разделе Пользовательская функция обновления.

Примечания

Поведение окна Video Preview зависит от текущего состояния объекта входа видео и строения триггера.

Состояние объекта

Предварительный просмотр поведения окна

Running=off

Отображает интерактивное представление изображения, получаемого с устройства, для всех типов триггеров. Изображение обновляется с учетом изменений, внесенных в строения свойств объекта. (The FrameGrabInterval свойство игнорируется до тех пор, пока не произойдет триггер.)

Running=on

Если TriggerType установлено в immediate или manualОкно «Предварительный просмотр видео» продолжает обновлять отображаемое изображение.

Если TriggerType установлено в hardwareОкно Video Preview останавливает обновление отображаемого изображения до тех пор, пока не произойдет триггер.

Logging=on

Окно Video Preview может удалить некоторые системы координат данных, но это не повлияет на системы координат, записанные в память или диск.

Примечание

Окно Image Acquisition Toolbox™ Preview и окно Preview, встроенное в Image Acquisition Tool, поддерживают отображение до 16-битных данных изображения. Окно Preview было спроектировано, чтобы показать только 8-битные данные, но многие камеры возвращают 10-, 12-, 14- или 16-битные данные. Окно Preview отображения поддерживает эти камеры более высокой битовой глубины. Однако большие битовые данные масштабируются до 8-битовых с целью отображения предварительно просмотренных данных. Чтобы захватить данные изображения в окне Preview на его полной битовой глубине для полутоновых изображений, установите PreviewFullBitDepth свойство к 'on'.

Настраиваемая функция обновления

preview создает прикладные данные для объекта изображения, himage, присвоение ему имени 'UpdatePreviewWindowFcn' и установка его значения как пустой массив ([]). Можно сконфигурировать значение 'UpdatePreviewWindowFcn' данные приложения и извлечь его значение с помощью MATLAB® setappdata и getappdata функций, соответственно.

The 'UpdatePreviewWindowFcn' не обязательно вызываться для каждого полученной системы координат. Если получена новая система координат и 'UpdatePreviewWindowFcn' для предыдущей системы координат еще не закончено выполнение, обновление для новой системы координат не будет сгенерировано. Если вам нужно выполнить функцию для каждого приобретённой системы координат, используйте FramesAcquiredFcn вместо этого.

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

  • obj - Предварительный просмотр объекта входа видео

  • event - структура события, содержащая информацию кадра изображения. Для получения дополнительной информации см. ниже.

  • himage - указатель на объект изображения, который обновляется

Структура события содержит следующие поля:

Область

Описание

Data

Текущая система координат изображения задана как матрица H-на-W-на-B, где H и W являются высотой и шириной изображения, соответственно, как задано в ROIPosition свойство, и B - количество цветовых полос, заданное в NumberOfBands свойство.

Resolution

Вектор символов, задающий текущую ширину и высоту изображения, как задано в ROIPosition свойство.

Status

Вектор символов, описывающий текущий статус приема объекта входа видео.

Timestamp

Вектор символов, задающий временную метку, связанную с текущей системой координат изображения.

FrameRate

Вектор символов, задающий текущую частоту систем координат объекта входа видео в системах координат в секунду.

Примеры

Создайте пользовательский графический интерфейс пользователя.

figure('Name', 'My Custom Preview Window'); 
uicontrol('String', 'Close', 'Callback', 'close(gcf)');  

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

vidRes = obj.VideoResolution; 
nBands = obj.NumberOfBands; 
hImage = image( zeros(vidRes(2), vidRes(1), nBands) ); 
preview(obj, hImage); 

Для получения дополнительной информации о пользовательских графических интерфейсах пользователя смотрите Предварительный просмотр данных в пользовательских графических интерфейсах пользователя.

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