imaqhwinfo

Информация о доступном оборудовании получения изображений

Синтаксис

out = imaqhwinfo
out = imaqhwinfo(adaptorname)
out = imaqhwinfo(adaptorname,field)
out = imaqhwinfo(adaptorname, deviceID)
out = imaqhwinfo(obj)
out = imaqhwinfo(obj,field)

Описание

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

out = imaqhwinfo(adaptorname) возвращает out, структура, которая содержит информацию об адаптере, заданном вектором символов adaptorname. Возвращенная информация включает версию адаптера и доступное оборудование для заданного адаптера. Чтобы получить список допустимых имен адаптера, используйте синтаксис imaqhwinfo.

out = imaqhwinfo(adaptorname,field) возвращает значение поля, заданного вектором символов field для адаптера, заданного вектором символов adaptorname. Аргумент может быть односимвольным вектором или массивом ячеек из символьных векторов. Если field является массивом ячеек, out является 1 n массивом ячеек, где n является длиной field. Чтобы получить список допустимых имен полей, используйте синтаксис imaqhwinfo('adaptorname').

out = imaqhwinfo(adaptorname, deviceID) возвращает out, структура, содержащая информацию об устройстве, заданном числовым ID устройства deviceID. deviceID может быть скаляром или вектором. Если deviceID является вектором, out является 1 n массивом структур, где n является длиной deviceID.

out = imaqhwinfo(obj) возвращает out, структура, которая содержит информацию о заданном объекте obj получения изображений. Возвращенная информация включает имя адаптера, имя устройства, разрешение видео, собственный тип данных, и имя драйвера устройства и версию. Если obj является массивом объектов устройства, то out является 1 n массивом ячеек структур, где n является длиной obj.

out = imaqhwinfo(obj,field) возвращает информацию в поле, заданном field для объекта obj устройства. field может быть одним именем поля или массивом ячеек имен полей. out является m-by-n массив ячеек, где m является длиной obj, и n является длиной field. Можно возвратить список допустимых имен полей с синтаксисом imaqhwinfo(obj).

Примечание

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

Примечание

Чтобы получить список опций, можно использовать на функции, нажать клавишу Tab после ввода функции на командной строке MATLAB. Список расширяется, и можно прокрутить, чтобы выбрать свойство или значение. Для получения информации об использовании этой функции завершения вкладки "Дополнительно" смотрите Используя Заполнение клавишей Tab для Функций.

Примеры

Этот пример возвращает информацию обо всех адаптерах, доступных в системе.

imaqhwinfo

ans = 

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

Этот пример возвращает информацию обо всех устройствах, доступных через конкретный адаптер.

info = imaqhwinfo('winvideo')
info = 

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

Этот пример возвращает информацию об определенном устройстве, доступном через конкретный адаптер. Вы идентифицируете устройство его ID устройства.

dev_info = imaqhwinfo('winvideo', 1)

dev_info = 

          DefaultFormat: 'RGB555_128x96'
    DeviceFileSupported: 0
             DeviceName: 'IBM PC Camera'
               DeviceID: 1
  VideoInputConstructor: 'videoinput('winvideo', 1)'
 VideoDeviceConstructor: 'imaq.VideoDevice('winvideo', 1)'       
       SupportedFormats: {1x34 cell}

Этот пример получает информацию об устройстве, сопоставленном с конкретным объектом ввода видео.

obj = videoinput('winvideo', 1);

obj_info = imaqhwinfo(obj)

obj_info = 

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

Этот пример возвращает значение конкретного поля в информации об устройстве, сопоставленной с конкретным объектом ввода видео.

field_info = imaqhwinfo(vid,'adaptorname')
field_info =

winvideo

Смотрите также

|

Представлено до R2006a