В этой главе описываются, как использовать основанный на XML язык разметки, чтобы задать источник, свойство и аппаратную информацию о триггере в Файле устройств Обработки изображений (IMDF).
Создание IMDF требуется. Используя файл IMDF может упростить кодирование getDeviceAttributes()
вашего адаптера функция. Кроме того, это - единственный удобный способ сделать текст справки доступным для специфичных для устройства свойств, которые создает ваш адаптер.
Когда пользователь вызывает imaqhwinfo
функция, тулбокс ищет адаптер DLLs. Когда это находит DLL, это также ищет соответствие файл IMDF в тех же директориях. Если найдено, механизм хранит информацию пути к файлу IMDF. Файл IMDF должен находиться в той же директории как ваш DLL и .imdf
расширение файла, такое как demoimaq.imdf
.
Когда пользователь вызывает videoinput
функция, чтобы создать объект ввода видео, механизм читает и обрабатывает файл IMDF. Когда это читает файл, это обрабатывает свойство, триггер и информацию источника, указанную на верхнем уровне файла. (Чтобы изучить иерархическую организацию файла IMDF, смотрите Элементы Языка разметки IMDF.)
После чтения всех элементов верхнего уровня механизм ищет элемент устройства, который совпадает с устройством пользователь, заданный в videoinput
функция. Если найдено, механизм затем ищет элемент формата видео в элементе устройства.
Механизм затем вызывает getDeviceAttributes()
вашего адаптера функция, как описано в Реализации Добираются и Поддержка Набора Device-Specific Properties, чтобы настроить свойства устройства.
Следующий рисунок показывает иерархическое отношение элементов основанного на XML языка разметки для файлов IMDF. Рисунок показывает, какие элементы могут быть дочерними элементами других элементов. Элементы на верхнем уровне файла IMDF (элементы, которые являются дочерними элементами ImageAcquisitionInfo
элемент применяется к целому адаптеру. Элементы, которые являются дочерними элементами Device
элемент применяется только к тому устройству. Чтобы упростить схему, все возможные зависимые элементы не всегда показывают для элементов ниже верхнего уровня. Когда используется в файле IMDF, элементы называются узлами.
Иерархия элементов IMDF