Python library for reading, writing and managing 3D objects in the Khronos Group gltf and gltf2 formats. Python 3.7+
Project description
# pygltflib
Python library for reading, writing and handling GLTF files. Python3.7+
## Requirements
* Python 3.7
* numpy
## About
The library tracks the [official file format](https://github.com/KhronosGroup/glTF/blob/master/specification/2.0/README.md) for GLTF2.
The library was initially built to load and save simple meshes, support for materials and animations is experimental.
Check the table below for an idea of which sample models validate.
Roadmap:
* Finishing building out schemas
* Validate sample models
* Add helper functions
## Install
pip install pygltflib
or
python3.7 -m pip install pygltflib
## Usage
Note: These examples use the official [sample models](https://github.com/KhronosGroup/glTF-Sample-Models) provided by Kronos at:
https://github.com/KhronosGroup/glTF-Sample-Models
```python3.7
>>> from pygltflib import GLTF2
>>> filename = "glTF-Sample-Models/2.0/AnimatedCube/glTF/AnimatedCube.gltf"
>>> gltf = GLTF2().load(filename)
>>> gltf
>>> 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)
```
## 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 | errors: 67 |
| AlphaBlendModeTest | errors: 8 |
| AnimatedCube | passes |
| AnimatedMorphCube | |
| AnimatedMorphSphere | |
| AnimatedTriangle | |
| Avocado | |
| BarramundiFish | |
| BoomBox | |
| BoomBoxWithAxes | |
| Box | passes |
| BoxAnimated | passes |
| BoxInterleaved | |
| BoxTextured | |
| BoxTexturedNonPowerOfTwo | |
| BoxVertexColors | |
| BrainStem | |
| Buggy | |
| Cameras | |
| CesiumMan | |
| CesiumMilkTruck | |
| Corset | |
| Cube | errors: 2 |
| DamagedHelmet | |
| Duck | |
| FlightHelmet | |
| GearboxAssy | |
| Lantern | |
| MetalRoughSpheres | |
| Monster | errors: 2 |
| MultiUVTest | |
| NormalTangentMirrorTest | |
| NormalTangentTest | |
| OrientationTest | |
| ReciprocatingSaw | |
| RiggedFigure | |
| RiggedSimple | |
| SciFiHelmet | |
| SimpleMeshes | passes |
| SimpleMorph | |
| SimpleSparseAccessor | |
| SpecGlossVsMetalRough | |
| Sponza | |
| Suzanne | |
| TextureCoordinateTest | |
| TextureSettingsTest | |
| TextureTransformTest | |
| Triangle | passes |
| TriangleWithoutIndices | |
| TwoSidedPlane | errors: 3 |
| VC | |
| VertexColorTest | |
| WaterBottle | |
### unittests
python -m tests
Python library for reading, writing and handling GLTF files. Python3.7+
## Requirements
* Python 3.7
* numpy
## About
The library tracks the [official file format](https://github.com/KhronosGroup/glTF/blob/master/specification/2.0/README.md) for GLTF2.
The library was initially built to load and save simple meshes, support for materials and animations is experimental.
Check the table below for an idea of which sample models validate.
Roadmap:
* Finishing building out schemas
* Validate sample models
* Add helper functions
## Install
pip install pygltflib
or
python3.7 -m pip install pygltflib
## Usage
Note: These examples use the official [sample models](https://github.com/KhronosGroup/glTF-Sample-Models) provided by Kronos at:
https://github.com/KhronosGroup/glTF-Sample-Models
```python3.7
>>> from pygltflib import GLTF2
>>> filename = "glTF-Sample-Models/2.0/AnimatedCube/glTF/AnimatedCube.gltf"
>>> gltf = GLTF2().load(filename)
>>> gltf
>>> 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)
```
## 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 | errors: 67 |
| AlphaBlendModeTest | errors: 8 |
| AnimatedCube | passes |
| AnimatedMorphCube | |
| AnimatedMorphSphere | |
| AnimatedTriangle | |
| Avocado | |
| BarramundiFish | |
| BoomBox | |
| BoomBoxWithAxes | |
| Box | passes |
| BoxAnimated | passes |
| BoxInterleaved | |
| BoxTextured | |
| BoxTexturedNonPowerOfTwo | |
| BoxVertexColors | |
| BrainStem | |
| Buggy | |
| Cameras | |
| CesiumMan | |
| CesiumMilkTruck | |
| Corset | |
| Cube | errors: 2 |
| DamagedHelmet | |
| Duck | |
| FlightHelmet | |
| GearboxAssy | |
| Lantern | |
| MetalRoughSpheres | |
| Monster | errors: 2 |
| MultiUVTest | |
| NormalTangentMirrorTest | |
| NormalTangentTest | |
| OrientationTest | |
| ReciprocatingSaw | |
| RiggedFigure | |
| RiggedSimple | |
| SciFiHelmet | |
| SimpleMeshes | passes |
| SimpleMorph | |
| SimpleSparseAccessor | |
| SpecGlossVsMetalRough | |
| Sponza | |
| Suzanne | |
| TextureCoordinateTest | |
| TextureSettingsTest | |
| TextureTransformTest | |
| Triangle | passes |
| TriangleWithoutIndices | |
| TwoSidedPlane | errors: 3 |
| VC | |
| VertexColorTest | |
| WaterBottle | |
### unittests
python -m tests
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pygltflib-0.2.tar.gz
(5.5 kB
view hashes)