bvh_anim

一个用于加载包含骨骼动画数据的.bvh文件的Rust库。

⚠⚠注意：此库目前为alpha质量软件。⚠⚠

基本用法

要开始使用，请将以下内容添加到您的Cargo.toml

[dependencies]
bvh_anim = "0.2"

然后，您可以在Rust文件中使用use bvh_anim::*;语句导入库。下面是一个简单的示例：

use bvh_anim;
use std::fs::File;

let bvh_file = File::open("./path/to/anim.bvh")?;
let bvh = bvh_anim::load(BufReader::new(bvh_file))?;

for joint in bvh.joints() {
    println!("{:#?}", joint);
}

println!("Frame time: {:?}", bvh.frame_time());

for frame in bvh.frames() {
    println!("{:?}", frame);
}

let mut out_file = File::create("./out.bvh");
bvh.write_to(&mut out_file)?;

有关bvh文件格式和此库的更多信息，请参阅docs.rs上的文档。

特性

此包有一个小的ffi模块，允许您从C代码中解析bvh文件。可以使用ffi特性启用ffi模块，您可以在docs.rs上查看它的文档。

此外，可以启用bindings特性，使用cbindgen生成C绑定。绑定头文件将被写入到指定的$CARGO_TARGET_DIR，如果没有指定，则写入到$CARGO_MANIFEST_DIR/target/include/bvh_anim/bvh_anim.h。

贡献

此库欢迎开源贡献，包括拉取请求和错误报告（包括功能请求）。

此库的目标成为Rust生态系统中的主要bvh解析器，并旨在正确解析各种bvh文件。如果您有一个无法正确解析的文件，请报告错误。解析应在失败时始终返回错误，而不会恐慌。

许可证

版权所有 © 2019 George Burton

本授权声明允许任何获得本软件及其相关文档文件（以下简称“软件”）副本的个人免费使用该软件，不受限制地处理软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本，并允许将软件提供给他人以便他们也能这样做，但须遵守以下条件：

上述版权声明和本授权声明应包含在软件的所有副本或主要部分中。

软件按“原样”提供，不提供任何形式的保证，无论是明示的、暗示的，还是关于适销性、特定用途适用性或非侵权的保证。在任何情况下，作者或版权所有者不对任何索赔、损害或其他责任负责，无论该责任是基于合同、侵权或其他方式，无论该责任源于、产生于或与软件或其使用或其他方式相关。