Регистрация стороннего пользовательского адаптера
adaptors = imaqregisterimaqregister возвращает пустой массив ячеек.
Примечание
imaqhwinfo и videoinput функции используют базовое имя адаптера, а не полный путь. Например, если полный путь адаптера равен "c:\adaptor.dll" (Windows ® ),"/local/adaptors/adaptor.so" (Linux ®), или"/local/adaptors/adaptor.dylib" (macOS), базовое имя адаптера: "adaptor".
adaptors = imaqregister(adaptorpath)
Регистрация адаптера информирует Toolbox™ получения изображения о местоположении библиотеки внешнего адаптера. Если система запрашивает доступное оборудование для получения изображений с помощью imaqhwinfo, панель инструментов предоставляет доступ к любым ранее зарегистрированным библиотекам адаптеров. imaqregister функция сохраняет имя зарегистрированного адаптера в каталоге предпочтений MATLAB ®, чтобы местоположение сохранялось в сеансах MATLAB. Посколькуimaqhwinfo кэширует список доступных адаптеров, может потребоваться вызов imaqreset после звонка imaqregister сделать доступным только что зарегистрированный адаптер.
Примечание
Общая библиотека адаптера (DLL в Windows) отличается от общей библиотеки драйвера, поставляемой поставщиком оборудования (также DLL в Windows). Общая библиотека адаптера специфична для панели инструментов получения изображений и определяется как таковая поставщиком оборудования.
adaptors = imaqregister(adaptorpath,action)action.
Зарегистрируйте внешний адаптер на панели инструментов получения изображений в системе Windows и просмотрите его данные. В этом примере используется демонстрационный адаптер, включенный в комплект инструментов для получения изображений, но можно выполнить следующие действия для регистрации любого пользовательского внешнего адаптера. Для просмотра исходных файлов демонстрационного адаптера перейдите в каталог системы. Точный путь к файлу может отличаться на компьютере.
cd('C:\Program Files\MATLAB\R2019b\toolbox\imaq\imaqadaptors\kit\demo\')Использовать imaqregister для информирования инструментария получения изображений о вашем стороннем адаптере. В этом примере рассмотрим предварительно созданную версию демонстрационного адаптера для Windows в \toolbox\imaq\imaqadaptors\kit\demo\win64 папка.
imaqregister('C:\Program Files\MATLAB\R2019b\toolbox\imaq\imaqadaptors\kit\demo\win64\mwdemoimaq.dll')ans = 1×1 cell array
{'C:\Program Files\MATLAB\R2019b\toolbox\imaq\imaqadaptors\kit\demo\win64\mwdemoimaq.dll'}
Панель инструментов кэширует информацию о адаптере, поэтому для отображения внешнего адаптера необходимо перезагрузить библиотеки адаптеров, зарегистрированные на панели инструментов.
imaqreset
Просмотр списка установленных адаптеров в InstalledAdaptors поле. Вновь зарегистрированный сторонний адаптер отображается как mwdemoimaq.
imaqhwinfo
ans = struct with fields:
InstalledAdaptors: {'demo' 'gentl' 'gige' 'kinect' 'matrox' 'mwdemoimaq' 'spinnaker' 'winvideo'}
MATLABVersion: '9.7 (R2019b)'
ToolboxName: 'Image Acquisition Toolbox'
ToolboxVersion: '6.1 (R2019b)'
Создайте объект ввода видео с помощью этого адаптера.
vid = videoinput('mwdemoimaq')Summary of Video Input Object Using 'Color Device'.
Acquisition Source(s): input1 is available.
Acquisition Parameters: 'input1' is the current selected source.
10 frames per trigger using the selected source.
'RGB_NTSC' video data to be logged upon START.
Grabbing first of every 1 frame(s).
Log data to 'memory' on trigger.
Trigger Parameters: 1 'immediate' trigger(s) on START.
Status: Waiting for START.
0 frames acquired since starting.
0 frames available for GETDATA.
Получение предварительного просмотра данных, возвращенных адаптером.
preview(vid)
После завершения работы с предварительным просмотром закройте окно.
closepreview(vid)
Следуйте этим рекомендациям при развертывании пользовательского адаптера в автономном приложении с помощью MATLAB Compiler™.
Звонить imaqregister в развертываемом коде MATLAB. Это гарантирует, что развернутое приложение зарегистрирует пользовательскую библиотеку адаптеров для пользователя, выполняющего приложение. Дополнительные сведения см. в разделе Создание пользовательских адаптеров.
Упакуйте пользовательскую библиотеку адаптеров с помощью автономного приложения. Для этого добавьте файл DLL адаптера в раздел Файлы, установленные для конечного пользователя приложения Application Compiler. Дополнительные сведения о создании автономного приложения см. в разделе Создание автономного приложения из MATLAB (MATLAB Compiler).
Первый запуск развернутого приложения, вызывающего imaqregister, возможно, потребуется выполнить приложение в режиме запуска от имени администратора.