imaqregister

Зарегистрировать пользовательский адаптер стороннего производителя

Описание

adaptors = imaqregister возвращает список зарегистрированных сторонних адаптеров с полными путями. Если зарегистрированных адаптеров нет, imaqregister возвращает пустой массив ячеек.

Примечание

The imaqhwinfo и videoinput функции используют базовое имя адаптера, а не полный путь. Для примера, если адаптер является полным путем "c:\adaptor.dll" (Окна®), "/local/adaptors/adaptor.so" (Linux®), или "/local/adaptors/adaptor.dylib" (macOS), базовое имя адаптера "adaptor".

пример

adaptors = imaqregister(adaptorpath) регистрирует указанную библиотеку сторонних адаптеров и возвращает список всех зарегистрированных адаптеров.

Регистрация адаптера информирует Image Acquisition Toolbox™ о местоположении сторонней библиотеки адаптеров. Если вы запрашиваете у системы доступное оборудование для сбора изображений при помощи imaqhwinfoтулбокс обеспечивает доступность любых ранее зарегистрированных библиотек адаптеров. The imaqregister функция сохраняет имя зарегистрированного адаптера в MATLAB® настройки директории так, чтобы расположение сохранялось между Сеансами работы с MATLAB. Потому что imaqhwinfo кэширует список доступных адаптеров, может потребоваться вызвать imaqreset после вызова imaqregister чтобы сделать новый зарегистрированный адаптер доступным.

Примечание

Общая библиотека адаптера (библиотека DLL в Windows) отличается от общей библиотеки драйверов, поставляемой поставщиком оборудования (также DLL в Windows). Общая библиотека адаптеров относится только к Image Acquisition Toolbox и определяется как таковая поставщиком оборудования.

adaptors = imaqregister(adaptorpath,action) добавляет или удаляет адаптер стороннего производителя из списка доступных адаптеров, как указано в action.

Примеры

свернуть все

Зарегистрируйте сторонний адаптер в Image Acquisition Toolbox на системе Windows и предварительно просмотрите его данные. Этот пример использует демонстрационный адаптер, включенный в Image Acquisition Toolbox, но можно следовать этим шагам, чтобы зарегистрировать любой пользовательский сторонний адаптер. Чтобы просмотреть исходные файлы демо-адаптера, перейдите в директорию на вашей системе. Точный путь к файлу может отличаться на вашем компьютере.

cd('C:\Program Files\MATLAB\R2019b\toolbox\imaq\imaqadaptors\kit\demo\')

Использование imaqregister чтобы проинформировать Image Acquisition Toolbox о вашем стороннем адаптере. В данном примере рассмотрим предварительно созданную версию демонстрационного адаптера для 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)

Входные параметры

свернуть все

Путь адаптера, заданный как вектор символов или строковые массивы. Необходимо задать полный абсолютный путь к файлу библиотеки адаптеров.

Пример: imaqregister('c:\temp\thirdpartyadaptor.dll') регистрирует адаптер thirdpartyadaptor.

Типы данных: char | string

Регистрация адаптера, заданная как 'register' или 'unregister'. Использование 'register' добавляет сторонний адаптер в список доступных адаптеров. Использование 'unregister' удаляет адаптер стороннего производителя из списка.

Пример: imaqregister('c:\temp\thirdpartyadaptor.dll','unregister') удаляет адаптер thirdpartyadaptor.

Типы данных: char | string

Совет

  • Следуйте этим рекомендациям при развертывании пользовательского адаптера в автономном приложении с помощью MATLAB Compiler™.

    • Функции imaqregister в коде MATLAB, который вы развертываете. Это гарантирует, что развернутое приложение регистрирует пользовательскую библиотеку адаптеров для пользователя, выполняющего приложение. Дополнительные сведения см. в разделе Создание пользовательских адаптеров.

    • Упакуйте библиотеку пользовательских адаптеров в автономное приложение. Для этого добавьте файл адаптера в Files installed for your end user разделе Application Compiler app.Дополнительные сведения о создании автономного приложения см. в разделе Создание автономного приложения из MATLAB (MATLAB Compiler).

    • При первом запуске развернутого приложения, вызывающего imaqregisterВозможно, вам потребуется выполнить приложение в Run as administrator режиме.

Представлено до R2006a
Для просмотра документации необходимо авторизоваться на сайте