imaqregister

Укажите сторонний пользовательский адаптер

Описание

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

Примечание

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

пример

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

Регистрация адаптера сообщает Image Acquisition Toolbox™ местоположения сторонней библиотеки адаптеров. Если вы запрашиваете систему для доступного оборудования получения изображений при помощи imaqhwinfo, тулбокс делает доступным любые ранее зарегистрированные библиотеки адаптеров. 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, который вы развертываете. Это гарантирует, что развертываемое приложение указывает библиотеку пользовательского адаптера для пользователя, запускающего приложение. Для получения дополнительной информации смотрите Пользовательские адаптеры Создания.

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

    • В первый раз вы запускаете развертываемое приложение, которое вызывает imaqregister, вы можете должны быть выполнить приложение в режиме Run as administrator.

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