Подготовка Среды сборки на Windows Systems

Подготовка среды сборки включает определение заголовочных файлов и библиотек, что необходимо создать адаптер. Для знакомых с их средой IDE, смотрите, что следующие разделы для списков их требуемых включают файлы и библиотеки. Этот раздел также описывает, как создать переменную окружения, которую можно использовать, чтобы задать папку установки MATLAB®. Заголовочный файл и пути к библиотеке используют эту переменную окружения. Для подробных инструкций относительно подготовки вашей среды сборки в Microsoft® Visual C ++® среда разработки, смотрите Создание Проекта Адаптера Используя Microsoft Visual C++.

Примечание

Пользователи Microsoft Visual C++ должны иметь в виду, что существуют определенные параметры проекта, которые они должны установить. Смотрите Конфигурирование Других Параметров Проекта.

Необходимые заголовочные файлы и библиотеки

В следующей таблице перечислены местоположения заголовочных файлов и библиотек, что необходимо создать адаптер.

Примечание

Необходимо также задать местоположение заголовочных файлов и библиотек, требуемых устройством. Считайте документацию SDK своего устройства, чтобы получить эту информацию.

Заголовочный файл и библиотеки

Местоположение

Заголовочные файлы набора адаптера

$(MATLAB)\toolbox\imaq\imaqadaptors\kit\include

Библиотека механизма Image Acquisition Toolbox™

$(MATLAB)\toolbox\imaq\imaqadaptors\kit\lib\<ARCH>\release\imaqmex.lib

[a]  MATLAB является переменной окружения, которая содержит имя вашей папки установки MATLAB.

Используя переменные окружения

Чтобы создать переменную окружения в вашей системе Windows®, которая задает вашу папку установки MATLAB, выполните эту процедуру:

  1. Откройте диалоговое окно System Properties в Панели управления Windows Control Panel: Control Panel > System and Security > System.

  2. В Системной Панели управления кликните по Усовершенствованной опции параметров настройки системы.

  3. На Вкладке "Дополнительно" нажмите кнопку Environment Variables.

  4. В диалоговом окне Environment Variables, в разделе Пользовательских переменных, нажимают New, чтобы создать переменную окружения.

  5. В диалоговом окне New User Variable присвойте имя MATLAB переменной и установите значение переменной к вашему пути к папке установки MATLAB. Нажать ОК.

  6. Нажмите ОК в диалоговом окне Environment Variables, и затем в диалоговом окне System Properties.

Примечание

Если Microsoft Visual C++ запускается, когда вы создаете эту переменную, необходимо перезапустить его.

Создание проекта адаптера Используя Microsoft Visual C++

Как первый шаг к созданию адаптера, откройте Microsoft Visual C++ и создайте новый проект.

Примечание

Строго рекомендуется, чтобы вы использовали версию Microsoft Visual Studio®. Для получения информации о поддерживаемых версиях см. столбец MATLAB в таблице: https://www.mathworks.com/support/compilers.html.

  1. Настройте любые необходимые переменные окружения — смотрите Используя Переменные окружения.

  2. Запустите Microsoft Visual C++.

  3. На начальной странице нажмите New Project.... Visual Studio открывает диалоговое окно New Project. Можно также открыть это диалоговое окно из меню File> New> Project.

  4. В диалоговом окне New Project:

    • Расширьте Visual C++, под Установленными Шаблонами, в случае необходимости, и выберите Win32.

    • Выберите Win32 Project.

    • Введите имя, которое вы хотите присвоить проекту в Поле имени и задать, где вы хотите определить местоположение проекта в поле Location.

      Можно дать проекту адаптера любое имя. Соглашение, используемое тулбоксом, состоит в том, чтобы назвать адаптеры можно следующим образом:

      vendor_name + imaq
      

      где вы заменяете вектор символов vendor_name на что-то соответствующее вашему проекту.

    • Нажать ОК. Visual C++ открывает Мастер приложений Win32.

  5. В Мастере приложений Win32 нажмите Application Settings.

  6. На странице Application Settings выберите DLL из списка типов приложения и выберите проект Empty из раздела Дополнительных опций. Нажмите Finish, чтобы создать проект.

После того, как вы создаете проект, закрываете Start Page. Visual C++ отображает проект в своем Solution Explorer, с отдельными папками для исходных файлов, заголовочных файлов и других ресурсов проекта.

Перекомпиляция с новыми версиями программного обеспечения Image Acquisition Toolbox

После того, как вы создали адаптер, обычно только необходимо перекомпилировать его для использования с новыми основными версиями программного обеспечения Image Acquisition Toolbox. Средства записи адаптера должны перекомпилировать, когда основное обновление выпущено, такие как Версия 4.0 Image Acquisition Toolbox. Если ваш адаптер работает в одной версии, но не в новой версии тулбокса, попытайтесь перекомпилировать и повторно соединиться, чтобы видеть, решает ли это вопрос.

Незначительные обновления тулбокса обычно не включают изменения в наборе адаптера, таким образом, средства записи адаптера обычно не должны будут перекомпилировать свои адаптеры.

Добавление проекта набора адаптера к решению

Когда вы создаете проект, Microsoft Visual C++ автоматически создает решение, которое содержит ваш проект. Как удобство, в то время как вы разрабатываете свой адаптер, вы можете хотеть добавить проект набора адаптера в свое решение облегчить относиться к файлам набора адаптера. Добавление проекта набора адаптера к вашему решению не влияет на компиляцию или связь вашего DLL адаптера.

