Подготовка среды сборки включает определение заголовочных файлов и библиотек, что необходимо создать адаптер. Для знакомых с их средой IDE, смотрите, что следующие разделы для списков их требуемых включают файлы и библиотеки. Этот раздел также описывает, как создать переменную окружения, которую можно использовать, чтобы задать папку установки MATLAB®. Заголовочный файл и пути к библиотеке используют эту переменную окружения. Для подробных инструкций относительно подготовки вашей среды сборки в Microsoft® Visual C ++® среда разработки, смотрите Создание Проекта Адаптера Используя Microsoft Visual C++.
Пользователи Microsoft Visual C++ должны иметь в виду, что существуют определенные параметры проекта, которые они должны установить. Смотрите Конфигурирование Других Параметров Проекта.
В следующей таблице перечислены местоположения заголовочных файлов и библиотек, что необходимо создать адаптер.
Необходимо также задать местоположение заголовочных файлов и библиотек, требуемых устройством. Считайте документацию SDK своего устройства, чтобы получить эту информацию.
Заголовочный файл и библиотеки | Местоположение |
|---|---|
Заголовочные файлы набора адаптера | |
Библиотека механизма Image Acquisition Toolbox™ |
|
Для получения информации об определении переменных окружения смотрите Используя Переменные окружения.)
Чтобы изучить, как задать заголовочные файлы в Microsoft Visual C++, смотрите Заголовочные файлы Определения в Microsoft Visual C++.
Чтобы изучить, как задать библиотеки в Microsoft Visual C++, смотрите Библиотеки Определения и Пути к библиотеке.
Чтобы создать переменную окружения в вашей системе Windows®, которая задает вашу папку установки MATLAB, выполните эту процедуру:
Откройте диалоговое окно System Properties в Панели управления Windows Control Panel: Control Panel > System and Security > System.
В Системной Панели управления кликните по Усовершенствованной опции параметров настройки системы.
На Вкладке "Дополнительно" нажмите кнопку Environment Variables.
В диалоговом окне Environment Variables, в разделе Пользовательских переменных, нажимают New, чтобы создать переменную окружения.
В диалоговом окне New User Variable присвойте имя 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++.
На начальной странице нажмите New Project.... Visual Studio открывает диалоговое окно New Project. Можно также открыть это диалоговое окно в меню File> New> Project.
В диалоговом окне New Project:
Расширьте Visual C++, под Установленными Шаблонами, в случае необходимости, и выберите Win32.
Выберите Win32 Project.
Введите имя, которое вы хотите присвоить проекту в Поле имени и задать, где вы хотите определить местоположение проекта в поле Location.
Можно дать проекту адаптера любое имя. Соглашение, используемое тулбоксом, состоит в том, чтобы назвать адаптеры можно следующим образом:
vendor_name + imaq
где вы заменяете вектор символов vendor_name с чем-то соответствующим вашему проекту.
Нажать ОК. Visual C++ открывает Мастер приложений Win32.
В Мастере приложений Win32 нажмите Application Settings.
На странице Application Settings выберите DLL из списка типов приложения и выберите проект Empty из раздела Дополнительных опций. Нажмите Finish, чтобы создать проект.
После того, как вы создаете проект, закрываете Start Page. Visual C++ отображает проект в своем Solution Explorer, с отдельными папками для исходных файлов, заголовочных файлов и других ресурсов проекта.
После того, как вы создали адаптер, обычно только необходимо перекомпилировать его для использования с новыми основными версиями программного обеспечения 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++, следуйте этим инструкциям:
Откройте диалоговое окно Property Pages: Projects> Properties.
Expand Configuration Properties и выбирает VC ++ Директории.
Затем выберите Include Directories и выберите Edit из меню, сопоставленного с той строкой.
Добавьте местоположения заголовочных файлов набора адаптера и заголовочных файлов, требуемых SDK вашего устройства к списку отображенных папок, каждый на отдельной линии.
$(MATLAB)\toolbox\imaq\imaqadaptors\kit\include
В этом примере, $(MATLAB) разыменовывает переменную окружения MATLAB, который установлен в имя вашей папки установки. (См. Используя Переменные окружения для получения дополнительной информации.)
После определения папок заголовочного файла нажать ОК.
Прежде чем можно будет создать DLL адаптера, необходимо задать библиотеки, требуемые набором адаптера и SDK устройства. Для списка необходимых библиотек смотрите Подготовку Среды сборки на Windows Systems. Следующие разделы описывают, как задать эти библиотеки и пути к библиотеке в Microsoft Visual C++.
Откройте диалоговое окно Property Pages (если это не уже открыто): Projects> Properties.
Измените Параметр конфигурации (наверху диалогового окна) ко Всем Настройкам.
Расширьте Configuration Properties и затем расширьте Linker. Выберите General и, на этой странице, выберите Additional Library Directories и нажмите Edit в меню, сопоставленном с той строкой.
Добавьте местоположения библиотек набора адаптера и библиотек, требуемых SDK вашего устройства в поле Additional Library Directories. Используйте точку с запятой, чтобы разделить папки.
Этот пример добавляет эту линию на поле:
$(MATLAB)\toolbox\imaq\imaqadaptors\kit\lib\<ARCH>\release
В примере, $(MATLAB) разыменовывает переменную окружения MATLAB, который установлен в имя вашей папки установки — смотрите Используя Переменные окружения. Необходимо заменить <ARCH> с именем архитектурно-зависимой папки, такой как win64.
Чтобы задать имена библиотеки, выполните эту процедуру.
Откройте диалоговое окно Property Pages (если у вас уже нет его открытым): Projects> Properties.
В диалоговом окне Property Pages для вашего проекта расширьте Configuration Properties и затем расширьте Linker. Выберите Входную категорию и, на этой странице, выберите Additional Dependencies и нажмите Edit.
Задайте имена библиотек набора адаптера и имена библиотек, требуемых SDK вашего устройства. Используйте пробелы, чтобы разделить имена библиотек. Следующее показывает библиотеки набора адаптера.
imaqmex.lib
Нажать ОК.
В дополнение к определению заголовочных файлов и библиотек, проект адаптера требует этих дополнительных настроек. Если вы не устанавливаете эти параметры, ваш адаптер может столкнуться с проблемами во время выполнения.
Добавьте пустой исходный файл в свой проект. Чтобы установить значения этих дополнительных свойств, ваш проект должен содержать файлы. Чтобы создать исходный файл, выполните эту процедуру:
Выберите File> New> File.
В диалоговом окне New File выберите Visual C ++.
Выберите C ++ File (.cpp) и затем нажмите Open.
Добавьте новый исходный файл в свой проект. В меню File выберите Move Source1.cpp в и выберите имя своего проекта. Примите имя файла по умолчанию на данный момент; можно всегда изменить его позже.
Откройте Страницы свойств для своего проекта путем щелчка правой кнопкой по проекту в Проводнике Решения и выбора Properties, или путем выбора Properties из Меню проектов.
В диалоговом окне Property Pages откройте C/C++ и выберите Code Generation. На странице Code Generation, установленной следующие значения.
Поле | Установка |
|---|---|
Включите исключения C++ | Да с функциями Экстерна К (/EHs) |
Библиотека времени выполнения | Многопоточный DLL (/MD) |
Проверка защиты | Отключите проверку защиты (/GS-) |
В диалоговом окне Property Pages, под C/C++, выбирают Language. На странице Language, набор поле Enable Run-time Type Information к Да (/GR).
В диалоговом окне Property Pages, под C/C++, выбирают Command Line и задают следующий флаг компилятора.
/EHs
Нажмите ОК, чтобы закрыть диалоговое окно Property Pages.