three.js TextureLoader

加載texture的一個(gè)類。 內(nèi)部使用ImageLoader來加載文件。

代碼示例

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

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

帶有回調(diào)的代碼示例

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

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

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

	// 目前暫不支持onProgress的回調(diào)
	undefined,

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

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

例子

geometry / cube

構(gòu)造函數(shù)

TextureLoader( manager : LoadingManager )

manager — 加載器使用的loadingManager，默認(rèn)值為THREE.DefaultLoadingManager.

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

屬性

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

方法

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

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

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

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

源

src/loaders/TextureLoader.js