Чтобы добавить проект набора адаптера в ваше решение, войдите в меню File> Add> Existing Project. В диалоговом окне Add Existing Project откройте следующий файл проекта,

matlabroot\toolbox\imaq\imaqadaptors\kit\imaqadaptorkit.vcxproj

где matlabroot представляет вашу папку установки MATLAB.

Определение местоположений заголовочного файла

Прежде чем можно будет скомпилировать адаптер, необходимо задать местоположения заголовочных файлов, требуемых набором адаптера и SDK устройства. Для списка заголовочных файлов, требуемых набором адаптера, смотрите Подготовку Среды сборки на Windows Systems. Следующий раздел описывает, как задать эти местоположения заголовочного файла в среде Microsoft Visual C++.

Примечание

Примеры в следующем разделе используют переменные окружения. Для получения дополнительной информации смотрите Используя Переменные окружения.

Определение заголовочных файлов в Microsoft Visual C++

Чтобы задать местоположения заголовочных файлов набора адаптера в Microsoft Visual C++, следуйте этим инструкциям:

  1. Откройте диалоговое окно Property Pages: Projects> Properties.

  2. Expand Configuration Properties и выбирает VC ++ Директории.

    Затем выберите Include Directories и выберите Edit из меню, сопоставленного с той строкой.

  3. Добавьте местоположения заголовочных файлов набора адаптера и заголовочных файлов, требуемых SDK вашего устройства к списку отображенных папок, каждый на отдельной строке.

    $(MATLAB)\toolbox\imaq\imaqadaptors\kit\include
    

    В этом примере $(MATLAB) разыменовывает переменную окружения MATLAB, который установлен в имя вашей папки установки. (См. Используя Переменные окружения для получения дополнительной информации.)

  4. После определения папок заголовочного файла нажать ОК.

Определение библиотек и путей к библиотеке

Прежде чем можно будет создать DLL адаптера, необходимо задать библиотеки, требуемые набором адаптера и SDK устройства. Для списка необходимых библиотек смотрите Подготовку Среды сборки на Windows Systems. Следующие разделы описывают, как задать эти библиотеки и пути к библиотеке в Microsoft Visual C++.

Определение местоположений библиотеки в Microsoft Visual C++

  1. Откройте диалоговое окно Property Pages (если это не уже открыто): Projects> Properties.

  2. Измените Параметр конфигурации (наверху диалогового окна) ко Всем Настройкам.

  3. Расширьте Configuration Properties и затем расширьте Linker. Выберите General и, на этой странице, выберите Additional Library Directories и нажмите Edit из меню, сопоставленного с той строкой.

  4. Добавьте местоположения библиотек набора адаптера и библиотек, требуемых SDK вашего устройства в поле Additional Library Directories. Используйте точку с запятой, чтобы разделить папки.

    Этот пример добавляет эту строку в поле:

    $(MATLAB)\toolbox\imaq\imaqadaptors\kit\lib\<ARCH>\release
    

    В примере $(MATLAB) разыменовывает переменную окружения MATLAB, который установлен в имя вашей папки установки — смотрите Используя Переменные окружения. Необходимо заменить <ARCH> на имя архитектурно-зависимой папки, такой как win64.

Определение имен библиотеки в Microsoft Visual C++

Чтобы задать имена библиотеки, выполните эту процедуру.

  1. Откройте диалоговое окно Property Pages (если у вас уже нет его открытым): Projects> Properties.

  2. В диалоговом окне Property Pages для вашего проекта расширьте Configuration Properties и затем расширьте Linker. Выберите Входную категорию и, на этой странице, выберите Additional Dependencies и нажмите Edit.

  3. Задайте имена библиотек набора адаптера и имена библиотек, требуемых SDK вашего устройства. Используйте пробелы, чтобы разделить имена библиотек. Следующее показывает библиотеки набора адаптера.

    imaqmex.lib 
    
  4. Нажать ОК.

Конфигурирование других параметров проекта

В дополнение к определению заголовочных файлов и библиотек, проект адаптера требует этих дополнительных настроек. Если вы не устанавливаете эти параметры, ваш адаптер может столкнуться с проблемами во время выполнения.

  1. Добавьте пустой исходный файл в свой проект. Чтобы установить значения этих дополнительных свойств, ваш проект должен содержать файлы. Чтобы создать исходный файл, выполните эту процедуру:

    1. Выберите File> New> File.

    2. В диалоговом окне New File выберите Visual C ++.

    3. Выберите C ++ File (.cpp) и затем нажмите Open.

    4. Добавьте новый исходный файл в свой проект. Из меню File выберите Move Source1.cpp в и выберите имя своего проекта. Примите имя файла по умолчанию на данный момент; можно всегда изменить его позже.

  2. Откройте Страницы свойств для своего проекта путем щелчка правой кнопкой по проекту в Проводнике Решения и выбора Properties, или путем выбора Properties из Меню проектов.

  3. В диалоговом окне Property Pages откройте C/C++ и выберите Code Generation. На странице Code Generation, установленной следующие значения.

    Поле

    Установка

    Включите исключения C++

    Да с функциями Экстерна К (/EHs)

    Библиотека времени выполнения

    Многопоточный DLL (/MD)

    Проверка защиты

    Отключите проверку защиты (/GS-)

  4. В диалоговом окне Property Pages, под C/C++, выбирают Language. На странице Language, набор поле Enable Run-time Type Information к Да (/GR).

  5. В диалоговом окне Property Pages, под C/C++, выбирают Command Line и задают следующий флаг компилятора.

    /EHs
    

    Нажмите ОК, чтобы закрыть диалоговое окно Property Pages.

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