LeapMotion开发（五）-- Hand模块下的所有Methods用法和说明（下篇）（C++SDK）

官方C++ SDK介绍地址：

https://developer.leapmotion.com/documentation/cpp/api/Leap.Hand.html#cppclass_leap_1_1_hand_1aa2c9cca797fde17bf7371451a297e608

 

本文是就着英文版官方说明给出了翻译以及自己的理解，Hand模块总共分为了两块，这里为下篇。

 

目录概览：

 

·        pinchDistance()const

·        pinchStrength()const

·        pointable(int32_tid) const

·        pointables()const

·        rotationAngle(constFrame &sinceFrame) const

·        rotationAngle(constFrame &sinceFrame, const Vector &axis) const

·        rotationAxis(constFrame &sinceFrame) const

·        rotationMatrix(constFrame &sinceFrame) const

·        rotationProbability(constFrame &sinceFrame) const

·        scaleFactor(constFrame &sinceFrame) const

·        scaleProbability(constFrame &sinceFrame) const

·        sphereCenter()const

·        sphereRadius()const

·        stabilizedPalmPosition()const

·        timeVisible()const

·        toString() const

·        translation(constFrame &sinceFrame) const

·        translationProbability(constFrame &sinceFrame) const

·        wristPosition()const

 

 

详细解释：

 

 

float pinchDistance() const

大拇指和食指的距离。单位：毫米。

Since

3.0

 

float pinchStrength() const

废弃！

用 pinchDistance() 替代

Since

2.0

 

Pointable pointable(int32_t id) const

返回Hand对应ID的Pointable对象

Leap::PointableknownPointable = hand.pointable(pointableID);

Since

1.0

 

PointableList pointables() const

返回Potintable组成的一个列表（其实就是五根手指组成的）.

// hand is a Leap::Hand object

Leap::PointableListpointables = hand.pointables();// Both fingers and tools

Leap::FingerListfingers = hand.fingers();

Since

1.0

 

float rotationAngle(const Frame & sinceFrame) const

返回和startFrame那一帧相比，手的相对旋转

float rotationOfHand = hand.rotationAngle(startFrame);

 

 

float rotationAngle(const Frame & sinceFrame,const Vector & axis) const

返回和sinceFrame那一帧相比，绕axis的相对旋转的角度

float rotationAroundYAxis = hand.rotationAngle(startFrame,Leap::Vector::yAxis());

 

Vector rotationAxis(const Frame & sinceFrame) const

返回当前和sinceFrame那一帧相比，启发式（heuristically）确定的绕着旋转的轴的Vector

Leap::VectoraxisOfHandRotation = hand.rotationAxis(startFrame);

 

Matrix rotationMatrix(const Frame & sinceFrame) const

返回和SinceFrame相比的变换矩阵，Matrix类型。

Leap::MatrixhandRotationTransform = hand.rotationMatrix(startFrame);

 

 

float rotationProbability(const Frame & sinceFrame) const

与sinceFrame相比，当前帧为旋转移动成的可能性，返回一个0-1的float。

float rotationIntentFactor = hand.rotationProbability(startFrame);

 

 

 

float scaleFactor(const Frame & sinceFrame) const

返回当前和指定帧的缩放比例

float handScaleMotion = hand.scaleFactor(startFrame);

 

 

float scaleProbability(const Frame & sinceFrame) const

返回两帧之间是缩放运动的可能性，数值为0-1的float。

float scaleIntentFactor = hand.scaleProbability(startFrame);

 

Vector sphereCenter() const

返回手掌抓取球的模型中球的球心位置坐标。

Leap::VectorsphereCenter= hand.sphereCenter();

Since

1.0

 

 

float sphereRadius() const

返回上述模型中的球的半径（就是假装握着球，这球有多大，233），单位为毫米

float sphereDiameter = 2 * hand.sphereRadius();

Since

1.0

 

 

Vector stabilizedPalmPosition() const

经过平滑处理以及一系列其他处理之后的手掌的位置坐标，返回值为Vector

//可靠性和手运动的速度有关，如果速度过快可能会有滞后感

Leap::VectorfilteredHandPosition = hand.stabilizedPalmPosition();

Since

1.0

 

 

float timeVisible() const

返回这个hand被追踪的时间，单位是秒

float lifetimeOfThisHandObject = hand.timeVisible();

Since

1.0

 

 

std::string toString() const

把hand的信息转化为方便阅读与显示的string类型。

Since

1.0

 

Vector translation(const Frame & sinceFrame) const

返回前后两帧平移运动位置变化的Vector。

Leap::VectorlinearHandMovement = hand.translation(startFrame);

 

float translationProbability(const Frame & sinceFrame) const

返回前后两帧为平移运动的可能性质，大小为0-1的float。

float translationIntentFactor = hand.translationProbability(startFrame);

 

 

Vector wristPosition() const

返回腕部以毫米为单位的坐标的Vector。

Since

2.0.3

 

 

补充两点：

 

Public Static Functions

const Hand & invalid()

返回invalid的Hand

if (hand !=Leap::Hand::invalid()){

    //Process handdata...

}

Since

1.0

Friends

friendstd::ostream & operator<<

输出方便阅读的Hand对象

std::cout << hand << std::endl;

Since

1.0

 

 

终于把Hand部分翻译完啦，还是有不少值得关注的方便的功能函数的

 

起飞~最后祝大家编程愉快： ）