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