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