#texture #bindings #image #graphics #ktx #api-bindings

libktx-rs

Reading, writing and transcoding of Khronos Textures (KTX1 and KTX2)

6 releases

0.3.3 Sep 11, 2021
0.3.2 Aug 5, 2021
0.2.4 Jun 21, 2021
0.1.0 Jun 13, 2021

#114 in #texture

31 downloads per month
Used in hotham

Apache-2.0

13MB
181K SLoC

C++ 112K SLoC // 0.1% comments C 44K SLoC // 0.3% comments JavaScript 10K SLoC // 0.3% comments Bitbake 6K SLoC Rust 4.5K SLoC // 0.0% comments Python 3K SLoC // 0.4% comments Perl 769 SLoC // 0.2% comments Shell 581 SLoC // 0.3% comments

libktx-rs

crates.io docs.rs license CI status

A library for reading, writing and transcoding Khronos Textures (KTX1 and KTX2) in Rust.

This repository contains both high-level Rust bindings and low-level FFI to KhronosGroup/KTX-Software.

Structure

Docs

See https://docs.rs/libktx-rs for the latest documentation of the high-level API, and https://docs.rs/libktx-rs-sys for the low-level FFI.

Building and features

Clone this root repository and all git submodule (git clone --recursive https://github.com/UberLambda/libktx-rs), then run cargo build.

Image writing

To enable KTX image writing support (which is already enabled in the default feature set), enable the libktx-rs/write feature.

Image-based tests

To enable image loading tests, clone the libktx-rs-sys/KTX-Software submodule with git LFS support, then enable the libktx-rs-sys/test-images feature.

rust-bindgen at build time

To have rust-bindgen generate bindings in the build script (instead of using the pre-generated ones), enable the libktx-rs-sys/run-bindgen feature.

Docs-only

To skip building or linking KTX-Software altogether, enable the libktx-rs-sys/docs-only feature.

License

This Rust wrapper, and the KTX-Software library itself, are both licensed under the Apache-2.0 license.

Linux and GCC

Note that the library links to libstdc++, which is licensed under LGPL with the "Runtime Library Exception".

License exception

If the ETC decoder is enabled, the build will contain a proprietary source code file by Ericsson - KTX-Software/lib/etcdec.cxx!
Building this file is optional, and it is disabled by default. Build libktx-rs-sys with the nonfree-etc-unpack to enable this feature if you agree with the terms of the license.

See the original LICENSE for more information.

Dependencies