Чтобы указать информацию свойства в файле IMDF, используйте Property
элемент. Можно включать как многих Property
узлы в файле IMDF, как вы хотите. Property
узлы могут быть дочерними элементами корневого узла, Device
узел или Videoformat
узел. Узлы свойства могут также быть дочерними элементами Section
узлы.
Примечание
Property
узлы, которые являются дочерними элементами корневого узла, влияют на все устройства, к которым получают доступ через адаптер. Property
узлы, которые являются дочерними элементами Device
или VideoFormat
узел влияет только на то устройство или формат видео.
Вы используете атрибуты Property
элемент, чтобы задать характеристики свойства, такие как его имя, вводит, и ограничения. Для получения дополнительной информации о Property
атрибуты, смотрите Атрибуты Элемента Свойства Определения.
Следующий пример обрисовывает в общих чертах, как использовать эти элементы, чтобы указать информацию свойства. Пример показывает Property
узел как дочерний элемент корневого узла, но вы используете его тот же путь в качестве дочернего элемента Device
или VideoFormat
узел. Слова курсивом представляют текст, который вы задаете.
<ImageAcquisitionInfo> <Property constraint=constraint_value deviceSpecific=true_or_false name=property_name readOnly=always_never_or_whileRunning type=cell_double_int_or_string min=minimum_value max=maximum_value optional=on_or_off default=default_value> </Property> . . . </ImageAcquisitionInfo>
В следующей таблице перечислены атрибуты узла Свойства в алфавитном порядке. Таблица дает краткое описание свойства и списки, какие свойства требуются и которые являются дополнительными.
Атрибут | Описание | Необходимый |
---|---|---|
| Указывает, что ограничения на свойство — видят Значения Определения для Ограничительного Атрибута. | Необходимый |
| Значение по умолчанию для свойства. | Дополнительный |
| Булево значение. | Необходимый |
| Минимальное допустимое значение | Дополнительный |
| Максимальное допустимое значение | Дополнительный |
| Имя свойства | Необходимый |
| Если установлено в | Дополнительный |
| Состояние только для чтения свойства: | Необходимый |
| Тип данных свойства: | Необходимый |
Ограничения указывают информацию о том, что является допустимыми значениями для свойства. Например, чтобы указать, что свойство только принимает положительные значения, используйте положительное ограничительное значение, можно следующим образом:
constraint=positive
В следующей таблице перечислены все возможные значения для constraint
припишите в алфавитном порядке.
Ограничительное значение | Описание |
---|---|
| Свойство имеет и минимальное и максимальное значение. Если вы устанавливаете |
| Свойство является перечисляемым значением. Если установлено, |
| Значение должно быть положительным или бесконечным |
| Никакие ограничения |
| Значение должно быть положительным |
| Значение должно быть больше нуля или бесконечный |
| Значение должно быть больше нуля |
Если ваше свойство использует перечисляемые значения, необходимо установить значение constraint
припишите enum
, атрибут type к character vector
, и создайте EnumConstraintValue
элементы для каждого перечисления. EnumConstraintValue
узлы являются дочерними элементами Property
узел.
Когда вы создаете узлы EnumConstraintValue, вы задаете два атрибута:
ID значения
Имя значения
Этот пример задает свойство StrobeEnable
. Ограничительный атрибут установлен в enum
. Атрибут имени EnumConstraintValue
узлы задают возможные значения этого перечисления: on
и off
.
<Property optional="on" constraint="enum" deviceSpecific="true" name="StrobeEnable" readOnly="whileRunning" type="string"> <EnumConstraintValue id="0" name="off" /> <EnumConstraintValue id="1" name="on" /> </Property>