Каждый адаптер должен включать getAvailHW() функция. В этой функции вы предоставляете тулбоксу информацию об устройстве (или устройства), которые в настоящее время соединяются с системой пользователя. Адаптер может представлять одно конкретное устройство, несколько устройств, поддержанных конкретным поставщиком или классом устройств. Например, тулбокс включает адаптер для устройств Matrox, который поддерживает много различных средств захвата кадра, обеспеченных тем поставщиком.
Когда пользователь вызывает imaqhwinfo функция, чтобы узнать, какие устройства доступны в своей системе, механизм тулбокса, вызывает getAvailHW() вашего адаптера функция, чтобы получить эту информацию. Когда вы реализуете эту функцию, вы определяете имена, идентификаторы устройства и имена формата, которые тулбокс отображает пользователям.
Этот раздел включает следующие темы
Набор адаптера обеспечивает три класса, чтобы сохранить информацию об устройстве и данные о формате:
Объект набора адаптера | Цель |
|---|---|
| Полный контейнерный класс для получения информации об оборудовании |
| Контейнер для получения информации о конкретном устройстве |
| Контейнер для получения информации о форматах поддержан конкретным устройством |
Когда механизм тулбокса вызывает getAvailHW() вашего адаптера функция, это передает ваш адаптер указатель на IHardwareInfo объект.
Для каждого устройства вы хотите сделать доступным через ваш адаптер, необходимо создать IDeviceInfo возразите и затем храните объект в IHardwareInfo объект. Для каждого формата, поддержанного устройством, необходимо создать IDeviceFormat возразите и затем храните объект в IDeviceInfo объект.
Следующий рисунок показывает отношение этих объектов набора адаптера. Рисунок показывает IHardwareInfo объект, содержащий два IDeviceInfo объекты, но это может содержать больше. Точно так же каждый IDeviceInfo объект показывают содержащий два IDeviceFormat объекты, но это может также содержать больше.
Отметьте в фигуре это оба IDeviceInfo и IDeviceFormat объекты содержат данные об адаптере. Данные об адаптере являются дополнительным способом хранить дополнительную информацию об устройстве или формате в IDeviceInfo или IDeviceFormat объект. Смотрите Классы Определения, чтобы Содержать Специфичную для устройства информацию для получения дополнительной информации.
Объекты набора адаптера, используемые, чтобы сохранить информацию об устройстве и данные о формате
getAvailHW() функция принимает один аргумент: указатель на IHardwareInfo объект. Механизм тулбокса создает этот IHardwareInfo объект и передачи указатель на ваш адаптер, когда это вызывает getAvailHW() вашего адаптера функция. getAvailHW() функция не возвращает значение.
void getAvailHW(imaqkit::IHardwareInfo* hardwareInfo)
getAvailHW() вашего адаптера функция должна предоставить механизму следующую информацию для каждого устройства:
ID устройства
Имя устройства
Форматы поддержаны устройством, включая формат по умолчанию
Поддерживает ли устройство файлы конфигурации устройства (также известный как файлы камеры)
Можно опционально хранить дополнительную специфичную для устройства информацию в данных об адаптере IDeviceInfo возразите или IDeviceFormat объект. Смотрите Классы Определения, чтобы Содержать Специфичную для устройства информацию для получения дополнительной информации.
Следующие основы шаги обычно выполняются getAvailHW() функция. Фигура, которая следует, представляет этот алгоритм в форме блок-схемы.
Определите, какие устройства доступны через адаптер. Адаптеры обычно выполняют вызовы к SDK устройства, чтобы получить эту информацию.
Для каждого найденного устройства создайте IDeviceInfo объект — видит Информацию об устройстве Хранения.
Для каждого формата, поддержанного устройством, создайте IDeviceFormat объект — видит Данные о формате Хранения.
Добавьте каждый объект формата устройства, который вы создаете к IDeviceInfo объект.
Добавьте IDeviceInfo возразите против IHardwareInfo объект передал вашему getAvailHW() функция механизмом тулбокса.
Повторите эту процедуру для каждого устройства, доступного в системе пользователя.
Предложенный Алгоритм для getAvailHW () Функция
Вы храните информацию об устройстве в IDeviceInfo объект. Чтобы создать этот объект, используйте createDeviceInfo() функция членства IHardwareInfo объект, как в следующем примере:
imaqkit::IDeviceInfo* deviceInfo =
hardwareInfo->createDeviceInfo(1,"MyDevice");
В качестве аргументов к createDeviceInfo(), вы задаете:
Назовите вас, хотят присвоить устройству
ID вы хотите присвоить устройству
Можно задать любые значения для этих аргументов, но отметить, что они отображаются пользователям тулбокса в структуре, возвращенной imaqhwinfo.
Для имени устройства задайте вектор символов, который легко идентифицирует устройство. Например, вы можете использовать номер модели производителя.
ID, который вы задаете для устройства, должен быть уникальным, потому что это идентифицирует устройство для адаптера. Поскольку индексация MATLAB® запускается в 1, запустите нумерацию идентификаторов устройства в 1, не нуль. Устройство с ID 1 является устройством по умолчанию для вашего адаптера.
IDeviceInfo объект вы создаете функции членства поддержек, чтобы выполнить много задач, таких как создание, добавление и получение IDeviceFormat объекты сопоставили с устройством и указанием, поддерживает ли устройство файлы конфигурации устройства (также известный как файлы камеры). Для получения дополнительной информации об этом классе, см. Справочную документацию API Набора Адаптера Image Acquisition Toolbox™.
После того, как вы создаете IDeviceInfo объект, необходимо добавить его в IHardwareInfo возразите, что механизм передал вашему getAvailHW() функция. Используйте addDevice() функция членства IHardwareInfo объект, как в следующем примере:
hardwareInfo->addDevice(deviceInfo);
Вы храните данные о формате в IDeviceFormat объект. Чтобы создать этот объект, используйте createDeviceFormat() функция членства IDeviceInfo объект, как в следующем примере:
imaqkit::IDeviceFormat* deviceFormat =
deviceInfo->createDeviceFormat(1,"RS170");
В качестве аргументов к createDeviceFormat(), вы задаете
Назовите вас, хотят присвоить формату
ID вы хотите присвоить формату
Для имени формата задайте вектор символов, который описывает формат. Обратите внимание на то, что имя формата отображается пользователям тулбокса. Используйте имена, которые могут быть знакомыми пользователям устройства, такими как имя, похожее на имена формата, используемые производителем устройств.
Поскольку ID не отсоединен пользователям, можно задать любое удобное значение. Например, если SDK устройства использует числовые идентификаторы, чтобы указать на формат, используйте эти значения в своих идентификаторах формата.
Можно использовать IDeviceFormat функции членства, чтобы выполнить много задач, такой как, получая имя формата и идентификатор формата, и определяя, является ли формат форматом по умолчанию. Для получения дополнительной информации об этом классе, см. Справочную документацию API Набора Адаптера Image Acquisition Toolbox.
После того, как вы создаете IDeviceFormat возразите, добавьте его в IDeviceInfo объект, который представляет устройство. Используйте addDeviceFormat() функция членства IDeviceInfo объект, как в следующем примере:
deviceInfo->addDeviceFormat(deviceFormat,true);
Когда вы добавляете формат в IDeviceInfo объект, вы используете второй аргумент для addDeviceFormat() функция, чтобы задать, должен ли формат использоваться в качестве формата по умолчанию для устройства. imaqhwinfo функция возвращает имя формата по умолчанию в DefaultFormat поле . Чтобы сделать формат значением по умолчанию, установите этот аргумент на true.
Некоторые устройства используют файлы конфигурации устройства (также известный как файлы камеры), чтобы сконфигурировать форматы и другие свойства. Если устройство поддерживает файлы конфигурации устройства, вы не должны создавать IDeviceFormat объекты. Вместо этого используйте setDeviceFileSupport() функция членства IDeviceInfo объект указать, что устройство поддерживает файлы конфигурации устройства, как в следующем примере:
deviceInfo->setDeviceFileSupport(true);
Для этих устройств пользователи передают полный путь файла конфигурации устройства в качестве третьего аргумента к videoinput функция, вместо того, чтобы задать формат устройства. Средства записи адаптера не должны выполнять обработку файла конфигурации устройства; вы только передаете имя файла устройству.
Следующий пример представляет простую реализацию getAvailHW() функция, которая указывает информацию для одного устройства с двумя форматами. Намерение этого примера состоит в том, чтобы показать, как вы создаете объекты, необходимые, чтобы сохранить информацию об устройстве и данные о формате. Если вы добавляете этот код в mydeviceimaq адаптер, можно запустить imaqhwinfo('mydeviceimaq') просмотреть информацию об устройстве.
Замените тупиковую реализацию getAvailHW() функция, созданная в Создании Тупикового Адаптера, с этим кодом:
void getAvailHW(imaqkit::IHardwareInfo* hardwareInfo)
{
// Create a Device Info object.
imaqkit::IDeviceInfo* deviceInfo =
hardwareInfo->createDeviceInfo(1,"MyDevice");
// Create a Device Format object.
imaqkit::IDeviceFormat* deviceFormat =
deviceInfo->createDeviceFormat(1,"RS170");
// Add the format object to the Device object.
// Specifying "true' makes this format the default format.
deviceInfo->addDeviceFormat(deviceFormat, true);
// Create a second Device Format object.
imaqkit::IDeviceFormat* deviceFormat2 =
deviceInfo->createDeviceFormat(2,"PAL");
// Add the second format object to the Device object.
deviceInfo->addDeviceFormat(deviceFormat2, false);
// Add the device object to the hardware info object.
hardwareInfo->addDevice(deviceInfo);
}
Восстановите mydeviceimaq проект создать новый DLL.
Запустите программное обеспечение MATLAB и запустите imaqhwinfo функция, задавая адаптер называет mydeviceimaq в качестве аргумента. Отметьте как DeviceIDs поле и DeviceInfo поле структуры возвращено imaqhwinfo теперь содержите данные.
dev = imaqhwinfo('mydeviceimaq')
dev =
AdaptorDllName: 'C:\My_Adaptor\mydeviceimaq.dll'
AdaptorDllVersion: '4.1 (R2011a)'
AdaptorName: 'mydeviceimaq'
DeviceIDs: {[1]}
DeviceInfo: [1x1 struct]
Чтобы просмотреть подробную информацию об устройстве, просмотрите структуру в DeviceInfo поле . DeviceInfo поле является массивом структур, где каждая структура предоставляет подробную информацию о конкретном устройстве.
dev_info = dev.DeviceInfo
dev_info =
DefaultFormat: 'RS170'
DeviceFileSupported: 0
DeviceName: 'MyDevice'
DeviceID: 1
ObjectConstructor: 'videoinput('mydeviceimaq', 1)'
SupportedFormats: {'PAL' 'RS170'}
Следующая таблица описывает информацию в каждом поле со ссылками на другие разделы, которые предоставляют больше информации.
Поле | Описание |
|---|---|
| Вектор символов, который задает формат по умолчанию, используемый устройством. Вы задаете формат по умолчанию, когда вы добавляете |
| Булево значение, которое говорит, поддерживает ли устройство файлы конфигурации устройства (также известный как файлы камеры). Вы используете |
| Вектор символов, который идентифицирует конкретное устройство. Вы задаете это значение, когда вы создаете |
| Числовое значение, которое однозначно определяет конкретное устройство. Вы задаете это значение, когда вы создаете |
| Вектор символов, который содержит |
| Массив ячеек из символьных векторов, который идентифицирует форматы это устройство поддержки. Вы задаете это значение, когда вы создаете |