1.leapmotion之API概述（Javascript文档V3.1）

API概述

Leap Motion系统识别和跟踪手和手指。 该装置以高精度和跟踪帧速率紧密接近地操作，并报告离散位置和运动。

Leap Motion控制器使用光学传感器和红外灯。 传感器沿着y轴指向 - 当控制器处于其标准操作位置时向上 - 并且具有约150度的视场。 Leap Motion控制器的有效范围从设备上方大约25到600毫米（1英寸到2英尺）。

Leap运动控制器的你的手的视图

当控制器具有对象轮廓的清晰，高对比度视图时，检测和跟踪最有效。 Leap Motion软件将其传感器数据与人手的内部模型相结合，以帮助应对具有挑战性的跟踪条件。

坐标系统

Leap Motion系统采用右手笛卡尔坐标系。 原点居中在Leap Motion控制器的顶部。 x和z轴位于水平面中，x轴平行于装置的长边延伸。y轴是垂直的，正值向上增加（与大多数计算机图形坐标系的向下取向相反）。 z轴具有朝向用户增加的正值。

Leap Motion右手坐标系。

Leap Motion API使用以下单位测量物理量：

距离：	毫米
时间：	微秒（除非另有说明）
速度：	毫米/秒
角度：	弧度

运动跟踪数据

由于Leap Motion控制器在其视野中跟踪手和手指，所以它提供作为数据的集合或帧的更新。每个帧表示帧对象包含任何跟踪的手，在某一时刻，详细说明他们的财产。Frame对象基本上是大跃进运动数据模型的根。

手

手模型提供关于所检测的手，手所附着的手臂的身份，位置和其他特性以及与手相关联的手指的列表的信息。

双手由代表手类。

手palmNormal和方向矢量定义的手的方位。

Leap Motion软件使用人手的内部模型来提供预测跟踪，即使当手的部分不可见时。 手模型总是为五个手指提供位置，虽然当手和其所有手指的轮廓清晰可见时，跟踪是最佳的。 软件使用手的可见部分，其内部模型和过去的观察值来计算当前不可见的部分的最可能的位置。注意，通常不能检测到手指褶皱在手上或者与Leap Motion传感器屏蔽的微妙运动。 一个Hand.confidence级表示观测数据如何适合内部模型。

如果多于一个人的手或其他手状物体在视野中​​，则多于两只手可以出现在手的列表中。 但是，我们建议在Leap Motion控制器的视野中最多保留两只手，以获得最佳的运动跟踪质量。

胳膊

一个Hand.arm是骨状物体，提供了一个臂的取向，长度，宽度，和结束点。当肘部不在视野中时，Leap运动控制器基于过去的观察以及典型的人类比例来估计其位置。

五指

Leap Motion控制器提供关于手上每个手指的信息。 如果手指的全部或部分不可见，则基于最近的观察和手的解剖模型来估计手指特性。 手指按类型的名称，即拇指 ，食指 ， 中指 ， 无名指 ， 小指和鉴定。

手指由表示手指类。

手指tipPosition和方向矢量提供一个手指尖端的位置，并且其中一个手指指向大方向。

手指对象提供了骨描述每个解剖手指骨的位置和方向的对象。所有手指包含从基部到尖端排序的四个骨骼。

中间趾骨 近端趾骨 远端指骨 掌骨 0长拇指掌骨

骨骼被识别为：

• 掌骨 - 将手指连接到手腕的手内的骨骼（拇指除外）
• 近端指骨 - 在手指根部的骨骼，连接到手掌
• 中间指骨 - 手指的中间骨，在指尖和基部之间
• 远端指骨 - 指末端的末端骨

拇指的这种模型不完全匹配标准解剖命名系统。 真正的拇指比其他手指具有少一个骨。 然而，为了便于编程，Leap Motion拇指模型包括零长度掌骨，使得拇指在与其他手指相同的索引处具有相同数量的骨。因此，拇指的解剖学掌骨被标记为近侧趾骨，并且解剖近侧趾骨被标记为Leap Motion手指骨模型中的中间骨节。

（由原始图玛丽安娜比利亚雷亚尔 ）。

传感器图像

与计算的跟踪数据一起，您可以从Leap Motion摄像机获取原始传感器图像。

带有重叠校准点的原始传感器图像。

图像数据包含测量的IR亮度值和校正复杂透镜畸变所需的校准数据。 您可以将传感器图像用于增强现实应用，特别是当Leap Motion硬件安装到VR耳机时。