[page:Loader] →

# [name]

محمل لتحميل مورد JSON في [link:https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4 JSON Object/Scene format].
يستخدم هذا [page:FileLoader] داخليًا لتحميل الملفات.

## مثال الكود

`const loader = new THREE.ObjectLoader(); loader.load( // resource URL "models/json/example.json", // onLoad callback // Here the loaded data is assumed to be an object function ( obj ) { // Add the loaded object to the scene scene.add( obj ); }, // onProgress callback function ( xhr ) { console.log( (xhr.loaded / xhr.total * 100) + '% loaded' ); }, // onError callback function ( err ) { console.error( 'An error happened' ); } ); // Alternatively, to parse a previously loaded JSON structure const object = loader.parse( a_json_object ); scene.add( object );`

## أمثلة (Examples)

[example:webgpu_materials_lightmap WebGL / materials / lightmap]

## المنشئ (Constructor)

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

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

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

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

## الطرق (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:Object3D object] المحمّل.
[page:Function onProgress] (اختياري) — سيتم استدعاؤه أثناء تقدم التحميل. الحجة ستكون مثيل ProgressEvent، والذي يحتوي على .[page:Boolean lengthComputable]، .[page:Integer total] و .[page:Integer loaded]. إذا لم يضبط الخادم رأس Content-Length ؛ سيكون .[page:Integer total] 0.
[page:Function onError] (اختياري) — سيتم استدعاؤه عند حدوث خطأ في التحميل.

ابدأ التحميل من url واستدعِ onLoad مع محتوى الاستجابة المحلل.

### [method:Object3D parse]( [param:Object json], [param:Function onLoad] )

[page:Object json] — مطلوب. مصدر JSON للتحليل.
[page:Function onLoad] — سيتم استدعاؤه عند اكتمال التحليل. ال الحجة ستكون ال [page:Object3D object] المحلل.
قم بتحليل هيكل `JSON` وإرجاع كائن three.js. يستخدم هذا داخليًا بواسطة [page:.load]() ولكن يمكن أيضًا استخدامه مباشرة لتحليل هيكل JSON محمّل مسبقًا.

### [method:Object parseGeometries]( [param:Object json] )

[page:Object json] — مطلوب. مصدر JSON للتحليل.
يستخدم هذا بواسطة [page:.parse]() لتحليل أي [page:BufferGeometry geometries] في هيكل JSON.

### [method:Object parseMaterials]( [param:Object json] )

[page:Object json] — مطلوب. مصدر JSON للتحليل.
يستخدم هذا بواسطة [page:.parse]() لتحليل أي مواد في ال JSON هيكل باستخدام [page:MaterialLoader].

### [method:Object parseAnimations]( [param:Object json] )

[page:Object json] — مطلوب. مصدر JSON للتحليل.
يستخدم هذا بواسطة [page:.parse]() لتحليل أي رسوم متحركة في ال JSON هيكل، باستخدام [page:AnimationClip.parse]().

### [method:Object parseImages]( [param:Object json] )

[page:Object json] — مطلوب. مصدر JSON للتحليل.
يستخدم هذا بواسطة [page:.parse]() لتحليل أي صور في هيكل JSON، باستخدام [page:ImageLoader].

### [method:Object parseTextures]( [param:Object json] )

[page:Object json] — مطلوب. مصدر JSON للتحليل.
يستخدم هذا بواسطة [page:.parse]() لتحليل أي نسيج في ال JSON هيكل.

### [method:Object3D parseObject]( [param:Object json], [param:BufferGeometry geometries], [param:Material materials], [param:AnimationClip animations] )

[page:Object json] — مطلوب. مصدر JSON للتحليل.
[page:BufferGeometry geometries] — مطلوب. الهندسات الخاصة بـ JSON.
[page:Material materials] — مطلوب. المواد الخاصة بـ JSON.
[page:AnimationClip animations] — مطلوب. الرسوم المتحركة الخاصة بـ JSON.
يستخدم هذا بواسطة [page:.parse]() لتحليل أي كائنات ثُنائية الأبعاد في ال JSON هيكل.

## المصدر (Source)

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