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