Awesome
<p align="center"> <img alt="" src="assetkit.png" width="550" /> </p> <br> <p align="center"> <a href="https://github.com/recp/AssetKit/actions/workflows/c-cpp.yml"> <img src="https://github.com/recp/AssetKit/actions/workflows/c-cpp.yml/badge.svg" alt="C/C++ CI"> </a> <a href="https://github.com/recp/AssetKit/actions/workflows/cmake.yml"> <img src="https://github.com/recp/AssetKit/actions/workflows/cmake.yml/badge.svg" alt="CMake"> </a> <a href="https://github.com/recp/AssetKit/actions/workflows/msbuild.yml"> <img src="https://github.com/recp/AssetKit/actions/workflows/msbuild.yml/badge.svg" alt="MSBuild"> </a> <a href="https://www.codacy.com/app/recp/assetkit?utm_source=github.com&utm_medium=referral&utm_content=recp/assetkit&utm_campaign=Badge_Grade"> <img src="https://api.codacy.com/project/badge/Grade/6edde2ba446148759437eb0148c799b6" alt="Codacy Badge"/> </a> <a href="https://coveralls.io/github/recp/assetkit?branch=master"> <img src="https://coveralls.io/repos/github/recp/assetkit/badge.svg?branch=master" alt="Coverage Status"/> </a> <img src="https://img.shields.io/badge/glTF-2%2E0-green.svg?style=flat" alt="glTF Badge"> <br /><br /> <a href="https://patreon.com/recp"> <img src="https://img.shields.io/badge/Patreon-Become a patron-orange.svg" alt="Patreon: Become a patron"> </a> <a href="#sponsors"> <img src="https://opencollective.com/assetkit/sponsors/badge.svg" alt="Sponsors on Open Collective"/> </a> <a href="#backers"> <img src="https://opencollective.com/assetkit/backers/badge.svg" alt="Backers on Open Collective"/> </a> </p> <br> <p align="center"> Brand-new modern 3D asset importer, exporter library. This library will include common 3D utils funcs. It is written with C99 but C++ wrappers or other language bindings can be written in the future.This library will try to full support COLLADA specs and glTF specs, plus well-known other 3D formats e.g .obj, .stl, .ply...
๐ There is also an optional renderer library called Graphics Kernel (Realtime Rendering) and rays (Path/Ray Tracer) which can render AssetKit contents. You can see how to load AssetKit to Graphics Kernel in AssetKit-GL repo. Both renderers and documentation with samples will be updated regularly...
</p>๐ Documentation (In Progress)
Almost all functions (inline versions) and parameters will be documented inside the corresponding headers. <br /> Complete documentation: http://assetkit.readthedocs.io
๐ช Supported Formats
- Asset Exchange (todo) http://github.com/AssetExchange/spec
- COLLADA 1.4 and COLLADA 1.4.1
- COLLADA 1.5
- glTF 2.0 (Embedded or Separated (.gltf), Binary (.glb), Extensions...)
- Wavefront Obj (.obj + .mtl)
- STL (ASCII, Binary)
- PLY (ASCII, Binary)
- 3MF (in progress)
- FBX (License?, probably need to download FBX SDK externally)
- USD and friends (License?)
- Alembic (License?)
- Draco
- X3D
- in progress for next...
- Exporter
๐ Features
- Single interface for glTF 2.0 (with extensions), COLLADA 1.4/1.4.1/1.5, Wavefront Obj and others...
- Very very small and very fast library
- Javascript-like API to get URL or ID
obj = ak_getObjectById(doc, objectId)
... - Options to Generate Mesh Normals (Default: enabled)
- Option to Triangulate Polygons (Default: enabled)
- Option to change Coordinate System (Default: enabled)
- Option to calculate Bounding Boxes (Default: enabled)
- Unique and Flexible Coordinate System
- Support multiple coordinate system
- Can convert any coordinate system to another with adding transform or with changing transform, vertex data...
- Unique and Flexible Memory Management System
- Hierarchical unique memory management
- When a node is freed then all sub memories will be freed
- COLLADA's sid and ID values are mapped to memory nodes itself to reduce memory size and make it easy to manage things.
- Allow attach ID, sid or user data to a memory node
- Hierarchical unique memory management
- Object-based Asset support; resolve asset element for any element
- Bugfix some DAE files
- Will be optimized to be fastest, smallest and most flexible, extendible Asset loader.
- Uses mmap to load files, you can disable this if needed
- Documentation
- Cmake support
- Tests
๐จ Build
CMake (All platforms)
$ mkdir build
$ cd build
$ cmake .. # [Optional] -DAK_SHARED=ON
$ make
$ sudo make install # [Optional]
Cmake options with Defaults:
option(AK_SHARED "Shared build" ON)
option(AK_STATIC "Static build" OFF)
option(AK_USE_TEST "Enable Tests" OFF) #ย for make check - make test
Use with your CMake project
- Example:
cmake_minimum_required(VERSION 3.8.2)
project(<Your Project Name>)
add_executable(${PROJECT_NAME} src/main.c)
target_link_libraries(${LIBRARY_NAME} PRIVATE assetkit)
add_subdirectory(external/assetkit/)
# or you can use find_package() to configure assetkit
Unix (Autotools)
Step 1: First you should build dependencies, do this only once:
$ sh ./build-deps.sh
Step 2: Build, Test and Install AssetKit
$ sh autogen.sh
$ ./configure
$ make
$ make check
$ [sudo] make install
Step 3: Change install name if required, after make finished make automaticall runs sh ./post-build.sh
script. It changes install names. You may want to edit build scripts and post-build.sh
script if you want to build AssetKit with existing libraries. Default behavior is that AssetKit will look up sub libraries inside .libs
folder, if you only need to change .libs
name then change it in post-build.sh
script file.
Windows (MSBuild)
Windows related build files, project files are located in win
folder, make sure you are inside assetkit/win
folder. Code Analysis are enabled to it may take awhile to build
git
and python
commands should be installed/accessible.
$ cd win
$ .\build.bat
$ย msbuild assetkit.vcxproj /p:Configuration=Release
if msbuild
won't work correctly then try to build with devenv
:
$ devenv assetkit.sln /Build Release
Contributors
This project exists thanks to all the people who contribute. [Contribute]. <a href="https://github.com/recp/assetkit/graphs/contributors"><img src="https://opencollective.com/assetkit/contributors.svg?width=890&button=false" /></a>
Backers
Thank you to all our backers! ๐ [Become a backer]
<a href="https://opencollective.com/assetkit#backers" target="_blank"><img src="https://opencollective.com/assetkit/backers.svg?width=890"></a>
Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]
<a href="https://opencollective.com/assetkit/sponsor/0/website" target="_blank"><img src="https://opencollective.com/assetkit/sponsor/0/avatar.svg"></a> <a href="https://opencollective.com/assetkit/sponsor/1/website" target="_blank"><img src="https://opencollective.com/assetkit/sponsor/1/avatar.svg"></a> <a href="https://opencollective.com/assetkit/sponsor/2/website" target="_blank"><img src="https://opencollective.com/assetkit/sponsor/2/avatar.svg"></a> <a href="https://opencollective.com/assetkit/sponsor/3/website" target="_blank"><img src="https://opencollective.com/assetkit/sponsor/3/avatar.svg"></a> <a href="https://opencollective.com/assetkit/sponsor/4/website" target="_blank"><img src="https://opencollective.com/assetkit/sponsor/4/avatar.svg"></a> <a href="https://opencollective.com/assetkit/sponsor/5/website" target="_blank"><img src="https://opencollective.com/assetkit/sponsor/5/avatar.svg"></a> <a href="https://opencollective.com/assetkit/sponsor/6/website" target="_blank"><img src="https://opencollective.com/assetkit/sponsor/6/avatar.svg"></a> <a href="https://opencollective.com/assetkit/sponsor/7/website" target="_blank"><img src="https://opencollective.com/assetkit/sponsor/7/avatar.svg"></a> <a href="https://opencollective.com/assetkit/sponsor/8/website" target="_blank"><img src="https://opencollective.com/assetkit/sponsor/8/avatar.svg"></a> <a href="https://opencollective.com/assetkit/sponsor/9/website" target="_blank"><img src="https://opencollective.com/assetkit/sponsor/9/avatar.svg"></a>
Trademarks
glTF and COLLADA and their logos are trademarks of Khronos Group.