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