[page:Loader] →

[name]

محمل لتحميل صورة [page:Image] كـ [link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap ImageBitmap]. يوفر ImageBitmap مسارًا غير متزامن وفعال من حيث الموارد لإعداد القوام للتقديم في WebGL.
على عكس [page:FileLoader]، [name] لا يتجنب الطلبات المتعددة المتزامنة إلى نفس عنوان URL.

لاحظ أن [page:Texture.flipY] و [page:Texture.premultiplyAlpha] مع [link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap ImageBitmap] يتم تجاهلهم. [link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap ImageBitmap] يحتاج هذه التكوينات على إنشاء الخريطة البيانية على عكس الصور العادية التي تحتاجها عند تحميلها على وحدة معالجة الرسومات. تحتاج إلى تعيين الخيارات المكافئة عبر [page:ImageBitmapLoader.setOptions] بدلاً من ذلك. راجع [link:https://www.khronos.org/registry/webgl/specs/latest/1.0/#6.10 WebGL specification] للحصول على التفاصيل.

مثال الكود


		const loader = new THREE.FileLoader();
	
		//load a text file and output the result to the console
		loader.load(
			// resource URL
			'example.txt',
	
			// onLoad callback
			function ( data ) {
				// output the text to the console
				console.log( data )
			},
	
			// onProgress callback
			function ( xhr ) {
				console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
			},
	
			// onError callback
			function ( err ) {
				console.error( 'An error happened' );
			}
		);

أمثلة (Examples)

[example:webgl_loader_imagebitmap WebGL / loader / ImageBitmap]

المنشئ (Constructor)

[name]( [param:LoadingManager manager] )

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

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

الخصائص (Properties)

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

[property:Boolean isImageBitmapLoader]

علامة للقراءة فقط للتحقق مما إذا كان الكائن المعطى هو من نوع [name].

[property:String options]

كائن اختياري يضع خيارات لـ [link:https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap createImageBitmap] طريقة المصنع المستخدمة داخليًا. الافتراضي هو `undefined`.

الطرق (Methods)

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

[method:undefined 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:Image image].
[page:Function onProgress] (اختياري) - هذه وظيفة رد الاتصال غير مدعوم حاليًا.
[page:Function onError] (اختياري) - سيتم استدعاؤه عند حدوث خطأ في التحميل.

قم ببدء التحميل من عنوان URL وإرجاع كائن الصورة [page:ImageBitmap image] الذي سيحتوي على البيانات.

[method:this setOptions]( [param:Object options] )

يضع كائن الخيارات لـ [link:https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap createImageBitmap].

المصدر (Source)

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