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

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

Примечание

Создание IMDF требуется. Используя файл IMDF может упростить кодирование getDeviceAttributes() вашего адаптера функция. Кроме того, это - единственный удобный способ сделать текст справки доступным для специфичных для устройства свойств, которые создает ваш адаптер.

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

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

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

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

Механизм затем вызывает getDeviceAttributes() вашего адаптера функция, как описано в Реализации Добираются и Поддержка Набора Device-Specific Properties, чтобы настроить свойства устройства.

Элементы языка разметки IMDF

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

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