[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]