[page:Loader] →

[name]

يمكن استخدام [name] لتحميل خرائط المكعب. يُرجع محمل نسخة من [page:CubeTexture] ويتوقع تعريف خريطة المكعب على أنها ستة صور منفصلة تمثل جوانب المكعب. لا يتم دعم تعاريف خريطة المكعب الأخرى مثل الصليب العمودي والأفقي والتصميم بالأعمدة والصفوف.

[page:CubeTexture] المحملة موجودة في مساحة الألوان sRGB. يعني ذلك أن [page:Texture.colorSpace colorSpace] تم تعيين الخاصية إلى `THREE.SRGBColorSpace` افتراضيًا.

مثال للكود


const scene = new THREE.Scene();
scene.background = new THREE.CubeTextureLoader()
	.setPath( 'textures/cubeMaps/' )
	.load( [
				'px.png',
				'nx.png',
				'py.png',
				'ny.png',
				'pz.png',
				'nz.png'
			] );

أمثلة (Examples)

[example:webgl_materials_cubemap materials / cubemap]
[example:webgl_materials_cubemap_dynamic materials / cubemap / dynamic]
[example:webgl_materials_cubemap_refraction materials / cubemap / refraction]

المنشئ (Constructor)

[name]( [param:LoadingManager manager] )

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

ينشئ جديدًا [name].

الخصائص (Properties)

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

الطرق (Methods)

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

[method:CubeTexture load]( [param:String urls], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )

[page:String urls] — مصفوفة من 6 عناوين URL للصور، واحدة لكل جانب من CubeTexture. يجب تحديد عناوين URL بالترتيب التالي: pos-x، neg-x، pos-y، neg-y، pos-z، neg-z. يمكن أن يكونوا أيضًا [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URIs].
يجب ملاحظة أنه بالاتفاقية، تتم تحديد خرائط المكعب في نظام إحداثيات فيه x الموجب إلى اليمين عند النظر إلى محور z الموجب - بعبارة أخرى، باستخدام نظام إحداثيات ذو يد يسرى. نظرًا لأن three.js يستخدم نظام إحداثيات ذو يد يمنى، ستكون خرائط البيئة المستخدمة في three.js pos-x و neg-x مبادلتان.
[page:Function onLoad] (اختياري) — سيتم استدعاؤه عند اكتمال التحميل. الحجة ستكون القوام المحمَّلة [page:CubeTexture texture].
[page:Function onProgress] (اختياري) — هذه الدالة التابعة للرد غير معتمد حاليًا.
[page:Function onError] (اختياري) — سيتم استدعاؤه إذا حدث خطأ في التحميل.

ابدأ التحميل من url وأرسل القوام المحمَّلة [page:CubeTexture texture] إلى onLoad. تعود الطريقة أيضًا كائن قوام جديد يمكن استخدامه مباشرةً لإنشاء مادة .

المصدر (Source)

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