glTF extensions can be present in glTF files, and will be present in the parsed JSON. glTF extensions can supported by applications by inspecting the extensions
fields inside glTF objects, and it is up to each application to handle or ignore them.
loaders.gl aims to provide support for glTF extensions that can be handled completely or partially during loading, and article describes glTF extensions that are fully or partially processed by the @loaders.gl/gltf
classes.
Note that many glTF extensions affect aspects that are firmly outside of the scope of loaders.gl (e.g. rendering), and no attempt is made to process those extensions in loaders.gl.
Extension | Description |
---|---|
KHR_draco_mesh_compression | |
KHR_lights_punctual | |
KHR_materials_unlit | |
KHR_texture_basisu | |
EXT_meshopt_compression | Decompresses meshopt-compressed geometries |
Supports compression of mesh attributes (geometry).
The GLTFLoader
by default fully decompresses draco compressed geometries, removing the draco extension and the compressed data from the parsed glTF data structure.
Specification: KHR_draco_mesh_compression.
Parsing Support:
decompress: true
options to the GLTFParser
any decompressed by the GLTFParser
.Encoding Support:
GLTFBuilder
.Supports specification of point light sources and addition of such sources to the scenegraph node.
Specification: KHR_lights_punctual
Parsing Support:
KHR_lights_punctual
extension will get a light
field with value containing a light definition object with properties defining the light (this object will be resolved by index from the global KHR_lights_punctual
extension object's lights
array) .KHR_lights_punctual
extensions will be removed from all nodes.KHR_lights_punctual
extension (including its light list)) will be removed.Encoding Support:
Specifies that a material should not be affected by light. Useful for pre-lit materials (e.g. photogrammetry).
This extension adds the ability to specify textures using KTX v2 images with Basis Universal supercompression.
The GLTFLoader
by default fully decompresses compressed textures, removing the basisu extension and the compressed data from the parsed glTF data structure.
This extension provides a support for the meshopt binary geometry data compression format that is tailored to the common types of data seen in glTF buffers.
The GLTFLoader
by default fully decompresses meshopt compressed geometries, removing the meshopt extension and the compressed data from the parsed glTF data structure.