pygltflib 1.3

Python library for reading, writing and managing 3D objects in the Khronos Group gltf and gltf2 formats. Python 3.6+

pygltflib

Python library for reading, writing and handling GLTF files. Python3.6+

Requirements

• Python 3.6
• dataclasses
• dataclasses-json
• numpy

About

This is an unofficial library that tracks the official file format for GLTF2.

The library was initially built to load and save simple meshes but support for the entire spec, including materials and animations is pretty good. Check the table below for an idea of which sample models validate.

Questions? Contributions? Bug reports? Open an issue on the gitlab page for the project.

Contributors:

• Luke Miller
• Sebastian Höffner

Changelog:

• 1.0 initial release.
• 1.2 better json support, remove numpy requirement, suppress infer warning, basic default methods.
• 1.3 basic support for reading binary GLTF (.glb) files.

Roadmap:

• Add helper functions for creating meshes
• Full support for binary GLTF (.glb) files.

Install

PIP

Method 1

pip install pygltflib

Method 2

python -m pip install pygltflib

Method 3

py -3 -m pip install pygltflib

Source

git clone https://gitlab.com/dodgyville/pygltflib

Usage

Note: These examples use the official sample models provided by Kronos at:

https://github.com/KhronosGroup/glTF-Sample-Models

Creating

>>> from pygltflib import GLTF2, Scene
>>> gltf = GLTF2()
>>> gltf.scene # no scene set by default
>>> len(gltf.scenes)
0

>>> scene = Scene()
>>> gltf.scenes.append(scene)
>>> len(gltf.scenes)
1

Loading and saving

pygltflib can load json-based .GLTF files and binary .GLB files, based on the file extension. Support for saving files loaded from .GLB is currently not fully implemented.

GLTF files

>>> from pygltflib import GLTF2
>>> filename = "glTF-Sample-Models/2.0/AnimatedCube/glTF/AnimatedCube.gltf"
>>> gltf = GLTF2().load(filename)
>>> gltf.scene
0

>>> gltf.scenes
[Scene(name='', nodes=[0])]

>>> gltf.nodes[0]
Node(mesh=0, name='AnimatedCube', rotation=[0.0, -1.0, 0.0, 0.0])

>>> gltf.nodes[0].name
'AnimatedCube'

>>> gltf.meshes[0].primitives[0].attributes
Attributes(NORMAL=4, POSITION=None, TANGENT=5, TEXCOORD_0=6)

>>> filename2 = "test.gltf"
>>> gltf = GLTF2().save(filename2)

GLB files

>>> from pygltflib import GLTF2
>>> glb_filename = "glTF-Sample-Models/2.0/Box/glTF-Binary/Box.glb"
>>> glb = GLTF2().load(glb_filename)
>>> glb.scene
0

>>> glb.scenes
[Scene(name='', nodes=[0])]

>>> glb.nodes[0]
Node(mesh=0, name='AnimatedCube', rotation=[0.0, -1.0, 0.0, 0.0])

>>> glb.nodes[0].name
'AnimatedCube'

>>> glb.meshes[0].primitives[0].attributes
Attributes(NORMAL=4, POSITION=None, TANGENT=5, TEXCOORD_0=6)

Running the tests

Status of gltf-validator

Using sample models loaded and then saved using this library, here are validator reports (blank is untested).

Model	Validator Status
2CylinderEngine	passes
AlphaBlendModeTest	passes
AnimatedCube	passes
AnimatedMorphCube	passes
AnimatedMorphSphere	passes
AnimatedTriangle	passes
Avocado	passes
BarramundiFish	passes
BoomBox	passes
BoomBoxWithAxes	passes
Box	passes
BoxAnimated	passes
BoxInterleaved	passes
BoxTextured	passes
BoxTexturedNonPowerOfTwo	passes
BoxVertexColors	passes
BrainStem	passes
Buggy	passes
Cameras	passes
CesiumMan	passes
CesiumMilkTruck	passes
Corset	passes
Cube	passes
DamagedHelmet	passes
Duck	passes
FlightHelmet	passes
GearboxAssy	passes
Lantern	passes
MetalRoughSpheres	passes
Monster	passes
MultiUVTest	passes
NormalTangentMirrorTest	passes
NormalTangentTest	passes
OrientationTest	passes
ReciprocatingSaw	passes
RiggedFigure	passes
RiggedSimple	passes
SciFiHelmet	passes
SimpleMeshes	passes
SimpleMorph	passes
SimpleSparseAccessor	passes
SpecGlossVsMetalRough	passes
Sponza	passes
Suzanne	passes
TextureCoordinateTest	passes
TextureSettingsTest	passes
TextureTransformTest	passes
Triangle	passes
TriangleWithoutIndices	passes
TwoSidedPlane	passes
VC	passes
VertexColorTest	passes
WaterBottle	passes

unittests

python -m tests