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

Определение имени адаптера

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

imaqhwinfo
ans = 

    InstalledAdaptors: {'dcam'  'winvideo'}
        MATLABVersion: '7.4 (R2007a)'
          ToolboxName: 'Image Acquisition Toolbox'
       ToolboxVersion: '2.1 (R2007a)'

В данных, возвращенных imaqhwinfo, cписки полей InstalledAdaptors адаптеры, которые доступны на вашем компьютере. В этом примере imaqhwinfo нашел два адаптера доступными на компьютере: 'dcam' и 'winvideo'. Листинг на вашем компьютере может содержать только одно имя адаптера. Выберите имя адаптера, которое обеспечивает доступ к вашему устройству получения изображений. Для получения дополнительной информации смотрите Определение Имени Адаптера устройства.

Определение ID устройства

Чтобы найти ID устройства конкретного устройства получения изображений, введите функцию imaqhwinfo в посдказке MATLAB, задав имя адаптера в качестве единственного аргумента. (Вы нашли имя адаптера в первом вызове imaqhwinfo, описанного в Определении Имени Адаптера.) В возвращенных данных поле DeviceIDs является массивом ячеек, содержащим идентификаторы устройства всех устройств, доступных через заданный адаптер.

info = imaqhwinfo('dcam')
info = 

       AdaptorDllName: [1x77 char]
    AdaptorDllVersion: '2.1 (R2007a)'
          AdaptorName: 'dcam'
            DeviceIDs: {[1]}
           DeviceInfo: [1x1 struct]

Определение поддерживаемых форматов видео

Чтобы определить, который поддерживают форматы видео устройство получения изображений, посмотрите в поле DeviceInfo данных, возвращенных imaqhwinfo. Поле DeviceInfo является массивом структур, где каждая структура предоставляет информацию о конкретном устройстве. Чтобы просмотреть информацию об устройстве для конкретного устройства, можно использовать ID устройства в качестве ссылки в массив структур. Также можно просмотреть информацию для конкретного устройства путем вызывания функции imaqhwinfo, определения имени адаптера и ID устройства в качестве аргументов.

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

dev_info = imaqhwinfo('dcam',1)

dev_info = 

          DefaultFormat: 'F7_Y8_1024x768'
    DeviceFileSupported: 0
             DeviceName: 'XCD-X700  1.05'
               DeviceID: 1
  VideoInputConstructor: 'videoinput('dcam', 1)'
 VideoDeviceConstructor: 'imaq.VideoDevice('dcam', 1)'
       SupportedFormats: {'F7_Y8_1024x768'  'Y8_1024x768'}

Просмотр сводных данных объекта ввода видео

Чтобы просмотреть сводные данные ввода видео возражают, что вы только создали, введите имя переменной vid в подсказке команды MATLAB. Итоговая отображенная информация показывает многие характеристики объекта, такие как количество кадров, которые будут получены с каждым триггером, триггерным типом и текущим состоянием объекта. Можно использовать свойства объектов ввода видео, чтобы управлять многими из этих характеристик. Смотрите Шаг 5: Сконфигурируйте Свойства объектов (Необязательно) для получения дополнительной информации.

vid

Summary of Video Input Object Using 'XCD-X700  1.05'.

    Acquisition Source(s):  input1 is available. 

   Acquisition Parameters:  'input1' is the current selected source.
                            10 frames per trigger using the selected source.
                            'Y8_1024x768' video data to be logged upon START. 
                            Grabbing first of every 1 frame(s). 
                            Log data to 'memory' on trigger.

Trigger Parameters:  1 'immediate' trigger(s) on START.
            Status:  Waiting for START. 
                     0 frames acquired since starting.
                     0 frames available for GETDATA.

Типы объектов получения изображений

Тулбокс использует два типа объектов представлять связь с устройством получения изображений:

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

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

Просмотр свойств объектов

Чтобы просмотреть полный список всех свойств, поддержанных объектом ввода видео или объектом источника видеосигнала, используйте функцию get. Чтобы перечислить свойства объекта ввода видео, созданного на шаге 3, введите этот код в посдказке MATLAB.

get(vid)

Функция get перечисляет все свойства объекта с их текущими значениями.

General Settings:
    DeviceID = 1
    DiskLogger = []
    DiskLoggerFrameCount = 0
    EventLog = [1x0 struct]
    FrameGrabInterval = 1
    FramesAcquired = 0
    FramesAvailable = 0
    FramesPerTrigger = 10
    Logging = off
    LoggingMode = memory
    Name = Y8_1024x768-dcam-1
    NumberOfBands = 1
    Previewing = on
    ReturnedColorSpace = grayscale
    ROIPosition = [0 0 1024 768]
    Running = off
    Tag = 
    Timeout = 10
    Type = videoinput
    UserData = []
    VideoFormat = Y8_1024x768
    VideoResolution = [1024 768]
    .
    .
    .

