[page:Loader] →

[name]

فئة لتحميل [page:Texture texture]. يستخدم هذا [page:ImageLoader] داخليًا لتحميل الملفات.

مثال الكود


		const texture = new THREE.TextureLoader().load('textures/land_ocean_ice_cloud_2048.jpg' ); 
		// immediately use the texture for material creation 
			
		const material = new THREE.MeshBasicMaterial( { map:texture } );

مثال الكود مع الردود (Code Example with Callbacks)


		// instantiate a loader
		const loader = new THREE.TextureLoader();
	
		// load a resource
		loader.load(
			// resource URL
			'textures/land_ocean_ice_cloud_2048.jpg',
	
			// onLoad callback
			function ( texture ) {
				// in this example we create the material when the texture is loaded
				const material = new THREE.MeshBasicMaterial( {
					map: texture
					} );
			},
	
			// onProgress callback currently not supported
			undefined,
	
			// onError callback
			function ( err ) {
				console.error( 'An error happened.' );
			}
		);

يرجى ملاحظة أن three.js r84 قام بإسقاط دعم حدث التقدم لـ TextureLoader . لـ TextureLoader يدعم أحداث التقدم، انظر [link:https://github.com/mrdoob/three.js/issues/10439#issuecomment-293260145 هذا الموضوع].

أمثلة (Examples)

[example:webgl_geometry_cube geometry / cube]

المنشئ (Constructor)

[name]( [param:LoadingManager manager] )

[page:LoadingManager manager] — [page:LoadingManager loadingManager] للمحمل الذي سيتم استخدامه. الافتراضي هو [page:LoadingManager THREE.DefaultLoadingManager].

ينشئ [name] جديد.

الخصائص (Properties)

انظر الفئة الأساسية [page:Loader] للخصائص المشتركة.

الطرق (Methods)

انظر الفئة الأساسية [page:Loader] للطرق المشتركة.

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

[page:String url] — المسار أو عنوان URL للملف. يمكن أن يكون هذا أيضًا [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].
[page:Function onLoad] (اختياري) — سيتم استدعاؤه عند اكتمال التحميل. الحجة ستكون ال [page:Texture texture] المحمّل.
[page:Function onProgress] (اختياري) — هذه الدالة الرجعية غير مدعومة حاليًا.
[page:Function onError] (اختياري) — سيتم استدعاؤه عند حدوث خطأ في التحميل.

ابدأ التحميل من عنوان URL المعطى وأرسل الـ[page:Texture texture] المحمّل بالكامل إلى onLoad. تعيد الطريقة أيضًا كائن نسيج جديد يمكن استخدامه مباشرة لإنشاء المادة. إذا قمت بذلك بهذه الطريقة، فقد يظهر النسيج في مشهدك بمجرد انتهاء عملية التحميل المعنية.

المصدر (Source)

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