Skip to content
Blender glTF 2.0 importer and exporter
Python JavaScript Dockerfile
Branch: master
Clone or download

Latest commit

Latest commit 9dde650 Mar 28, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Remove 2.79 from tests Feb 20, 2020
.github/ISSUE_TEMPLATE Update template Feb 21, 2020
.vscode Add VSCode debugging instructions Dec 16, 2018
addons/io_scene_gltf2 Bump to 1.2.57 Mar 28, 2020
docs Export KHR_materials_clearcoat. Mar 6, 2020
example-addons/example_gltf_extension Update info fields of example extension. Jan 13, 2020
images Merge pull request #710 from scurest/nla-strip-anim-docs Oct 2, 2019
misc Move example extension to a new folder. Jan 9, 2020
tests Test: test that animation names roundtrip Mar 17, 2020
tools Add copy tool Feb 21, 2020
.dockerignore Improve docker setup for tests Feb 24, 2019
.gitattributes Update .gitattributes to reduce guessing on line endings. Oct 17, 2019
.gitignore Move .gitignore from addon folder to root. Jan 8, 2020
.project Added project files for Eclipse/PyDev. Jul 14, 2018
.pydevproject Changed pydev version. Nov 9, 2018
AUTHORS.txt Add Sketchfab in authors file Nov 10, 2018
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Oct 10, 2018
DEBUGGING.md Remove 2.79 from tests Feb 20, 2020
DOCKER.txt Improve docker setup for tests Feb 24, 2019
Dockerfile Remove 2.79 from tests Feb 20, 2020
LICENSE.txt Update license to Apache 2.0 Oct 1, 2018
README.md README.md - Add link to legacy 2.79 release. Mar 10, 2020
docker-compose.yml Remove 2.79 from tests Feb 20, 2020

README.md

Blender glTF

Blender glTF 2.0 Importer and Exporter

Documentation

Blender Version Documentation
2.80 https://docs.blender.org/manual/en/2.80/addons/io_scene_gltf2.html
2.81 https://docs.blender.org/manual/en/2.81/addons/import_export/io_scene_gltf2.html
2.82 https://docs.blender.org/manual/en/2.82/addons/import_export/scene_gltf2.html
dev https://docs.blender.org/manual/en/dev/addons/import_export/scene_gltf2.html

Notes:

  • 2.80 - 2.81 are previous stable releases.
  • 2.82 is the current stable release. Check the blender-v2.82-release branch.
  • master branch of this addon is mirrored in Blender Addons master, that will become 2.83.

Legacy 2.79 Support

The final version of this addon with legacy support for Blender 2.79 is available on the 2.79 Release Page.

Blender 2.80 and higher bundle this addon in the main Blender install package, so no 3rd-party install is required.

Credits

Developed by UX3D and Julien Duroure, with support from the Khronos Group, Mozilla, and Airbus Defense & Space.

Introduction

Official Khronos Group Blender glTF 2.0 importer and exporter.

This project contains all features from the previous exporter, and all future development will happen on this repository. In addition, this repository contains a Blender importer, with common Python code shared between exporter and importer for round-trip workflows. New features are included or under development, but usage and menu functionality remain the same.

The shared codebase is organized into common (Blender-independent) and Blender-specific packages:

Packages
Package organisation

This structure allows common code to be reused by third-party Python packages working with the glTF 2.0 format.

Process
Import & export process

The main importer and exporter interface is the Python glTF scene representation.
Blender scene data is first extracted and converted into this scene description. This glTF scene description is exported to the final JSON glTF file. Any compression of mesh, animation, or texture data happens here.
For import, glTF data is parsed and written into the Python glTF scene description. Any decompression is executed in this step. Using the imported glTF scene tree, the Blender internal scene representation is generated from this information.

Installation

The Khronos glTF 2.0 importer and exporter is enabled by default in Blender 2.8 and higher. To reinstall it — for example, when testing recent or upcoming changes — copy the addons/io_scene_gltf2 folder into the scripts/addons/ directory of the Blender installation, then enable it under the Add-ons tab. For additional development documentation, see Debugging.

Debugging

Continuous Integration Tests

Several companies, individuals, and glTF community members contribute to Blender glTF I/O. Functionality is added and bugs are fixed regularly. Because hobbyists and professionals using Blender glTF I/O rely on its stability for their daily work, continuous integration tests are enabled. After each commit or pull request, the following tests are run:

  • Export Blender scene and validate using the glTF validator
  • Round trip import-export and comparison of glTF validator results

These quality-assurance checks improve the reliability of Blender glTF I/O.

CircleCI

Running the Tests Locally

To run the tests locally, your system should be modified to include blender28 as shell scripts (or Windows .bat files) in the path that launch their respective versions of Blender, including all command-line arguments.

The latest version of Yarn should also be installed.

Then, in the tests folder of this repository, run yarn install, followed by yarn run test. You can limit the test suite to one version of Blender with yarn run test-blender28.

You can’t perform that action at this time.