glam 和 nalgebra 集成

leaprs 包含可选的 glam 和 nalgebra 集成。

它们是两个流行的线性代数库。它们都广泛使用，这些功能可以帮助与使用这些包的生态系统集成。glam 由 Bevy 使用，而 nalgebra 由 Fyrox 使用。

glam

cargobuild --featuresglam

use leaprs::*;
use glam::{Vec3, Quat};

let mut c = Connection::create(ConnectionConfig::default()).unwrap();
c.open().unwrap();
for _ in 0..10 {
    if let Ok(msg) = c.poll(1000) {
        match msg.event() {
            EventRef::Tracking(e) => {
                for hand in e.hands() {
                    let position: Vec3 = hand.palm().position().into();
                    let orientation: Quat = hand.palm().orientation().into();
                }
            },
            _ => {}
        }
    }
}

nalgebra

cargobuild --featuresnalgebra

use leaprs::*;
use nalgebra::{Vector3, UnitQuaternion};

let mut c = Connection::create(ConnectionConfig::default()).unwrap();
c.open().unwrap();
for _ in 0..10 {
    if let Ok(msg) = c.poll(1000) {
        match msg.event() {
            EventRef::Tracking(e) => {
                for hand in e.hands() {
                    let position: Vector3<f32> = hand.palm().position().into();
                    let orientation: UnitQuaternion<f32> = hand.palm().orientation().into();
                }
            },
            _ => {}
        }
    }
}

使用先前 SDK 版本

禁用 geminy 功能可以使构建适用于先前 SDK 代（Orion）的应用程序。在 Cargo.toml 中

[dependencies = { version = "*", default-features = false }]

您还需要将 LEAPSDK_LIB_PATH 指向具有 Orion 版本的 SDK。

许可证

根据您的选择，许可协议为 Apache 许可证 2.0 版本或 MIT 许可证。

此许可证仅覆盖 leaprs 包装器，不包括底层 LeapC 库。

实现

枚举安全性是通过 num_enum 提供的。

位标志是用 bitflags 包装的。

大多数结构都是围绕它们的 C 对应物简单包装。大多数情况下，C 结构是包装器的唯一成员，除非需要外部分配（当向 LeapC 提供预分配的数组时）。访问器随后以一致的方式公开与这些结构相关联的所有函数和成员。

测试

测试需要Leap软件正在运行，并且有一个设备连接。