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

Типы объектов

После получения информации об оборудовании для сбора изображений, описанной в Getting Hardware Information, можно установить подключение к устройству, создав объект для сбора изображений. Тулбокс использует два типа объектов сбора изображений:

Входы видео

Объект входа видео представляет соединение между MATLAB^® и устройство сбора видео на высоком уровне. Вы должны создать объект входа видео с помощью videoinput функция. Дополнительные сведения см. в разделе Создание объекта входе видео.

Исходные объекты видео

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

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

Следующий рисунок иллюстрирует, как объект входа видео действует как контейнер для одного или нескольких объектов источника видео.

Для примера, матрица^® Устройство захвата кадров может поддерживать восемь физических соединений, которые Matrox вызывает каналами. Эти каналы могут быть сконфигурированы различными способами, в зависимости от формата видео. Если вы задаете монохромный формат видео, такой как RS170, тулбокс создает восемь объектов-источников видео, по одному объекту для каждого из восьми каналов на устройстве. Если вы задаете формат цветного видео, такой как NTSC RGB, устройство Matrox использует три физических канала, чтобы представлять одно соединение RGB, где каждое физическое соединение обеспечивает красные данные, зеленые данные и синие данные отдельно. В этом формате тулбокс создает только два объектов видео для одного и того же устройства.

Создание объекта входа видео

Чтобы создать объект входа видео, вызовите videoinput функция, задающая имя адаптера, идентификатор устройства и формат видео. Вы получили эту информацию с помощью imaqhwinfo функция (описанная в разделе «Получение аппаратной информации»). Единственным необходимым аргументом является имя адаптера. Тулбокс может использовать значения по умолчанию для идентификатора устройства и формата видео.

Этот пример создает объект входа видео, чтобы представлять соединение с устройством сбора изображений Matrox. The imaqhwinfo функция включает в себя videoinput по умолчанию синтаксис в VideoInputConstructor поле информационной структуры устройства.

vid = videoinput('matrox');

Этот синтаксис использует формат видео по умолчанию, указанный в DefaultFormat поле данных, возвращаемых imaqhwinfo. Вы можете опционально задать формат видео. Дополнительные сведения см. в разделе «Определение формата видео».

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

Вы можете опционально задать формат видеопотока, когда вы создаете объект входа видео в качестве третьего аргумента к videoinput функция. Этот аргумент может иметь две формы:

В следующих разделах описаны эти опции. Если вы не задаете формат видео, videoinput функция использует один из поддерживаемых устройством форматов видео. Для матрицы и преобразования данных^® устройства, он выбирает RS170 формат видео. Для Windows^® устройства используют первый формат RGB в списке поддерживаемых форматов или, если не поддерживаются форматы RGB, формат по умолчанию устройства.

info = imaqhwinfo('matrox');

info.DeviceInfo.SupportedFormats

ans = 
  Columns 1 through 4

    'M_RS170'    'M_RS170_VIA_RGB'    'M_CCIR'    'M_CCIR_VIA_RGB'    

  Columns 5 through 8

'M_NTSC'    'M_NTSC_RGB'      'M_NTSC_YC'    'M_PAL' 

  Columns 9 through 10

'M_PAL_RGB'    'M_PAL_YC'

vid2 = videoinput('matrox', 1,'M_NTSC_RGB');

Определение выбранного объекта источника видео

Когда вы создаете объект входа видео, тулбокс создает один или несколько объектов источника видео, сопоставленных с объектом входа видео. Количество созданных объектов-источников видео зависит от устройства и формата видео. The Source свойство объекта входа видео приводит эти объекты источника видео.

Для иллюстрации в этом примере перечисляются объекты источника видео, сопоставленные с объектом входа видео vid.

vid.Source
     Display Summary for Video Source Object Array:

      Index:   SourceName:   Selected:
      1        'CH0'         'on'     
      2        'CH1'         'off'    
      3        'CH2'         'off'    
      4        'CH3'         'off'    
      5        'CH4'         'off'    
      6        'CH5'         'off'    
      7        'CH6'         'off'    
      8        'CH7'         'off'

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

Этот пример меняет текущий выбранный объект видео на CH0 на CH1 путем установки значения SelectedSourceName свойство.

vid.SelectedSourceName = 'CH1';

Получение информации об объекте входа видео

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

out = imaqhwinfo(vid)
out = 

                AdaptorName: 'winvideo'
                 DeviceName: 'IBM PC Camera'
                  MaxHeight: 96
                   MaxWidth: 128
             NativeDataType: 'uint8'
               TotalSources: 1
    VendorDriverDescription: 'Windows WDM Compatible Driver'
        VendorDriverVersion: 'DirectX 9.0'