https://github.com/nfrechette/acl-gltf
Animation Compression Library glTF toolkit
https://github.com/nfrechette/acl-gltf
animation-3d animation-compression c-plus-plus compression cpp gltf
Last synced: 10 months ago
JSON representation
Animation Compression Library glTF toolkit
- Host: GitHub
- URL: https://github.com/nfrechette/acl-gltf
- Owner: nfrechette
- License: mit
- Created: 2019-08-16T14:10:41.000Z (almost 7 years ago)
- Default Branch: develop
- Last Pushed: 2020-04-02T19:23:36.000Z (about 6 years ago)
- Last Synced: 2025-04-11T03:33:00.507Z (about 1 year ago)
- Topics: animation-3d, animation-compression, c-plus-plus, compression, cpp, gltf
- Language: C++
- Homepage:
- Size: 93.8 KB
- Stars: 18
- Watchers: 3
- Forks: 6
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://cla-assistant.io/nfrechette/acl-gltf)
[](https://ci.appveyor.com/project/nfrechette/acl-gltf)
[](https://travis-ci.com/nfrechette/acl-gltf)
[](https://sonarcloud.io/dashboard?id=nfrechette_acl-gltf)
[](https://raw.githubusercontent.com/nfrechette/acl-gltf/master/LICENSE)
[](https://discord.gg/UERt4bS)
# Animation Compression Library glTF toolkit
This toolkit contains a tool to convert compress and decompress glTF animations by using the [Animation Compression Library](https://github.com/nfrechette/acl). In time, a proper glTF extension will hopefully be standardized.
For the time being, `acl-gltf` only serves as a reference and toy. Sadly, glTF is not a suitable file format for a pipeline. It is not possible for a standalone tool to safely process a glTF file without knowing about and supporting every possible extension used in the wild. As such, `acl-gltf` leaves a lot of unused metadata in its output and no raw data is freed to ensure maximum safety.
===> **THIS TOOL IS NOT SUITABLE FOR PRODUCTION USE!** <===
Until an ACL extension is standardized, it is recommended to use this tool as inspiration to see how to compress glTF animations. As such, it is merely a proof of concept.
## Supported platforms
* Windows (VS2015, VS2017, VS2019) x86 and x64
* Windows VS2019 with clang8 x86 and x64
* Linux (gcc5, gcc6, gcc7, gcc8, gcc9) x86 and x64
* Linux (clang4, clang5, clang6, clang7, clang8, clang9) x86 and x64
* OS X (Xcode 8.3, 9.4, 10.3) x86 and x64
* OS X (Xcode 11.2) x64
The above supported platform list is only what is tested every release but if it compiles, it should work just fine.
Runtime decompression can be implemented in C++ with [ACL](https://github.com/nfrechette/acl) and in Javascript with [acl-js](https://github.com/nfrechette/acl-js).
## Getting started
The toolkit executables currently need to be built by hand with CMake. However, if you wish to run the unit tests or to contribute to acl-gltf head on over to the [development setup](./docs/development_setup.md) section in order to setup your environment and make sure to check out the [contributing guidelines](CONTRIBUTING.md).
## External dependencies
You don't need anything else to get started: everything is self contained.
See [here](./external) for details.
## License, copyright, and code of conduct
This project uses the [MIT license](LICENSE).
Copyright (c) 2019 Nicholas Frechette & contributors
Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.