Приступая к разработке приложений Intel® RealSense™ SDK для настольных ПК с Windows* 10

Введение

Это руководство поможет быстро приступить к использованию Intel^® RealSense™ SDKна компьютере под управлением Windows 10. Разработка классических приложений для Windows 10 практически не отличается от разработки для Windows 8.1. Если вы располагаете опытом создания приложений Intel^® RealSense™ в Windows 8.1, то вы уже знаете большую часть информации, изложенной в этой статье. С другой стороны, если вы недавно начали пользоваться Intel RealSense SDK и работаете на компьютере под управлением Windows 10, этот материал поможет быстрее начать работать над созданием классических приложений с Intel RealSense.

Целевая аудитория

Эта статья содержит вводные сведения об внедрении возможностей Intel RealSense SDK в классические приложения Windows 10 с помощью интегрированной среды разработки Visual Studio 2015. Для понимания этой статьи пригодятся базовые навыки работы в Visual Studio и знание языка программирования C#, а также некоторый практический опыт использования камеры Intel^® RealSense™с помощью примеров приложений, входящих в состав SDK.

Установите Visual Studio 2015

Если исходить из того, что вы приступаете к работе с "чистым"компьютером с Windows 10 (т. е. на него не установлены ни среда разработки, ни пакет SDK), то прежде всего следует установить Visual Studio 2015. Бесплатную версию Visual Studio Community можно загрузить здесь: https://www.visualstudio.com/ru-ru/downloads/download-visual-studio-vs.aspx. Полные инструкции по установке Visual Studio 2015 см. здесь: https://msdn.microsoft.com/ru-ru/library/e2h7fzkw.aspx.

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

Загрузите и установите программные компоненты Intel^® RealSense™

Для настройки программных компонентов Intel RealSense на компьютере с Windows 10 необходимо загрузить и установить Intel^® RealSense™ Depth Camera Manager (DCM) — это драйвер камеры. Существует две версии DCM: одна для камеры переднего обзора F200, другая для камеры заднего обзора R200.

Загрузить соответствующий пакет DCM для вашей камеры можно здесь: https://software.intel.com/ru-ru/intel-realsense-sdk/download. Затем загрузите пакет Intel RealSense SDK для Windows: https://registrationcenter.intel.com/ru/forms/?productid=2383.

После установки DCM и SDK перезагрузите компьютер. Чтобы убедиться в правильной работе камеры, запустите один из входящих в пакет примеров в диспетчере примеров Intel RealSense SDK. Нажмите в Windows 10 кнопку "Пуск"в левом нижнем углу экрана. Выберите Все приложенияи найдите папку Intel^®RealSense™ SDK (рис. 1).

Figure 1. Windows* Start Menu.

Рисунок 1.Меню "Пуск"в Windows*

Создание проекта Visual Studio 2015

Для создания проекта Visual Studio 2015 выполните следующие действия.
В нашем примере назовем проект CameraStreams:

Запустите Visual Studio 2015.
Выберите в меню File, New, Project…
На экране New Project разверните Templates и выберите VisualC#.
Выберите WPF Application.
Укажите расположение проекта и его имя. В нашем примере проект будет находиться в папке C:\MyRealSenseProjects, а имя проекта — CameraStreams.
Нажмите кнопку ОК, чтобы создать новый проект.

Проект Visual Studio должен выглядеть так, как показано на рис. 2.

Figure 2. CameraStreams Project in Visual Studio* 2015.

Рисунок 2.Проект CameraStreams в Visual Studio* 2015

Добавление ссылок на библиотеки Intel^® RealSense™ SDK

Для создания приложений Intel RealSense на языке C# требуются две библиотеки динамической компоновки (DLL):

libpxcclr.cs.dll — управляемая DLL-библиотека интерфейса C#;
libpxccpp2c.dll — неуправляемая DLL-библиотека C++ P/Invoke.

Добавить нужные библиотеки Intel RealSense SDK в проект можно разными способами. В этом проекте мы создадим ссылки на нужные DLL-библиотеки, находящиеся в папках вне проекта, созданных при установке SDK.

Щелкните правой кнопкой мыши проект CameraStreamsв обозревателе решений, выберите Properties, затем выберите Build Events (рис. 3).

Figure 3. Build Events screen.

Рисунок 3.Окно "События сборки"

В командной строке событий после сборки введите следующий оператор:

if "$(Platform)" == "x86" ( copy /y "$(RSSDK_DIR)\bin\win32\libpxccpp2c.dll""$(TargetDir)" ) else ( copy /y "$(RSSDK_DIR)\bin\x64\libpxccpp2c.dll""$(TargetDir)" )

В конце процесса сборки показанный выше оператор даст команду Visual Studio на копирование неуправляемой DLL-библиотеки (libpxccpp2c.dll) из соответствующей папки x86 или x64 в пути установки SDK в выходную папку проекта (в зависимости от указанной платформы назначения).

Затем выберите Build в меню слева. В этом примере мы создаем 64-разрядное приложение, поэтому выберите в раскрывающемся списке x64в качестве платформы назначения. Если теперь собрать проект, то библиотека libpxccpp2c.dll появится в выходной папке, например:

C:\MyRealSenseProjects\CameraStreams\CameraStreams\bin\Debug

Теперь нужно добавить ссылку на управляемую DLL-библиотеку (libpxcclr.cs.dll). Согласно документации Intel^® RealSense™ SDK 2015 R4, в Visual Studio есть известное ограничение: одновременная обработка 32-разрядных и 64-разрядных ссылок невозможна, поэтому необходимо явным образом изменить ссылку перед сборкой для другой платформы.

В обозревателе решений разверните CameraStreamsи щелкните правой кнопкой мыши References.
Выберите Add References…, затем нажмите кнопку Browse…в правом нижнем углу экрана.
Перейдите в папку с 64-разрядной библиотекой. Путь к этой папке зависит от того, какая папка RSSDK была выбрана при установке. На рис. 4 показан путь установки к версии x64 библиотеки libpxcclr.cs.dll, использованной в этом примере.
Нажмите кнопку ОК и добавьте ссылку в проект.

Figure 4. Reference Manager screen.

Рисунок 4.Окно диспетчера ссылок

Теперь готова базовая платформа для создания классического приложения для Windows с Intel RealSense SDK. Дополнительные сведения о разработке приложений на C#/WPF см. в следующей статье корпорации Майкрософт*: Руководство: приступая к работе с WPF.

Ознакомьтесь с примерами кода

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

Камера Intel^® RealSense™ F200

Если вы разрабатываете приложение для камеры переднего обзора F200, прочтите статью, опубликованную ранее в этом году на портале IDZ: Использование Intel^® RealSense™ SDK для создания проекта "Hello World"на C#/WPF. Пример кода, прилагаемый к этой статье, предназначен для Visual Studio 2013, но вы увидите, что можно будет без каких-либо изменений собрать приложение в Visual Studio 2015 под управлением Windows 10.

Камера Intel^® RealSense™ R200

Если вы разрабатываете приложение для камеры заднего обзора R200, то можно загрузить с портала IDZ примеры кода для работы с различными возможностями этой камеры: передача изображения, отслеживание лица, фотографирование с поддержкой глубины (изменение фокусировки по глубине):