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

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

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

imaqhwinfo
ans = 

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

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

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

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

info = imaqhwinfo('dcam')
info = 

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

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

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

Чтобы получить список видео форматов, поддерживаемых устройством, смотрите SupportedFormats поле в информационной структуре устройства. The 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)

The 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 функция. The getselectedsource функция возвращает текущий активный источник видео. Чтобы перечислить свойства текущего выбранного объекта источника видео, связанного с объектом входа видео, созданным на шаге 3, введите этот код в подсказке MATLAB.

get(getselectedsource(vid))

The 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. Чтобы обнаружить движение, пример вычитает одну систему координат из другого, создавая различное изображение, а затем отображает его. Пиксели, которые изменили значения в полученных системах координат, будут иметь ненулевые значения в различном изображении.

The 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 системы координат изображений имеют три полосы: красный - первый, зеленый - второй, а синий - третий. Четвертая размерность представляет количество систем координат, которые были получены из видеопотока.