Чтобы просмотреть свойства в настоящее время выбранного объекта источника видеосигнала, сопоставленного с этим объектом ввода видео, используйте функцию getselectedsource в сочетании с функцией get. Функция getselectedsource возвращает в настоящее время активный источник видеосигнала. Чтобы перечислить свойства в настоящее время выбранного объекта источника видеосигнала, сопоставленного с объектом ввода видео, созданным на шаге 3, введите этот код в посдказке MATLAB.

get(getselectedsource(vid))

Функция get перечисляет все свойства объекта с их текущими значениями.

General Settings:
    Parent = [1x1 videoinput]
    Selected = on
    SourceName = input1
    Tag = 
    Type = videosource

  Device Specific Properties:
    FrameRate = 15
    Gain = 2048
    Shutter = 2715

Установка свойств объектов

Чтобы установить значение свойства объекта ввода видео или свойства объекта источника видеосигнала, вы ссылаетесь на свойство объекта, когда вы были бы поле в структуре, с помощью записи через точку.

Некоторые свойства только для чтения; вы не можете установить их значения. Эти свойства обычно предоставляют информацию о состоянии объекта. Другие свойства становятся только для чтения, когда объект запускается. Чтобы просмотреть список всех свойств, можно установить, использовать функцию set, задав объект в качестве единственного аргумента.

Чтобы реализовать приобретение непрерывного изображения, пример устанавливает свойство TriggerRepeat на Inf. Чтобы установить это свойство, введите этот код в посдказке MATLAB.

vid.TriggerRepeat = Inf;

Чтобы помочь приложению не отставать от входящего видеопотока при обработке данных, пример устанавливает свойство FrameGrabInterval на 5. Это указывает, что объект получает каждый пятый кадр в видеопотоке. (Вы можете должны быть экспериментировать со значением свойства FrameGrabInterval найти значение, которое предоставляет лучшему ответу вашу настройку получения изображений.) Этот пример показывает, как можно установить значение свойства объекта путем ссылки на свойство, когда вы сослались бы на поле в структуре MATLAB.

vid.FrameGrabInterval = 5; 

Чтобы установить значение свойства объекта источника видеосигнала, необходимо сначала использовать функцию getselectedsource, чтобы получить объект. (Можно также получить выбранный источник путем поиска свойства объекта Source ввода видео объект источника видеосигнала, который имеет набор свойств Selected к 'on'.)

Чтобы проиллюстрировать, пример присваивает значение свойству Tag.

vid_src = getselectedsource(vid);

vid_src.Tag = 'motion detection setup';

Выполнение примера

Чтобы запустить пример, введите следующий код в посдказке MATLAB. Циклы в качестве примера до конкретного количества кадров были получены. В каждой итерации цикла пример вызывает getdata, чтобы принести два новых кадра в рабочее пространство MATLAB. Чтобы обнаружить движение, пример вычитает один кадр из другого, создавая изображение различия, и затем отображает его. Пиксели, которые изменили значения в полученных кадрах, будут иметь ненулевые значения в изображении различия.

Функция getdata удаляет кадры из буфера памяти, когда это приносит им в рабочее пространство MATLAB. Важно переместить кадры от буфера памяти в рабочее пространство MATLAB своевременно. Если вы не перемещаете полученные кадры из памяти, можно быстро исчерпать всю память, доступную в системе.

% Create video input object. 
vid = videoinput('dcam',1,'Y8_1024x768')

% Set video input object properties for this application.
vid.TriggerRepeat = 100;
vid.FrameGrabInterval = 5;

% Set value of a video source object property.
vid_src = getselectedsource(vid);
vid_src.Tag = 'motion detection setup';

% Create a figure window.
figure; 

% Start acquiring frames.
start(vid)

% Calculate difference image and display it.
while(vid.FramesAvailable >= 2)
    data = getdata(vid,2); 
    diff_im = imabsdiff(data(:,:,:,1),data(:,:,:,2));
    imshow(diff_im);
    drawnow     % update figure window
end

stop(vid)

Обратите внимание на то, что drawnow используется после вызова imshow в порядке гарантировать, что окно рисунка обновляется. Это - хорошая практика при обновлении графический интерфейса пользователя или фигуры в цикле.

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

Данные изображения в рабочем пространстве MATLAB

В примере функция getdata возвращает фреймы изображения в переменной data как 480 640 1 10 массивами 8-битных данных (uint8).

whos 
  Name           Size                   Bytes  Class

  data           4-D                  3072000  uint8 array
  dev_info       1x1                     1601  struct array
  info           1x1                     2467  struct array
  vid            1x1                     1138  videoinput object
  vid_src        1x1                      726  videosource object

Высота и ширина массива, в основном, определяются разрешением видео формата видео. Однако можно использовать свойство ROIPosition задать значения, которые заменяют разрешение видео. Устройства обычно специальное разрешение видео как столбец строкой; MATLAB выражает матричные размерности как строку столбцом.

Третья размерность представляет количество цветных полос в изображении. Поскольку данные в качестве примера являются полутоновым изображением, третья размерность равняется 1. Для форматов RGB фреймы изображения имеют три полосы: красный является первым, зеленый является вторым, и синий является третьим. Четвертая размерность представляет количество кадров, которые были получены от видеопотока.