RectAreaLight - Verge3D User Manual - Soft8Soft
Description: Learn how to use RectAreaLight in your interactive 3D apps made with Verge3D

Object3D → Light →

# RectAreaLight

RectAreaLight emits light uniformly across the face a rectangular plane. This light type can be used to simulate light sources such as bright windows or strip lighting.

This light can cast shadows — see RectAreaLightShadow page for details.

## Code Example

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

## Constructor

### RectAreaLight(color : Integer, intensity : Float, width : Float, height : Float)

- color — (optional) hexadecimal color of the light. Default is `0xffffff` (white).
- intensity — (optional) the light's intensity, or brightness. Default is `1`.
- width — (optional) width of the light. Default is `10`.
- height — (optional) height of the light. Default is `10`.

Creates a new RectAreaLight.

## Properties

See the base Light class for inherited properties.

### # .height : Float

The height of the light.

### # .intensity : Float

The light's intensity. Default is `1`. Intensity for this light type is the luminance (brightness) of the light measured in nits (cd/m^2).

Changing the intensity will also change the light's power.

### # .isRectAreaLight : Boolean

Read-only flag to check if a given object is of type RectAreaLight.

### # .power : Float

The light's power. Power is the luminous power of the light measured in lumens (lm).

Changing the power will also change the light's intensity.

### # .width : Float

The width of the light.

## Methods

See the base Light class for inherited methods.

### # .copy(source : RectAreaLight) → this

Copies value of all the properties from the source to this RectAreaLight.

## Puzzles

The following puzzles work with the area lights:

- create object — select light, then area.
- set light param — to set various light parameters.
- get light param — to obtain light parameters.

## Source

For more info on how to obtain the source code of this module see this page.