---

title: GLTFExporter category: Addons layout: docs

GLTFExporter

An exporter for glTF 2.0.

glTF (GL Transmission Format) is an open format specification for efficient delivery and loading of 3D content. Assets may be provided either in JSON (.gltf) or binary (.glb) format. External files store textures (.jpg, .png) and additional binary data (.bin). A glTF asset may deliver one or more scenes, including meshes, materials, textures, skins, skeletons, morph targets, animations, lights, and/or cameras.

GLTFExporter supports the glTF 2.0 extensions:

• KHR_lights_punctual
• KHR_materials_clearcoat
• KHR_materials_dispersion
• KHR_materials_emissive_strength
• KHR_materials_ior
• KHR_materials_iridescence
• KHR_materials_specular
• KHR_materials_sheen
• KHR_materials_transmission
• KHR_materials_unlit
• KHR_materials_volume
• KHR_mesh_quantization
• KHR_texture_transform
• EXT_materials_bump
• EXT_mesh_gpu_instancing

The following glTF 2.0 extension is supported by an external user plugin:

• KHR_materials_variants

Code Example

const exporter = new GLTFExporter();
const data = await exporter.parseAsync( scene, options );

Import

GLTFExporter is an addon, and must be imported explicitly, see Installation#Addons.

import { GLTFExporter } from 'three/addons/exporters/GLTFExporter.js';

Constructor

new GLTFExporter()

Constructs a new glTF exporter.

Properties

.textureUtils : WebGLTextureUtils | WebGPUTextureUtils

A reference to a texture utils module.

Default is null.

Methods

.parse( input : Scene | Array.<Scene>, onDone : GLTFExporter~OnDone, onError : GLTFExporter~OnError, options : GLTFExporter~Options )

Parses the given scenes and generates the glTF output.

input | A scene or an array of scenes.
---|---
onDone | A callback function that is executed when the export has finished.
onError | A callback function that is executed when an error happens.
options | options

.parseAsync( input : Scene | Array.<Scene>, options : GLTFExporter~Options ) : Promise.<(ArrayBuffer|string)>

Async version of GLTFExporter#parse.

input | A scene or an array of scenes.
---|---
options | options.

Returns: A Promise that resolved with the exported glTF data.

.register( callback : function ) : GLTFExporter

Registers a plugin callback. This API is internally used to implement the various glTF extensions but can also used by third-party code to add additional logic to the exporter.

callback | The callback function to register.
---|---

Returns: A reference to this exporter.

.setTextureUtils( utils : WebGLTextureUtils | WebGPUTextureUtils ) : GLTFExporter

Sets the texture utils for this exporter. Only relevant when compressed textures have to be exported.

Depending on whether you use WebGLRenderer or WebGPURenderer, you must inject the corresponding texture utils WebGLTextureUtils or WebGPUTextureUtils.

utils | The texture utils.
---|---

Returns: A reference to this exporter.

.unregister( callback : function ) : GLTFExporter

Unregisters a plugin callback.

callback | The callback function to unregister.
---|---

Returns: A reference to this exporter.

Type Definitions

.OnDone( result : ArrayBuffer | string )

onDone callback of GLTFExporter.

result | The generated .gltf (JSON) or .glb (binary).
---|---

.OnError( error : Error )

onError callback of GLTFExporter.

error | The error object.
---|---

.Options

Export options of GLTFExporter.

trs
boolean | Export position, rotation and scale instead of matrix per node. Default is false.
---|---
onlyVisible
boolean | Export only visible 3D objects. Default is true.
binary
boolean | Export in binary (.glb) format, returning an ArrayBuffer. Default is false.
maxTextureSize
number | Restricts the image maximum size (both width and height) to the given value. Default is Infinity.
animations
Array.<AnimationClip> | List of animations to be included in the export. Default is [].
includeCustomExtensions
boolean | Export custom glTF extensions defined on an object's userData.gltfExtensions property. Default is false.

Source

examples/jsm/exporters/GLTFExporter.js