three.js TextureLoader

加載texture的一個類。 內部使用ImageLoader來加載文件。

代碼示例

const texture = new THREE.TextureLoader().load( 'textures/land_ocean_ice_cloud_2048.jpg' );

// 立即使用紋理進行材質創(chuàng)建
const material = new THREE.MeshBasicMaterial( { map: texture } );

帶有回調的代碼示例

// 初始化一個加載器
const loader = new THREE.TextureLoader();

// 加載一個資源
loader.load(
	// 資源URL
	'textures/land_ocean_ice_cloud_2048.jpg',

	// onLoad回調
	function ( texture ) {
		// in this example we create the material when the texture is loaded
		const material = new THREE.MeshBasicMaterial( {
			map: texture
		 } );
	},

	// 目前暫不支持onProgress的回調
	undefined,

	// onError回調
	function ( err ) {
		console.error( 'An error happened.' );
	}
);

請注意three.js r84遺棄了TextureLoader進度事件。對于支持進度事件的TextureLoader ， 請參考this thread。

例子

geometry / cube

構造函數(shù)

TextureLoader( manager : LoadingManager )

manager — 加載器使用的loadingManager，默認值為THREE.DefaultLoadingManager.

創(chuàng)建一個新的TextureLoader.

屬性

共有屬性請參見其基類Loader。

方法

共有方法請參見其基類Loader。

.load ( url : String, onLoad : Function, onProgress : Function, onError : Function ) : Texture

url — 文件的URL或者路徑，也可以為 Data URI.
onLoad — 加載完成時將調用?；卣{參數(shù)為將要加載的texture.
onProgress — 將在加載過程中進行調用。參數(shù)為XMLHttpRequest實例，實例包含total和loaded字節(jié)。
onError — 在加載錯誤時被調用。

從給定的URL開始加載并將完全加載的texture傳遞給onLoad。該方法還返回一個新的紋理對象，該紋理對象可以直接用于材質創(chuàng)建。 如果采用此方法，一旦相應的加載過程完成，紋理可能會在場景中出現(xiàn)。

源

src/loaders/TextureLoader.js