preview

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

Синтаксис

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

Описание

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

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

Окно просмотра видео остается активным, пока оно или не останавливается с помощью stoppreview или закрытое использование closepreview. Если вы удаляете объект путем вызова delete(obj), Окно просмотра видео прекращает предварительно просматривать и завершения автоматически.

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

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

Примечания

Поведение Окна просмотра видео зависит от текущего состояния объекта ввода видео и триггерной настройки.

Объектное состояние

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

Running=off

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

Running=on

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

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

Logging=on

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

Примечание

Окно 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 функции, соответственно.

'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