libktx-rs

Rust中读取、写入和转码 Khronos Textures (KTX1和KTX2) 的库。

此仓库包含对 KhronosGroup/KTX-Software 的高层Rust绑定和底层FFI.

结构

• libktx-rs 包含高层Rust包装器。
• libktx-rs-sys 包含底层C FFI，并从源代码构建 KTX-Software。
• libktx-rs-macros 包含测试辅助工具。

文档

请访问 https://docs.rs/libktx-rs 查看高层API的最新文档，以及 https://docs.rs/libktx-rs-sys 查看底层FFI。

构建和功能

克隆此根仓库和所有git子模块 (git clone --recursive https://github.com/UberLambda/libktx-rs)，然后运行 cargo build。

图像写入

要启用KTX图像写入支持（默认功能集已启用），请启用 libktx-rs/write 功能。

基于图像的测试

要启用图像加载测试，请使用git LFS支持 克隆 libktx-rs-sys/KTX-Software 子模块，然后启用 libktx-rs-sys/test-images 功能。

构建时rust-bindgen

为了在构建脚本中（而不是使用预先生成的绑定）使用rust-bindgen生成绑定，启用libktx-rs-sys/run-bindgen功能。

仅文档

要完全跳过构建或链接KTX-Software，启用libktx-rs-sys/docs-only功能。

许可证

此Rust包装程序以及KTX-Software库本身均采用Apache-2.0许可证。

Linux和GCC

请注意，库链接到libstdc++，该库采用LGPL附带“运行时库异常”。

许可证例外

如果启用了ETC解码器，构建将包含爱立信的专有源代码文件 - KTX-Software/lib/etcdec.cxx！
构建此文件是可选的，默认情况下是禁用的。使用nonfree-etc-unpack构建libktx-rs-sys以启用此功能，如果您同意许可证条款。

有关更多信息，请参阅原始LICENSE。