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

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

Синтаксис

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

Описание

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

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

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

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

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-битному в целях отображения предварительно просмотренных данных. Если вам нужно полное разрешение данных, используйте функции getdata или getsnapshot.

Пользовательская функция обновления

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

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

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

  • obj — Объект ввода видео предварительно просматривается

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

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

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

Поле

Описание

Data

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

Resolution

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

Status

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

Timestamp

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

Примеры

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

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