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