Настройка окружения сборки включает в себя указание заголовочных файлов и библиотек, которые необходимо создать для адаптера. Для тех, кто знаком с их окружением IDE, смотрите следующие разделы для списков этих необходимых, включая файлы и библиотеки. В этом разделе также описывается, как создать переменную окружения, которую можно использовать для задания MATLAB® папка установки. Заголовочный файл и пути к библиотеке используют эту переменную окружения. Подробные инструкции по настройке окружения сборки в Microsoft® Визуальный C++® среду разработки см. Создание проекта адаптера с использованием Microsoft Visual C++.
Примечание
Пользователи Microsoft Visual C++ должны знать, что есть определенные параметры проекта, которые они должны задать. См. «Конфигурирование других параметров проекта».
В следующей таблице перечислены местоположения заголовочных файлов и библиотек, которые необходимо создать для адаптера.
Примечание
Необходимо также указать местоположение заголовочных файлов и библиотек, необходимых для устройства. Ознакомьтесь с документацией SDK вашего устройства, чтобы получить эту информацию.
Файл заголовка и библиотеки | Местоположение |
|---|---|
Заголовочные файлы набора адаптеров |
|
Библиотека Image Acquisition Toolbox™ engine |
|
[a] | |
Для получения информации об определении переменных окружения смотрите Использование переменных окружения.)
Чтобы узнать, как задать файлы заголовков в Microsoft Visual C++, смотрите Указание файлов заголовков в Microsoft Visual C++.
Чтобы узнать, как задать библиотеки в Microsoft Visual C++, см. раздел «Задание библиотек и путей к библиотекам».
Как создать переменную окружения в Windows® система, которая задает вашу папку установки MATLAB, выполните следующую процедуру:
Откройте диалоговое окно Свойств системы» на панели управления Windows Control Panel: Control Panel > System and Security > System.
На панели управления системой выберите опцию Дополнительные системные параметры.
На вкладке Дополнительно нажмите кнопку Переменные окружения.
В диалоговом окне Переменные окружения, в разделе Пользовательские переменные, нажмите кнопку Создать, чтобы создать переменную окружения.
В диалоговом окне «Новая пользовательская переменная» присвойте имя MATLAB для переменной и установите значение переменной в путь к папке установки MATLAB. Нажмите кнопку ОК.
Нажмите кнопку ОК в диалоговом окне Переменные окружения (Environment Variables), а затем в диалоговом окне Свойства системы (System Properties).
Примечание
Если Microsoft Visual C++ выполняется при создании этой переменной, ее необходимо перезапустить.
В качестве первого шага к созданию адаптера откройте Microsoft Visual C++ и создайте новый проект.
Примечание
Настоятельно рекомендуется использовать версию Microsoft Visual Studio®. Для получения информации о поддерживаемых версиях см. столбец MATLAB в таблице: https://www.mathworks.com/support/compilers.html.
Настройте все необходимые переменные окружения - см. Использование переменных окружения.
Запустите Microsoft Visual C++.
На начальной странице нажмите Новый проект.... Visual Studio открывает диалоговое окно Нового проекта. Это диалоговое окно можно также открыть из меню File > New > Project.
В диалоговом окне «Новый проект»:
Разверните Visual C++ в разделе Установленные шаблоны (при необходимости) и выберите Win32.
Выберите Win32 Project.
Введите имя, которое необходимо присвоить проекту, в поле Имя и укажите, где следует найти проект в поле Расположение.
Вы можете дать своему проекту адаптера любое имя. Условие, используемое тулбоксом, состоит в том, чтобы называть адаптеры следующим образом:
vendor_name + imaq
где вы заменяете вектор символов vendor_name с чем-то подходящим для вашего проекта.
Нажмите кнопку OK. Visual C++ открывает мастер Win32 приложений.
В мастере Win32 приложения щелкните Настройки приложения.
На странице Настройки приложения выберите DLL из списка типов приложений и выберите Пустой проект в разделе Дополнительные опции. Щелкните Концом, чтобы создать проект.
После создания проекта закройте Start Page. Visual C++ отображает проект в своем Solution Explorer с отдельными папками для исходных файлов, заголовочных файлов и других ресурсов проекта.
После создания адаптера его обычно нужно перекомпилировать только для использования с новыми основными версиями ПО Image Acquisition Toolbox. Адаптер средств записи должен перекомпилироваться при выпуске основного обновления, такого как Image Acquisition Toolbox версии 4.0. Если адаптер работает в одной версии, но не в новой версии тулбокса, попробуйте перекомпилироваться и перекомпилироваться, чтобы увидеть, решает ли это проблему.
Незначительные обновления тулбокса обычно не содержат изменений в наборе адаптеров, поэтому средства записи адаптеров, как правило, не нужно будет перекомпилировать свои адаптеры.
Когда вы создаете проект, Microsoft Visual C++ автоматически создает решение, содержащее ваш проект. Для удобства, в то время как вы разрабатываете свой адаптер, вы, возможно, захотите добавить проект набора адаптеров к своему решению, чтобы облегчить обращение к файлам набора адаптеров. Добавление проекта набора адаптеров к вашему решению не влияет на компиляцию или редактирование DLL адаптера.
Чтобы добавить проект набора адаптеров к своему решению, перейдите в меню File > Add > Existing Project. В диалоговом окне «Добавить существующий проект» откройте следующий файл проекта,
matlabroot\toolbox\imaq\imaqadaptors\kit\imaqadaptorkit.vcxproj
где matlabroot представляет вашу папку установки MATLAB.
Прежде чем вы сможете скомпилировать адаптер, необходимо указать местоположение заголовочных файлов, требуемых комплектом адаптера и SDK вашего устройства. Список файлов заголовков, необходимых для набора адаптеров, см. в разделе Настройка окружении сборки в системах Windows. В следующем разделе описывается, как задать эти расположения заголовочных файлов в среде Microsoft Visual C++.
Примечание
В примерах, приведенных в следующем разделе, используются переменные окружения. Для получения дополнительной информации смотрите Использование Окружения переменных.
Чтобы указать местоположение заголовочных файлов набора адаптеров в Microsoft Visual C++, следуйте следующим инструкциям:
Откройте диалоговое окно «Страницы свойств»: Projects > Properties.
Разверните раздел Свойства и выберите VC++ Directories.
Затем выберите Include Directories и выберите Edit из меню, связанного с этой строкой.
Добавьте местоположения заголовочных файлов набора адаптеров и заголовочных файлов, необходимых для SDK вашего устройства, в список отображаемых папок, каждая из которых находится в отдельной линии.
$(MATLAB)\toolbox\imaq\imaqadaptors\kit\include
В этом примере $(MATLAB) dereferences переменная окружения MATLAB, для которого задано имя папки установки. (Для получения дополнительной информации см. раздел «Использование переменных окружения»).
После определения папок файла заголовка нажмите кнопку ОК.
Прежде чем вы сможете создать библиотеку DLL адаптера, необходимо указать библиотеки, необходимые для набора адаптеров и SDK вашего устройства. Список необходимых библиотек см. в разделе Настройка окружении сборки в системах Windows. В следующих разделах описывается, как задать эти библиотеки и пути к библиотекам в Microsoft Visual C++.
Откройте диалоговое окно «Страницы свойств» (если оно еще не открыто): Projects > Properties.
Измените настройку Строения (в верхней части диалогового окна) на «Все Строения».
Разверните Configuration Properties и затем разверните Linker. Выберите General и на этой странице выберите Additional Library Directories и нажатие кнопки Edit из меню, связанного с этой строкой.
Добавьте местоположения библиотек набора адаптеров и библиотек, необходимых для пакета SDK вашего устройства, в поле Дополнительные директории библиотек. Используйте точку с запятой, чтобы разделить папки.
Этот пример добавляет эту линию в поле:
$(MATLAB)\toolbox\imaq\imaqadaptors\kit\lib\<ARCH>\release
В примере $(MATLAB) dereferences переменная окружения MATLAB, для которого задано имя папки установки - см. Использование переменных окружения. Вы должны заменить <ARCH> с именем папки, относящейся к архитектуре, например win64.
Чтобы задать имена библиотек, выполните эту процедуру.
Откройте диалоговое окно «Страницы свойств» (если оно еще не открыто): Projects > Properties.
В диалоговом окне «Страницы свойств» для проекта разверните Configuration Properties и затем разверните Linker. Выберите категорию входа и на этой странице выберите Additional Dependencies и нажмите Edit.
Укажите имена библиотек набора адаптеров и имена библиотек, требуемых для пакета SDK вашего устройства. Используйте пространства для разделения имен библиотек. Ниже показаны библиотеки набора адаптеров.
imaqmex.lib
Нажмите кнопку ОК.
В дополнение к указанию заголовочных файлов и библиотек, проект адаптера требует этих дополнительных настроек. Если эти параметры не заданы, адаптер может столкнуться с проблемами во время выполнения.
Добавьте пустой исходный файл к своему проекту. Чтобы задать значения этих дополнительных свойств, ваш проект должен содержать файлы. Чтобы создать исходный файл, выполните следующую процедуру:
Выберите File > New > File.
В диалоговом окне «Новый файл» выберите Visual C++.
Выберите C++ File (.cpp) и нажмите Open.
Добавьте новый исходный файл к своему проекту. В меню Файл выберите Переместить Source1.cpp в и выберите имя своего проекта. Примите имя файла по умолчанию на данный момент; вы всегда можете изменить его позже.
Откройте страницы свойств проекта, щелкнув правой кнопкой мыши по проекту в обозревателе решений и выбрав Свойства, или выбрав Свойства в меню Проект.
В диалоговом окне «Страницы свойств» откройте C/C + + и выберите Code Generation. На странице Генерация кода установите следующие значения.
Область | Настройка |
|---|---|
Включить исключения C++ | Да с функциями Extern C (/EHs) |
Библиотека во время выполнения | Многопоточная DLL (/MD) |
Проверка безопасности | Отключить проверку безопасности (/GS-) |
В диалоговом окне «Страницы свойств» в разделе «C/C + +» выберите «Язык». На странице Language установите в поле Enable Run-Time Type Information значение Yes (/GR).
В диалоговом окне Property Pages в разделе C/C + + выберите Командная Строка и укажите следующий флаг компилятора.
/EHs
Нажмите кнопку ОК, чтобы закрыть диалоговое окно «Страницы свойств».
