Interface ImportAddOptions

default = false, if set to true, it will test if the data textures are complete. [internal use]

Add directly to the RootScene object instead of RootScene.modelRoot

Automatically center the object in the scene.

default = true, if true, the importer will automatically import the contents of zip files, if zip importer is registered.

Automatically scale the object according to its bounding box and the autoScaleRadius setting

Radius to use for autoScale autoScale must be true for this to work.

Automatically set any loaded image(ITexture) file as the scene background

Automatically set any loaded HDR, EXR file as the scene environment map

If true, the loaded asset object will be cached in the asset importer's cache (in memory). Default is true.

Automatically center the geometries(pivots) in the object hierarchy before adding.

This centers the geometry while keeping the world position, i.e the mesh(Object3D) positions will change. centerGeometries must be true for this to work.

Clear the viewer scene objects before the new object is added. Same as disposeSceneObjects but does not dispose the objects.

If true, the loader will create unique names for objects in the gltf file when multiple objects with the same name are found.

Note - Only for gltf, glb files or files loaded with GLTFLoader2. If this flag is not passed, the default value is the value of the static property GLTFLoader2.CreateUniqueNames. If set to 'auto'(default), it will only create unique names when loading a rootSceneModelRoot, i.e. the scene object exported with AssetExporter

Dispose all the scene objects before the new object is added. Same as clearSceneObjects but also disposes the objects.

The file extension to use for the file. If not specified, the importer will try to determine the file extension from the file name/url.

The custom ILoader to use for the file. If not specified, the importer will try to determine the loader from the file extension.

Default = false. If true, the asset will be imported again on subsequent calls, even if it is already imported.

default = false. If true, the importer will reprocess the imported objects, even if they are already processed.

default = undefined, only used for textures

If true, the imported asset will be treated as a model root, and its objects will be imported under a root scene object. This is useful when importing assets that are meant to be used as root scenes, but not exported with AssetExporter as a scene. When this is not set (or set to undefined), it will be determined automatically based on the presence of rootSceneModelRoot in the asset. Note - Only for gltf, glb files or files loaded with @default - undefined

any attached viewer config will be ignored if this is set to true

Pass a custom file to use for the import. This will be used in the importer, and nothing will be fetched from the path

Index to insert the object at in the parent's children array.

Add a license to the object

Mime type to use when importing the file, if not specified, it will be determined from the file extension.

Path override to use for the asset. This will be used in the importer as override to path inside the asset/cached asset.

default = true, toggle to control the processing of the raw objects in the proecssRaw method

Query string to add to the url. Default = undefined

If true or not specified, and any of the assets is disposed(only root objects are checked, not children), all assets will be imported in this call. If false, old assets will be returned. Default = true.

If true, the importer will replace any three.js camera instances with upgraded cameras default = true

If true, the importer will replace any three.js light instances with upgraded lights default = true

If true, the importer will replace any three.js material instances with upgraded materials default = true

for internal use

Use MeshLine(an extension of three.js Line2) instead of default Line for lines. This allows changing line width(fat lines) and other properties.

Note - Only for gltf, glb files or files loaded with GLTFLoader2. If this flag is not passed, the default value is the value of the static property GLTFLoader2.UseMeshLines.