Использование языка разметки IMDF

В этой главе описывается, как использовать язык разметки на основе XML для определения информации об источнике, свойстве и аппаратном триггере в файле Imaging Device File (IMDF).

Примечание

Требуется создание МВФ. Использование файла IMDF может упростить кодирование getDeviceAttributes() вашего адаптера функция. В сложение это единственный удобный способ сделать текст справки доступным для свойств конкретного устройства, которые создает адаптер.

Пользовательский сценарий

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

Когда пользователь вызывает videoinput функция для создания объекта входа видео, механизм считывает и обрабатывает файл IMDF. Когда файл читается, он обрабатывает свойство, триггер и исходную информацию, заданную на верхнем уровне файла. (Для понимания иерархического расположения файла IMDF смотрите Элементы языка разметки IMDF.)

После чтения всех элементов верхнего уровня движок ищет элемент устройства, который соответствует устройству, указанному пользователем в videoinput функция. Если он найден, двигатель затем ищет элемент формата видео в элементе устройства.

Затем двигатель вызывает getDeviceAttributes() вашего адаптера функция, как описано в Implementing Get and Set Support for Device-Specific Properties, для настройки свойств устройства.

Элементы языка разметки МВФ

Следующий рисунок показывает иерархическую связь элементов языка разметки на основе XML для файлов IMDF. Рисунок показывает, какие элементы могут быть дочерними для других элементов. Элементы верхнего уровня файла IMDF (элементы, являющиеся дочерними элементами ImageAcquisitionInfo элемент применяется к целому адаптеру. Элементы, которые являются дочерними элементами Device элемент применяется только к этому устройству. Чтобы упростить схему, все возможные подчиненные элементы не всегда показаны для элементов ниже верхнего уровня. При использовании в файле IMDF элементы называются узлами.

Иерархия элементов IMDF