Тулбокс определяет источник видео как один или несколько аппаратных входы, которые обрабатываются как одна сущность. Для примера устройство сбора изображений может поддерживать источник RGB, состоящий из трех физических соединений. Тулбокс будет рассматривать эти три соединения как один источник видео. Ознакомьтесь с документацией, поставляемой с вашим устройством, чтобы определить поддерживаемые им источники видео.
Когда пользователь создает объект входа видео, механизм тулбокса автоматически создает объект источника видео для каждого источника, поддерживаемого адаптером. The Source свойство объекта входа видео содержит список доступных источников видео. Объект источника видео, который используется для сбора данных, называется текущим выбранным источником видео. По умолчанию механизм тулбокса использует первый источник видео, который вы определяете как выбранный источник, но пользователи могут переключать выбранный источник, задавая значение объекта входа видео SelectedSourceName свойство.
Ваш адаптер getDeviceAttributes() функция должна определять все свойства и источники видео, данные вы хотите сделать доступными для пользователей. Этот раздел охватывает только определение источников видео, что означает определение текстовых меток, используемых для идентификации доступных источников видео. Дополнительные сведения о том, как сделать свойства устройства доступными для пользователей, см. в разделе «Определение свойств конкретного устройства».
Примечание
Каждый адаптер должен указать по крайней мере один источник видео; в противном случае вы не можете создать объект входа видео, если источник видео не был указан.
Вы используете addAdaptorSource() представитель IVideoSourceInfo объект, который механизм тулбокса передает в getDeviceAttributes() вашего адаптера функция для определения источника видео. Вы задаете следующие два аргумента:
Имя, которое необходимо присвоить источнику
Идентификатор, который необходимо назначить источнику
Имя отображается пользователям. Выберите имя, которое четко определяет источник. Если поставщик устройства присваивает имена источникам, можно использовать те же имена. Например, некоторые устройства Matrox идентифицируют источники видео по меткам ch0, ch1, и т.д.
Поскольку идентификатор не доступен пользователям, можно задать любое удобное значение. Например, если SDK устройства использует числовые идентификаторы для указания источника видео, используйте эти значения для ваших исходных идентификаторов.
Для примера этот код задает источник видео.
sourceContainer->addAdaptorSource("MyDeviceSource",1)
Можно использовать IVideoSourceInfo функции представителя для выполнения многих задач, таких как определение текущего выбранного источника. Для получения дополнительной информации об этом классе см. документацию Image Acquisition Toolbox™ Adaptor Kit API Ссылки.