简介
本指南可帮助您快速掌握搭载 Windows 10 的电脑上的英特尔® 实感™ SDK。 为 Windows 10 开发桌面应用与为 Windows 8.1 开发桌面应用没多大区别。 因此,如果您曾经在 Windows 8.1 中创建英特尔® 实感™ 应用,那您一定会轻车熟路。 另一方面,如果您并不熟悉英特尔实感 SDK,而且使用运行 Windows 10 的电脑,那么本材料是您为桌面项目创建英特尔实感应用的绝佳入门指南。
目标受众
对于使用 Visual Studio 2015 集成开发环境 (IDE) 将英特尔实感 SDK 整合在 Windows 10 桌面应用中,本文提供了入门级信息。 掌握 Visual Studio 和 C# 编程语言的基本知识,以及使用 SDK 所附带的示例应用实际操作过英特尔® 实感™ 摄像头都会有所帮助。
安装 Visual Studio 2015
假如您要从“空白” Windows 10 电脑(即未安装开发工具或 SDK)开始,请先下载并安装 Visual Studio 2015。 Visual Studio Community 的免费版本可从以下网址下载:https://www.visualstudio.com/zh-cn/downloads/download-visual-studio-vs.aspx。 Visual Studio 2015 的完整安装说明可从以下网址获取: https://msdn.microsoft.com/zh-cn/library/e2h7fzkw.aspx。
对于本文所讨论的代码示例而言,“典型设置”安装程序选项可完全满足需求,但如欲充分利用 Visual Studio 2015 的所有全新特性与功能,您可能需要选择自定义设置,并精选出您想要安装的自定义组件、第三方 SDK 和扩展。 若您决定使用典型设置,您可在未来需要时直接安装任意自定义组件。
下载并安装英特尔® 实感™ 软件组件
在 Windows 10 系统上配置英特尔实感应用软件组件的第一步是下载并安装英特尔® 实感™ 景深摄像头管理器 (DCM),它是摄像头驱动程序软件。 DCM 有两种,一种用于前置F200 摄像头,一种用于后置R200 摄像头。
从以下网址为您的摄像头下载相应的 DCM:https://software.intel.com/zh-cn/intel-realsense-sdk/download。 然后,从以下网址下载面向 Windows 的英特尔实感 SDK:https://registrationcenter.intel.com/zh/forms/?productid=2383。
安装完毕 DCM 和 SDK 后,请重启您的电脑。 如欲确保摄像头正常运行,请运行英特尔实感 SDK Sample Browser 中提供的其中一个示例。 点击屏幕左下侧的 Windows 10 Start 按钮。 选择 All Apps,之后滚动至 Intel® RealSense™ SDK文件夹(图 1)。
Image may be NSFW.
Clik here to view.
图 1. Windows* 开始菜单。
创建 Visual Studio 2015 项目
实施以下步骤创建 Visual Studio 2015 项目。 在我们的示例中,我们将该项目称为 CameraStreams:
- 启动 Visual Studio 2015。
- 从菜单选项中选择 File, New, Project…。
- 在 New Project 屏幕中,展开 Templates 并选择 Visual C#。
- 选择 WPF Application。
- 指定新项目的位置和名称。 在本示例中,它的位置是 C:\MyRealSenseProjects,而且我们将为它命名为 CameraStreams。
- 点击 OK创建新项目。
您的 Visual Studio 项目看上去应与图 2 相似。
Image may be NSFW.
Clik here to view.
图 2. Visual Studio* 2015 中的 CameraStreams 项目。
向英特尔® 实感™ SDK 库添加参考
用 C# 创建英特尔实感应用需要两种动态链接库 (DLL):
- libpxcclr.cs.dll – 托管 C# 接口 DLL
- libpxccpp2c.dll – 非托管 C++ P/Invoke DLL
可使用不同的方法为您的项目添加所需的英特尔实感 SDK 库 (DLL) 支持。 在该项目中,对于位于项目之外、在 SDK 安装过程中创建的文件夹内的所需 DLL,我们将创建相关参考。
先右击 Solution Explorer 中的 CameraStreams项目,选择 Properties,再选择 Build Events(图 3)。
Image may be NSFW.
Clik here to view.
图 3. 构建 Events 屏幕。
在后期构建事件命令行中,输入以下语句:
if "$(Platform)" == "x86" ( copy /y "$(RSSDK_DIR)\bin\win32\libpxccpp2c.dll""$(TargetDir)" ) else ( copy /y "$(RSSDK_DIR)\bin\x64\libpxccpp2c.dll""$(TargetDir)" )
在构建流程结束时,以上语句会命令 Visual Studio 根据指定的目标平台,从 SDK 安装路径中的相应 x86 或 x64 文件夹中将非托管 DLL (libpxccpp2c.dll) 复制到该项目的输出目录中。
然后,从左侧菜单中选择 Build。 在本示例中,我们将创建 64 位应用,请从下拉列表中选择面向该目标平台的 x64。 此时您若构建项目,您会发现 libpxccpp2c.dll 位于输出文件夹中,例如:
C:\MyRealSenseProjects\CameraStreams\CameraStreams\bin\Debug
下一步是向托管 DLL (libpxcclr.cs.dll) 中添加参考。 如英特尔® 实感™ SDK 2015 R4 文档所述,众所周知,Visual Studio 不能同时处理 32 位和 64 位参考,所以该应用必须在构建不同的目标之前明确修改该参考。
- 在 Solution Explorer 中,展开 CameraStreams,再右击 References。
- 选择 Add References…,然后点击屏幕右下方的 Browse…按钮。
- 导航至含有 64 位 DLL 的文件夹,这取决于安装期间所选的 RSSDK 文件夹的目的地。 图 4 显示了本示例所使用的 libpxcclr.cs.dll的 x64 build 安装路径。
- 点击 OK 按钮将该参考添加至该项目。
Image may be NSFW.
Clik here to view.
图 4. Reference Manager 屏幕
现在,您便拥有了一个为开始构建英特尔实感 SDK 支持的 Windows 桌面应用而创建的基本框架。 如欲了解更多关于 C#/WPF 中应用开发的信息,请阅读 Microsoft* 文章: 演示:WPF 入门。
尝试使用一些入门级代码示例
IDZ 上提供了大量代码示例和资源,展示了如何使用上文所述的基本框架进行构建。 这里有几篇入门文章和代码示例可供您下载,以助您快速入门。
英特尔® 实感™ 摄像头 F200
若您是针对 F200 前置摄像头进行开发,请阅读今年年初 IDZ 上刊登的演示文章:使用英特尔® 实感™ SDK 在 C#/WPF 中创建 “Hello World” 项目。 虽然该文章中提供的示例代码表面上是针对 Visual Studio 2013,但您会发现,您无需更改便可在 Windows 10 上使用 Visual Studio 2015 构建应用。
英特尔® 实感™ 摄像头 R200
若您是针对 R200 后置摄像头进行开发,您可在 IDZ 上下载一些代码示例,以便从基本摄像头数据流、面部追踪和增强摄影(重调深度焦距)开始入手。
关于作者
Bryan Brown 是英特尔开发人员关系部门的软件应用工程师。