[page:Object3D] → [page:Light] →

# [name]

ينبعث RectAreaLight بالضوء بشكل موحد عبر وجه سطح مستطيل. يمكن استخدام هذا النوع من الضوء لمحاكاة مصادر الضوء مثل النوافذ المشرقة أو الإضاءة المخططة.
ملاحظات هامة:

- لا يوجد دعم للظلال.
- يتم دعم [page:MeshStandardMaterial MeshStandardMaterial] و [page:MeshPhysicalMaterial MeshPhysicalMaterial] فقط.
- يجب عليك تضمين [link:https://threejs.org/examples/jsm/lights/RectAreaLightUniformsLib.js RectAreaLightUniformsLib] في مشهدك واستدعاء `init()`.

## مثال للكود

`const width = 10; const height = 10; const intensity = 1; const rectLight = new THREE.RectAreaLight( 0xffffff, intensity, width, height ); rectLight.position.set( 5, 5, 0 ); rectLight.lookAt( 0, 0, 0 ); scene.add( rectLight ) const rectLightHelper = new RectAreaLightHelper( rectLight ); rectLight.add( rectLightHelper );`

## أمثلة (Examples)

[example:webgl_lights_rectarealight WebGL / rectarealight ]

## المنشئ (Constructor)

### [name]( [param:Integer color], [param:Float intensity], [param:Float width], [param:Float height] )

[page:Integer color] - (اختياري) لون سداسي عشري للضوء. الافتراضي هو 0xffffff (أبيض).
[page:Float intensity] - (اختياري) شدة الضوء ، أو سطوعه. الافتراضي هو 1.
[page:Float width] - (اختياري) عرض الضوء. الافتراضي هو 10.
[page:Float height] - (اختياري) ارتفاع الضوء. الافتراضي هو 10.
إنشاء جديد [name].

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

انظر إلى قائمة [page:Light Light] للخصائص المشتركة.

### [property:Float height]

ارتفاع الضوء.

### [property:Float intensity]

شدة الضوء. القيمة الافتراضية هي `1`.
الشدة هي الإضاءة (السطوع) للضوء المقاسة بالنيتات (cd/m^2).
تغيير الشدة سيغير أيضًا قوة الضوء.

### [property:Boolean isRectAreaLight]

علامة للقراءة فقط للتحقق مما إذا كان كائنًا معينًا من نوع [name].

### [property:Float power]

قوة الضوء.
الطاقة هي قوة إضاءة الضوء المقاسة باللومن (lm).
تغيير الطاقة سيغير أيضًا شدة الضوء.

### [property:Float width]

عرض الضوء.

## الطرق (Methods)

انظر إلى قائمة [page:Light Light] للطرق المشتركة.

### [method:this copy]( [param:RectAreaLight source] )

نسخ قِيَم جميع خصائص [page:RectAreaLight source] إلى هذه RectAreaLight.

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