Image Acquisition Toolbox 3.4

Identifying Available Devices

Contents

Identifying Installed Adaptors

The imaqhwinfo function provides a structure with an InstalledAdaptors field that lists all adaptors on the current system that the toolbox can access.

imaqInfo = imaqhwinfo

imaqInfo =

    InstalledAdaptors: {'dcam'  'winvideo'}
        MATLABVersion: '7.1 (R14SP3)'
          ToolboxName: 'Image Acquisition Toolbox'
       ToolboxVersion: '1.9 (R14SP3)'

imaqInfo.InstalledAdaptors

ans =

    'dcam'    'winvideo'

Obtaining Device Information

Calling imaqhwinfo with an adaptor name returns a structure that provides information on all accessible image acquisition devices.

hwInfo = imaqhwinfo('winvideo')

hwInfo =

       AdaptorDllName: [1x68 char]
    AdaptorDllVersion: '1.9 (R14SP3)'
          AdaptorName: 'winvideo'
            DeviceIDs: {[1]  [3]}
           DeviceInfo: [1x2 struct]

hwInfo.DeviceInfo

ans =

1x2 struct array with fields:
    DefaultFormat
    DeviceFileSupported
    DeviceName
    DeviceID
    ObjectConstructor
    SupportedFormats

Information on a specific device can be obtained by simply indexing into the device information structure array.

device1 = hwInfo.DeviceInfo(1)

device1 =

          DefaultFormat: 'RGB555_320x240'
    DeviceFileSupported: 0
             DeviceName: 'Veo PC Camera'
               DeviceID: 1
      ObjectConstructor: 'videoinput('winvideo', 1)'
       SupportedFormats: {1x30 cell}

The DeviceName field contains the image acquisition device name.

device1.DeviceName

ans =

Veo PC Camera

The DeviceID field contains the image acquisition device identifier.

device1.DeviceID

ans =

     1

The DefaultFormat field contains the image acquisition device's default video format.

device1.DefaultFormat

ans =

RGB555_320x240

The SupportedFormats field contains a cell array of all valid video formats supported by the image acquisition device.

device1.SupportedFormats

ans =

  Columns 1 through 4

    'I420_128x96'    'I420_160x120'    'I420_176x144'    'I420_320x240'

  Columns 5 through 8

    'I420_352x240'    'I420_352x288'    'RGB24_128x96'    'RGB24_160x120'

  Columns 9 through 11

    'RGB24_176x144'    'RGB24_320x240'    'RGB24_352x240'

  Columns 12 through 14

    'RGB24_352x288'    'RGB555_128x96'    'RGB555_160x120'

  Columns 15 through 17

    'RGB555_176x144'    'RGB555_320x240'    'RGB555_352x240'

  Columns 18 through 21

    'RGB555_352x288'    'UYVY_128x96'    'UYVY_160x120'    'UYVY_176x144'

  Columns 22 through 25

    'YUY2_128x96'    'YUY2_160x120'    'YUY2_176x144'    'YV12_128x96'

  Columns 26 through 29

    'YV12_160x120'    'YV12_176x144'    'YV12_320x240'    'YV12_352x240'

  Column 30

    'YV12_352x288'