Рассмотрение демонстрационного адаптера

Хороший способ получить краткое введение в адаптеры и разработку адаптера путем рассмотрения демонстрационного адаптера, который включен с Набором Адаптера Image Acquisition Toolbox™. Демонстрационный адаптер является функционирующим адаптером, который не требует никакого оборудования. Можно создать демонстрационный адаптер и запустить его, чтобы познакомиться с тем, как работает адаптер.

Нахождение демонстрационных исходных файлов адаптера

Демонстрационный адаптер исходные файлы C++ находится в следующей папке:

$MATLAB\toolbox\imaq\imaqadaptors\kit\demo\

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

Исходный файл	Описание
`DemoAdaptor.cpp`	Демонстрационная реализация класса адаптера
`DemoAdaptor.h`	Демонстрационное определение класса адаптера
`DemoDeviceFormat.cpp`	Реализация класса, который содержит данные о формате устройства
`DemoDeviceFormat.h`	Определение класса, который содержит данные о формате устройства
`DemoPropListener.cpp`	Реализация класса, который уведомляет демонстрационный адаптер, когда значение свойства устройства изменяется
`DemoPropListener.h`	Определение класса, который уведомляет демонстрационный адаптер, когда значение свойства устройства изменяется
`DemoSourceListener.cpp`	Реализация класса, который прислушивается к изменениям в выбранном источнике видеосигнала
`DemoSourceListener.h`	Определение класса раньше прислушивалось к изменениям в выбранном источнике видеосигнала
`DemoTimestampGetFcn.cpp`	Реализация класса, который обеспечивает пользовательский `get` функция для свойств метки времени.
`DemoTimestampGetFcn.h`	Определение класса, который обеспечивает пользовательский `get` функция для свойств метки времени.
`mwdemoimaq.cpp`	Реализация пяти функций, которые должен экспортировать каждый адаптер.
`mwdemoimaq.dll`	Демонстрационная библиотека адаптеров. Это - скомпилированная и соединенная Динамически подключаемая библиотека (DLL), которая реализует демонстрационный адаптер.
`mwdemoimaq.h`	Заголовочный файл, который задает пять функций, которые должен экспортировать каждый адаптер
`mwdemoimaq.imdf`	Демонстрационный файл формирователя изображения адаптера (IMDF), который содержит определения свойства
`mwdemoimaq.vcproj`	Microsoft^® Visual C++^® файл проекта для демонстрационного адаптера

Просмотр демонстрационных исходных файлов адаптера

В этом разделе описываются предложенный порядок, в котором необходимо посмотреть на демонстрационные исходные файлы адаптера.

mwdemoimaq.h

Хорошее место, чтобы начать смотреть на демонстрационный адаптер должно открыть mwdemoimaq.h файл. Этот файл задает пять функций, которые должен экспортировать каждый адаптер. Механизм тулбокса вызывает эти функции, чтобы получить информацию о поддерживаемом оборудовании, инстанцировать объекта ввода видео и получить данные. Реализация этих функций обычно является первым шагом, который делает средство записи адаптера. Этот заголовочный файл содержит комментарии, которые объясняют цель каждой функции.

mwdemoimaq.cpp

После наблюдения определения адаптера экспортировал функции, смотрите, как они реализованы в соответствующем файле реализации C++, mwdemoimaq.cpp.

DemoAdaptor.h

После просмотра экспортируемых функций смотрите на определение DemoAdaptor класс в DemoAdaptor.h. Класс адаптера является подклассом IAdaptor класс, который задает виртуальные функции адаптер, должен реализовать. Этот заголовочный файл содержит комментарии, которые объясняют цель каждой функции членства.

DemoAdaptor.cpp

После наблюдения определения класса адаптера посмотрите на реализацию класса в DemoAdaptor.cpp файл. Этот файл содержит функцию потока захвата, которая является основным циклом захвата системы координат. Это - то, где подключения адаптера к устройству и получают фреймы изображения.

Другие демонстрационные файлы адаптера

Демонстрационная директория содержит другие файлы, которые реализуют дополнительные возможности набора адаптера.

Например, DemoDeviceFormat.h и соответствующий .cpp файлы иллюстрируют один способ хранить специфичные для устройства данные о формате с помощью данных об адаптере. Вы задаете класс, который является подклассом IMAQInterface класс, чтобы содержать информацию. Смотрите Классы Определения, чтобы Содержать Специфичную для устройства информацию для получения дополнительной информации.

DemoPropListener.h и соответствующий .cpp файлы и DemoSourceListener.h и .cpp файлы иллюстрируют, как ваш адаптер может быть уведомлен, если пользователь изменяет настройки свойства. Смотрите, что Реализация Добирается и Поддержка Набора Device-Specific Properties для получения дополнительной информации.

Установка точек останова

Можно использовать точки останова отладчика, чтобы исследовать, какие функции адаптера вызваны, когда пользователи вызывают функции тулбокса, такие как imaqhwinfo, videoinputзапуск, и stop. В следующей таблице перечислены места в демонстрационном адаптере, где можно установить точки останова.

MATLAB^® Команда	Точка останова
`imaqhwinfo`	`initializeAdaptor()`
`imaqreset`	`uninitializeAdaptor()`
`imaqhwinfo(adaptorname)`	`getAvailHW()`
`videoinput`	`getDeviceAttributes()` `createInstance()`
`imaqhwinfo(obj)`	`getDriverDescription()` `getDriverVersion()` `getMaxWidth()` `getMaxHeight()` `getFrameType()`
`videoinput`	`getNumberOfBands()`
`start`	`openDevice()`
`start` или `trigger`, если ручной триггер	`startCapture()`
`stop`	`stopCapture()` `closeDevice()`

Создание демонстрационного адаптера

После ознакомления себя с демонстрационными исходными файлами адаптера создайте демонстрационный адаптер. Существует предварительно созданная версия демонстрационного адаптера в matlabroot/toolbox/imaq/imaqadaptors/kit/demo/$ARCH. Файл проекта Visual Studio и make-файл создают файл адаптера в подпапке этой папки.

Примечание

Чтобы создать демонстрационный адаптер на Windows, у вас должна быть переменная окружения под названием MATLAB заданный в вашей системе. Установите значение этой переменной окружения к местоположению вашей директории установки MATLAB.

Регистрация адаптера с тулбоксом

После создания адаптера необходимо сообщить программному обеспечению Image Acquisition Toolbox о его существовании путем регистрации его с imaqregister функция. Эта функция говорит тулбокс, где найти сторонние библиотеки адаптеров. Только необходимо указать адаптер однажды. Тулбокс хранит информацию местоположения адаптера в ваших настройках MATLAB.

Примечание

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

Например, следующие кодовые регистры демонстрационный адаптер с тулбоксом с помощью imaqregister функция, где <your_directory> представляет имя директории, где вы создали демонстрационный адаптер.

imaqregister('<your_directory>\mwdemoimaq.dll');

Выполнение демонстрационного адаптера

Запустите MATLAB и вызовите imaqhwinfo функция. Необходимо смочь видеть демонстрационный адаптер, включенный в адаптеры, перечисленные в InstalledAdaptors поле . Например, в системе Windows, imaqhwinfo возвращает следующее.

ans = 

    InstalledAdaptors: {'demo'  'matrox'  'winvideo'}
        MATLABVersion: '7.12 (R2011a)'
          ToolboxName: 'Image Acquisition Toolbox'
       ToolboxVersion: '4.1 (R2011a)'

Создайте объект ввода видео с демонстрационным адаптером.

vid = videoinput('demo');

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

preview(vid);

Windows Containing Demo Adaptor Data предварительного просмотра

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