Документация

Введение

После того, как вы соединяете MATLAB^® к устройству получения изображений можно просмотреть живой видеопоток с помощью Окна просмотра видео. Предварительный просмотр видеоданных может помочь вам убедиться, что получаемое изображение является удовлетворительным.

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

Следующие разделы предоставляют больше информации об использовании Окна просмотра видео.

Вместо того, чтобы использовать Окно просмотра видео тулбокса, можно отобразить живой поток предварительного просмотра видео в любой Дескриптивной графике^® объект изображения вы задаете. Таким образом можно включать предварительный просмотр видео в графический интерфейс пользователя собственного создания. Следующие разделы описывают эту возможность.

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

Чтобы открыть Окно просмотра видео, используйте preview функция. Окно просмотра видео отображает живой видеопоток от устройства. Можно только открыть одно окно предварительного просмотра для каждого устройства. Если несколько устройств используются, можно открыть несколько окон предварительного просмотра одновременно.

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

vid = videoinput('winvideo');
preview(vid);

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

В дополнение к изображению предварительного просмотра Окно просмотра видео включает информацию об изображении, таком как метка времени видеокадра, разрешения видео, частоты кадров и текущего статуса объекта ввода видео.

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

Когда вы используете preview функционируйте, чтобы начать предварительно просматривать данные изображения, Окно просмотра видео отображает представление живого видеопотока, прибывающего из устройства. Чтобы остановить обновление живого видеопотока, вызовите stoppreview функция.

Этот пример создает объект ввода видео и открывает Окно просмотра видео. Пример затем вызывает stoppreview функция на этом объекте ввода видео. Окно просмотра видео прекращает обновлять отображенное изображение и прекращает обновлять метку времени. Состояние, отображенное в Окне просмотра видео также, изменяется, чтобы указать, что предварительный просмотр был остановлен.

vid = videoinput('winvideo');
preview(vid)
stoppreview(vid)

Чтобы перезапустить видеопоток в Окне просмотра видео, вызовите preview снова на том же объекте ввода видео.

preview(vid)

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

Чтобы закрыть конкретное Окно просмотра видео, используйте closepreview функция, задавая ввод видео возражает в качестве аргумента. Вы не должны останавливать живой видеопоток, отображенный в Окне просмотра видео прежде, чем закрыть его.

closepreview(vid)

Чтобы закрыть все в настоящее время открытые Окна просмотра видео, используйте closepreview функция без любых аргументов.

closepreview

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

Вместо того, чтобы использовать Окно просмотра видео тулбокса, можно использовать preview функционируйте, чтобы направить живой видеопоток к любому объекту изображения Дескриптивной графики. Таким образом можно включить возможность предварительного просмотра тулбокса в графический интерфейс пользователя собственного создания. (Можно также выполнить пользовательскую обработку, когда живое видео отображено. Для получения информации смотрите Выполняющую Пользовательскую Обработку Предварительно просмотренных Данных.)

Чтобы использовать эту возможность, создайте объект изображения и затем вызовите preview функция, задавая указатель на объект изображения в качестве аргумента. preview функционируйте выводит живой видеопоток к объекту изображения, который вы задаете.

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

% Create a video input object.
vid = videoinput('winvideo');

% Create a figure window. This example turns off the default
% toolbar, menubar, and figure numbering.

figure('Toolbar','none',...
       'Menubar', 'none',...
       'NumberTitle','Off',...
       'Name','My Preview Window');

% Create the image object in which you want to display 
% the video preview data. Make the size of the image
% object match the dimensions of the video frames.

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

% Display the video data in your GUI.

preview(vid, hImage);

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

Выполнение пользовательской обработки предварительно просмотренных данных

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

Чтобы использовать эту возможность, выполните эти шаги:

function mypreview_fcn(obj,event,himage)
% Example update preview window function.

% Get timestamp for frame.
tstampstr = event.Timestamp;

% Get handle to text label uicontrol.
ht = getappdata(himage,'HandleToTimestampLabel');

% Set the value of the text label.
ht.String = tstampstr;

% Display image data.
himage.CData = event.Data

% Create a video input object.
vid = videoinput('winvideo');

% Create a figure window. This example turns off the default
% toolbar and menubar in the figure.
hFig = figure('Toolbar','none',...
       'Menubar', 'none',...
       'NumberTitle','Off',...
       'Name','My Custom Preview GUI');

% Set up the push buttons
uicontrol('String', 'Start Preview',...
    'Callback', 'preview(vid)',...
    'Units','normalized',...
    'Position',[0 0 0.15 .07]);
uicontrol('String', 'Stop Preview',...
    'Callback', 'stoppreview(vid)',...
    'Units','normalized',...
    'Position',[.17 0 .15 .07]);
uicontrol('String', 'Close',...
    'Callback', 'close(gcf)',...
    'Units','normalized',...
    'Position',[0.34 0 .15 .07]);

% Create the text label for the timestamp
hTextLabel = uicontrol('style','text','String','Timestamp', ...
    'Units','normalized',...
    'Position',[0.85 -.04 .15 .08]);

% Create the image object in which you want to
% display the video preview data.
vidRes = vid.VideoResolution;
imWidth = vidRes(1);
imHeight = vidRes(2);
nBands = vid.NumberOfBands;
hImage = image( zeros(imHeight, imWidth, nBands) );

% Specify the size of the axes that contains the image object
% so that it displays the image at the right resolution and
% centers it in the figure window.
figSize = get(hFig,'Position');
figWidth = figSize(3);
figHeight = figSize(4);
gca.unit = 'pixels';
gca.position = [ ((figWidth - imWidth)/2)... 
               ((figHeight - imHeight)/2)...
               imWidth imHeight ];

% Set up the update preview window function.
setappdata(hImage,'UpdatePreviewWindowFcn',@mypreview_fcn);

% Make handle to text label available to update function.
setappdata(hImage,'HandleToTimestampLabel',hTextLabel);

preview(vid, hImage);