Loader for glTF2.0 files written in kotlin. The project uses Klaxon to parse JSON.
gltf-loader loads glTF file.
- loads .gltf files
- loads .glb files
- loads external .bin files
- decodes base64 embedded buffers
- decodes base64 embedded textures
- minimal validation
val gltf = GltfAsset.fromFile("pathTo/asset.gltf")
val glb = GltfAsset.fromFile("pathTo/asset.glb")Note that file extension is important because gltf-loader selects the proper loader implementation depending on the file extension
gltf-loader provides a higher level representation of the data present in the gltf files. The main difference is
that objects hold actual references to other objects rather than the indices of these object in an centralized array.
Those shared objects all have an index field which is their position in the array centralizing the resources of the
same type. It makes navigation easier without loosing the benefit of having those resources centralized.
In the following example buffer is an object and not an index :
val buffer = asset.bufferViews[0].bufferBut you can retrieve its index :
val bufferIndex = buffer.indexAttributes with a defined range of allowed values are replaced by enums holding the original constant values.
val componentTypeConstantValue = ComponentType.FLOAT.code // 5126 After loading the file gltf-loader performs a minimal validation pass on loaded data. For now it only checks that data respect the json schemas.
Buffer data is loaded alongside the json descriptor so clients don't have to. This includes buffers contained in external .bin files and embedded base64 buffers. Base 64 buffers are decoded when the file is loaded.
Embedded base64 image data is decoded too but external image files are not loaded.
In gltf files, as stated in gltf's specification : any node can define a local space transformation either by supplying a matrix property, or any of translation, rotation, and scale properties. When a node contains a matrix, gltf-loader will automatically extract the translation, scale and rotation properties even if their are not defined in the original file.
- Extensions support (pbrSpecularGlossiness)