OpenNI2编程简要说明.PDFVIP

OpenNI2 编程简要说明 目录 OpenNI2 编程简要说明 1 OpenNI 类 2 设备的基础访问 2 视频流(Video Streams)的基础访问 3 设备的事件驱动访问 3 错误信息 3 版本信息 4 设备类（Device Class） 4 基本操作 4 Device::open() 4 Device::close() 4 Device::isValid() 4 从设备中获取信息 5 特殊设备功能 5 对齐（Registration） 5 帧同步（FramSync) 5 通用功能（General Capabilities) 6 文件设备（File Devices） 6 记录器类（Recorder Class） 6 重放控制类(PlaybackControl Class) 6 视频流类(VideoStream Class) 7 视频流的基础功能 7 创建和初始化视频流 7 基于轮询的数据读取 8 基于事件的数据读取 8 获取关于视频流的信息 8 视野（Field of View） 8 配置视频流 8 视频帧引用类（VideoFrameRef Class ） 9 访问帧数据 9 OpenNI 2.0 API （应用程序编程接口）提供了访问兼容OpenNI2 标准的深度传感器的方法。使用该API 接 口使得一个应用程序能够初始化传感器并从设备接收深度流(Depth) ，彩色流(RGB)和红外流(IR) ，同时 OpenNI2 还提供了一个统一的接口通过深度传感器创建.oni 记录文件。 获取数据视频流 （Streams ）主要使用下面4 个类： 1) openni::OpenNI –提供一个静态的API 入口点。同时提供访问设备的途径，设备相关的事件，版本及错 误信息，被用来初始OpenNI2 环境并建立与Device 的连接。 2) openni::Device –提供传感器设备连接的接口。在被创建前要求 OpenNI 先进行初始化。Devices 提供访 问Streams 的途径。 3) openni::VideoStream –从一个特定的Device 中获取数据流，可用来获取VideoFrameRefs 。 4) openni::VideoFrameRef –从特定的Stream 获取一帧数据。 除了这些主要的类以外，还有许多类和结构体用来保持一些特殊类型的数据，这些类主要服务于封装数据， 在其他主要类的章节都有所提及。 配置类： openni::DeviceInfo - 此类记录了设备的所有配置，包括设备名，URI，USB VID/PID 描述符和供应商。 openni::SensorInfo - 此类存储了传感器的所有配置，OpenNI2 兼容设备一般有3 个传感器（IR,RGB，DEPTH）。 RGB 并非必须。 openni::VideoMode - 此类存储了分辨率，帧率和像素格式。用于视频流的设置和查看设置，由视频帧引用 查看这些设置，由传感器信息提供一个视频模式的列表。 openni::CameraSettings – 对彩色摄像头进行曝光，增益，白平衡等调节 （需要厂商固件支持） 数据存储类/结构体： openni::Version – 结构体，存储当前OpenNI 版本 openni::RGB888Pixel - 结构体，存储彩色像素值。 openni::DepthPixel - 结构体，存储深度像素值。 openni::Grayscale16Pixel - 结构体，存储IR 像素值。 openni::Array T - OpenNI 提供的简单数组类。包含图像数据。 openni::CoordinateConverter – 深度，彩色，世界坐标系之间的相互转换 open