Настройка среды сборки включает в себя указание файлов заголовков и библиотек, необходимых для создания адаптера. Для тех, кто знаком с их средой IDE, см. следующие разделы, в которых перечислены необходимые файлы и библиотеки. В этом разделе также описывается создание переменной среды, которую можно использовать для задания папки установки MATLAB ®. Пути к заголовкам и библиотекам используют эту переменную среды. Подробные инструкции по настройке среды сборки в среде разработки Microsoft ® Visual C++ см. в разделе Создание проекта адаптера с помощью Microsoft Visual C++.
Примечание
Пользователи Microsoft Visual C++ должны знать, что существуют определенные параметры проекта, которые они должны задать. См. раздел Настройка других параметров проекта.
В следующей таблице перечислены расположения файлов заголовков и библиотек, необходимых для создания адаптера.
Примечание
Необходимо также указать расположение заголовочных файлов и библиотек, необходимых устройству. Для получения этой информации ознакомьтесь с документацией по SDK вашего устройства.
Заголовочные файлы и библиотеки | Местоположение |
|---|---|
Файлы заголовков набора адаптеров |
|
Библиотека ядра Toolbox™ получения изображений |
|
[a] | |
Сведения об определении переменных среды см. в разделе Использование переменных среды.)
Сведения о задании заголовочных файлов в Microsoft Visual C++ см. в разделе Указание заголовочных файлов в Microsoft Visual C++.
Сведения о задании библиотек в Microsoft Visual C++ см. в разделе Задание библиотек и путей к библиотекам.
Чтобы создать переменную среды в системе Windows ®, определяющую папку установки MATLAB, выполните следующие действия.
Откройте диалоговое окно «Свойства системы» на панели управления Windows: «Панель управления» > «Система и безопасность» > «Система».
На панели управления системой выберите параметр Дополнительные параметры системы.
На вкладке Дополнительно нажмите кнопку Переменные среды.
В диалоговом окне «Переменные среды» в разделе «Пользовательские переменные» нажмите кнопку «Создать» для создания переменной среды.
В диалоговом окне «Новая пользовательская переменная» присвойте имя MATLAB к переменной и установите значение переменной в путь к папке установки MATLAB. Нажмите кнопку ОК.
Нажмите кнопку ОК в диалоговом окне Переменные среды, а затем в диалоговом окне Свойства системы.
Примечание
Если при создании этой переменной работает Microsoft Visual C++, ее необходимо перезапустить.
В качестве первого шага к созданию адаптера откройте Microsoft Visual C++ и создайте новый проект.
Примечание
Настоятельно рекомендуется использовать версию Microsoft Visual Studio ®. Сведения о поддерживаемых версиях см. в столбце MATLAB таблицы https://www.mathworks.com/support/compilers.html.
Настройте все требуемые переменные среды - см. Использование переменных среды.
Запустите Microsoft Visual C++.
На начальной странице нажмите Создать проект.... Visual Studio открывает диалоговое окно «Новый проект». Это диалоговое окно также можно открыть в меню «Файл» > «Создать» > «Проект».
В диалоговом окне «Новый проект»:
Разверните Visual C++ в разделе Установленные шаблоны (при необходимости) и выберите Win32.
Выберите «Win32 проект».
Введите имя, которое требуется назначить проекту, в поле «Имя» и укажите местоположение проекта в поле «Местоположение».
Проект адаптера можно назвать любым именем. Соглашение, используемое панелью инструментов, заключается в именовании адаптеров следующим образом:
vendor_name + imaq
где вы заменяете вектор символов vendor_name с чем-то соответствующим вашему проекту.
Нажать OK. Visual C++ открывает Прикладного Волшебника Win32.
В Прикладном Волшебнике Win32 нажмите Application Settings.
На странице Настройки приложения выберите DLL из списка типов приложений и выберите Пустой проект в разделе Дополнительные параметры. Нажмите кнопку «Готово», чтобы создать проект.
После создания проекта закройте начальную страницу. Visual C++ отображает проект в обозревателе решений с отдельными папками для исходных файлов, файлов заголовков и других ресурсов проекта.
После создания адаптера его обычно требуется перекомпилировать только для использования с новыми основными версиями программного обеспечения Image Acquisition Toolbox. Устройства записи адаптеров должны перекомпилироваться при выпуске основного обновления, например, панели инструментов получения изображений версии 4.0. Если адаптер работает в одной версии, но не в новой версии панели инструментов, попробуйте перекомпилировать и повторно установить связь, чтобы проверить, устраняет ли это проблему.
Незначительные обновления панели инструментов обычно не включают изменения набора адаптеров, поэтому составителям адаптеров, как правило, не нужно будет перекомпилировать их адаптеры.
При создании проекта Microsoft Visual C++ автоматически создает решение, содержащее проект. Для удобства во время разработки адаптера можно добавить проект набора адаптеров в решение, чтобы упростить обращение к файлам набора адаптеров. Добавление проекта набора адаптеров в решение не влияет на компиляцию или связь DLL адаптера.
Чтобы добавить проект набора адаптеров в решение, перейдите в меню Файл > Добавить > Существующий проект. В диалоговом окне «Добавить существующий проект» откройте следующий файл проекта:
matlabroot\toolbox\imaq\imaqadaptors\kit\imaqadaptorkit.vcxproj
где matlabroot представляет папку установки MATLAB.
Перед компиляцией адаптера необходимо указать расположение заголовочных файлов, необходимых для набора адаптеров и SDK устройства. Список файлов заголовков, необходимых для набора адаптеров, см. в разделе Настройка среды сборки в системах Windows. В следующем разделе описывается, как указать эти расположения заголовочных файлов в среде Microsoft Visual C++.
Примечание
В примерах, приведенных в следующем разделе, используются переменные среды. Дополнительные сведения см. в разделе Использование переменных среды.
Чтобы указать расположение файлов заголовков набора адаптеров в Microsoft Visual C++, выполните следующие инструкции:
Откройте диалоговое окно «Страницы свойств»: «Проекты» > «Свойства».
Разверните «Свойства конфигурации» и выберите «Каталоги VC++».
Затем выберите Включить каталоги и выберите Изменить в меню, связанном с этой строкой.
Добавьте расположение файлов заголовков набора адаптеров и файлов заголовков, требуемых SDK устройства, в список отображаемых папок, каждая в отдельной строке.
$(MATLAB)\toolbox\imaq\imaqadaptors\kit\include
В этом примере: $(MATLAB) дереференция переменной среды MATLAB, для которого задано имя папки установки. (Дополнительные сведения см. в разделе Использование переменных среды.)
После указания папок заголовочных файлов нажмите кнопку ОК.
Перед созданием библиотеки DLL адаптера необходимо указать библиотеки, необходимые для набора адаптеров и SDK устройства. Список необходимых библиотек см. в разделе Настройка среды построения в системах Windows. В следующих разделах описывается, как указать эти библиотеки и пути к библиотекам в Microsoft Visual C++.
Откройте диалоговое окно «Страницы свойств» (если оно еще не открыто): «Проекты» > «Свойства».
Измените значение параметра «Конфигурация» (в верхней части диалогового окна) на «Все конфигурации».
Разверните «Свойства конфигурации», а затем «Компоновщик». Выберите «Общие» и на этой странице выберите «Дополнительные каталоги библиотек» и нажмите кнопку «Изменить» в меню, связанном с этой строкой.
Добавьте расположения библиотек наборов адаптеров и библиотек, необходимых для SDK устройства, в поле Дополнительные каталоги библиотек. Для разделения папок используйте точку с запятой.
В этом примере к полю добавляется следующая строка:
$(MATLAB)\toolbox\imaq\imaqadaptors\kit\lib\<ARCH>\release
В примере:$(MATLAB) дереференция переменной среды MATLAB, для которого задано имя папки установки - см. Использование переменных среды. Необходимо заменить <ARCH> с именем специфичной для архитектуры папки, например win64.
Чтобы указать имена библиотек, выполните следующие действия.
Откройте диалоговое окно «Страницы свойств» (если оно еще не открыто): «Проекты» > «Свойства».
В диалоговом окне «Страницы свойств» для проекта разверните «Свойства конфигурации», а затем «Компоновщик». Выберите категорию Ввод и на этой странице выберите Дополнительные зависимости и нажмите кнопку Изменить.
Укажите имена библиотек набора адаптеров и библиотек, необходимых для SDK устройства. Используйте пробелы для разделения имен библиотек. Ниже показаны библиотеки наборов адаптеров.
imaqmex.lib
Нажмите кнопку ОК.
В дополнение к заданию файлов заголовков и библиотек для проекта адаптера требуются эти дополнительные настройки. Если эти параметры не заданы, адаптер может столкнуться с проблемами во время выполнения.
Добавьте в проект пустой исходный файл. Чтобы задать значения этих дополнительных свойств, проект должен содержать файлы. Чтобы создать исходный файл, выполните следующие действия.
Выберите меню «Файл» > «Создать» > «Файл».
В диалоговом окне «Новый файл» выберите Visual C++.
Выберите файл C++ (.cpp) и нажмите кнопку Открыть.
Добавьте новый исходный файл в проект. В меню «Файл» выберите «Переместить Source1.cpp в» и выберите имя проекта. Примите имя файла по умолчанию; вы всегда можете изменить его позже.
Откройте страницы свойств проекта, щелкнув правой кнопкой мыши проект в обозревателе решений и выбрав пункт Свойства, или выбрав пункт Свойства в меню Проект.
В диалоговом окне «Страницы свойств» откройте C/C + + и выберите «Создание кода». На странице «Создание кода» задайте следующие значения.
Область | Настройка |
|---|---|
Включить исключения C++ | Да с функциями Extern C (/EH) |
Библиотека времени выполнения | Многопоточная DLL (/MD) |
Проверка безопасности | Отключить проверку безопасности (/GS-) |
В диалоговом окне «Страницы свойств» в группе «C/C + +» выберите «Язык». На странице Language (Язык) установите в поле Enable Run-time Type Information значение Yes (/GR).
В диалоговом окне «Страницы свойств» в разделе «C/C + +» выберите «Командная строка» и укажите следующий флаг компилятора.
/EHs
Нажмите кнопку «ОК», чтобы закрыть диалоговое окно «Страницы свойств».