开始为 Windows 10 桌面应用程序开发 Intel® RealSense™ SDK
本指南将帮助您快速上手在配备 Windows 10 的计算机上使用 Intel® RealSense™ SDK。
引言
本指南将帮助您快速上手在配备 Windows 10 的计算机上使用 Intel® RealSense™ SDK。为 Windows 10 开发桌面应用程序与为 Windows 8.1 开发应用程序差别不大。因此,如果您有在 Windows 8.1 中创建 Intel® RealSense™ 应用程序的经验,其中大部分信息您将已经熟悉。另一方面,如果您是 Intel RealSense SDK 的新手,并且正在使用运行 Windows 10 的计算机,那么本材料将为您开始创建桌面项目的 Intel RealSense 应用程序提供一个良好的开端。
目标读者
本文档提供了关于使用 Visual Studio 2015 集成开发环境 (IDE) 将 Intel RealSense SDK 整合到 Windows 10 桌面应用程序中的入门级信息。对 Visual Studio 和 C# 编程语言的基本熟悉会有所帮助,同时对使用 SDK 附带的示例应用程序进行 Intel® RealSense™ 相机的一些实际操作经验也会有帮助。 Intel® RealSense™ 相机
安装 Visual Studio 2015
假设您从一台“干净”的 Windows 10 计算机开始(即,没有安装开发工具或 SDK),请首先下载并安装 Visual Studio 2015。Visual Studio Community 免费版本可在此处下载: https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx。有关安装 Visual Studio 2015 的完整说明可在此处找到: https://msdn.microsoft.com/en-us/library/e2h7fzkw.aspx。
对于本文档中讨论的代码示例,"典型设置"安装选项即可正常工作;但是,如果您想真正探索 Visual Studio 2015 中所有新功能和能力,您可能希望选择自定义设置,并手动挑选您想要安装的自定义组件、第三方 SDK 和扩展。如果您决定选择典型设置,以后在准备探索自定义组件时,随时都可以安装它们。
下载并安装 Intel® RealSense™ 软件组件
在 Windows 10 系统上配置 Intel RealSense 应用程序软件组件的第一步是下载并安装 Intel® RealSense™ 深度摄像头管理器 (DCM),这是摄像头驱动程序软件。DCM 有两种类型,一种用于面向用户的 F200 摄像头,另一种用于面向世界的 R200 摄像头。
请在此处下载适合您摄像头的 DCM: https://software.intel.com/en-us/intel-realsense-sdk/download。接下来,请在此处下载适用于 Windows 的 Intel RealSense SDK: https://registrationcenter.intel.com/en/forms/?productid=2383。
安装完 DCM 和 SDK 后,请重启您的计算机。为了确保摄像头正常运行,请运行 Intel RealSense SDK 示例浏览器中提供的其中一个示例。单击屏幕左下角的 Windows 10 开始按钮。选择所有应用,然后滚动到Intel® RealSense™ SDK 文件夹(图 1)。
创建 Visual Studio 2015 项目
执行以下步骤以创建 Visual Studio 2015 项目。在我们的示例中,我们将项目命名为CameraStreams。
- 启动 Visual Studio 2015。
- 从菜单选项中选择文件、新建、项目…。
- 在“新建项目”屏幕中,展开“模板”并选择Visual C#。
- 选择WPF 应用程序。
- 指定新项目的位置及其名称。在本例中,我们的位置是C:\MyRealSenseProjects,我们将名称命名为CameraStreams。
- 单击确定以创建新项目。
您的 Visual Studio 项目应类似于图 2。
添加对 Intel® RealSense™ SDK 库的引用
使用 C# 创建 Intel RealSense 应用程序需要两个动态链接库 (DLL):
- libpxcclr.cs.dll – 受托管的 C# 接口 DLL
- libpxccpp2c.dll – 不受托管的 C++ P/Invoke DLL
有多种方法可向您的项目添加所需的 Intel RealSense SDK 库 (DLL) 支持。在此项目中,我们将创建对位于项目外部文件夹中的必需 DLL 的引用,这些文件夹是在安装 SDK 时创建的。
首先,在“解决方案资源管理器”中右键单击CameraStreams项目,选择属性,然后选择生成事件(图 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) 从 SDK 安装路径中的相应 x86 或 x64 文件夹复制到项目的输出目录,具体取决于指定的平台。
接下来,从左侧菜单中选择生成。在本例中,我们正在创建一个 64 位应用程序,因此请从下拉列表中为目标平台选择x64。此时,如果您生成项目,您会发现 libpxccpp2c.dll 存在于输出文件夹中,例如
C:\MyRealSenseProjects\CameraStreams\CameraStreams\bin\Debug
下一步是添加对托管 DLL (libpxcclr.cs.dll) 的引用。如Intel® RealSense™ SDK 2015 R4 文档中所述,一个已知的限制是 Visual Studio 不能同时处理 32 位和 64 位引用;因此,应用程序必须在生成不同目标之前显式修改引用。
- 在“解决方案资源管理器”中,展开CameraStreams,然后右键单击引用。
- 选择添加引用…,然后单击屏幕右下角的浏览…按钮。
- 导航到包含 64 位 DLL 的文件夹,该文件夹将取决于安装期间选择的 RSSDK 文件夹的目标位置。图 4 展示了本示例中使用的 libpxcclr.cs.dll x64 版本的安装路径。
- 单击“确定”按钮以将引用添加到项目。
现在,您已经创建了基本框架,可以开始构建支持 Intel RealSense SDK 的 Windows 桌面应用程序。有关 C#/WPF 应用程序开发的更多信息,请参阅 Microsoft* 文章: 演练: WPF 入门。
尝试一些入门级代码示例
IDZ 上提供了许多代码示例和资源,演示了如何基于上述基本框架进行构建。这里有一些入门文章和您可以下载的代码示例,以帮助您开始。
Intel® RealSense™ 摄像头 F200
如果您正在为 F200 前置摄像头开发,请阅读今年早些时候在 IDZ 上发布的演练文章: 使用 Intel® RealSense™ SDK 在 C#/WPF 中创建“Hello World”项目。尽管本文配套的示例代码名义上以 Visual Studio 2013 为目标,但您会发现您可以在 Windows 10 上的 Visual Studio 2015 中构建该应用程序而无需修改。
Intel® RealSense™ 摄像头 R200
如果您正在为 R200 后置摄像头开发,以下是 IDZ 上提供的一些代码示例,您可以下载这些示例以开始进行基本摄像头流、面部跟踪和增强摄影(景深重对焦)。
- Intel® RealSense™ 深度摄像头代码示例 – R200 摄像头流
- Intel® RealSense™ 深度摄像头 R200 代码示例 – 面部跟踪
- Intel® RealSense™ 深度摄像头 R200 代码示例 – 景深重对焦
关于作者
Bryan Brown 是 Intel 开发者关系部门的软件应用程序工程师。