[name]

A loader for loading a [page:Material] in JSON format. This uses the [page:FileLoader] internally for loading files.

Example


		// instantiate a loader
		var loader = new THREE.MaterialLoader();

		// load a resource
		loader.load(
			// resource URL
			'path/to/material.json',

			// onLoad callback
			function ( material ) {
				object.material = material;
			},

			// onProgress callback
			function ( xhr ) {
				console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
			},

			// onError callback
			function ( err ) {
				console.log( 'An error happened' );
			}
		);

Constructor

[name]( [param:LoadingManager manager] )

[page:LoadingManager manager] — The [page:LoadingManager loadingManager] for the loader to use. Default is [page:LoadingManager THREE.DefaultLoadingManager].

Creates a new [name].

Properties

[property:LoadingManager manager]

The [page:LoadingManager loadingManager] the loader is using. Default is [page:DefaultLoadingManager].

[property:Object textures]

Object holding any textures used by the material. See [page:.setTextures].

Methods

[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )

[page:String url] — the path or URL to the file. This can also be a [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].
[page:Function onLoad] — Will be called when load completes. The argument will be the loaded [page:Material].
[page:Function onProgress] — Will be called while load progresses. The argument will be the progress event.
[page:Function onError] — Will be called when load errors.

Begin loading from url and return the [page:Material] object that will contain the data.

[method:Material parse]( [param:Object json] )

[page:Object json] — The json object containing the parameters of the Material.

Parse a JSON structure and create a new [page:Material] of the type [page:String json.type] with parameters defined in the json object.

[method:MaterialLoader setPath]( [param:String path] )

[page:String path] — Base path of the file to load.

Sets the base path or URL from which to load files. This can be useful if you are loading many materials from the same directory.

[method:MaterialLoader setTextures]( [param:Object textures] )

[page:Object textures] — object containing any textures used by the material.

Source

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]