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

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

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

imaqhwinfo
ans = 

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

В данных, возвращенных imaqhwinfo, InstalledAdaptors cписки полей адаптеры, которые доступны на вашем компьютере. В этом примере, 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 фреймы изображения имеют три полосы: красный является первым, зеленый является вторым, и синий является третьим. Четвертая размерность представляет количество систем координат, которые были получены от видеопотока.