[page:Loader] →

# [name]

محمل لتحميل صورة [page:Image]. يتم استخدام هذا داخليًا من قبل [page:CubeTextureLoader]، [page:ObjectLoader] و [page:TextureLoader].

## مثال الكود

`// instantiate a loader const loader = new THREE.ImageLoader(); // load a image resource loader.load( // resource URL 'textures/skyboxsun25degtest.png', // onLoad callback function ( image ) { // use the image, e.g. draw part of it on a canvas const canvas = document.createElement( 'canvas' ); const context = canvas.getContext( '2d' ); context.drawImage( image, 100, 100 ); }, // onProgress callback currently not supported undefined, // onError callback function () { console.error( 'An error happened.' ); } );`

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

## أمثلة (Examples)

[example:webgl_loader_obj WebGL / loader / obj]
[example:webgl_shaders_ocean WebGL / shaders / ocean]

## المنشئ (Constructor)

### [name]( [param:LoadingManager manager] )

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

## الخصائص (Properties)

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

## الطرق (Methods)

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

### [method:HTMLImageElement 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:Image image] الذي سيحتوي على البيانات.

## المصدر (Source)

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