docs/primitives/a-light.md
A light changes the lighting and shading of the scene.
<!-- Red directional light shining from the top left. -->
<a-light color="red" position="-1 1 0"></a-light>
<!-- Blue point light, 5 meters in the air. -->
<a-light type="point" color="blue" position="0 5 0"></a-light>
<!-- Dim ambient lighting. -->
<a-light type="ambient" color="#222"></a-light>
<!-- Probe light using the #pisa environment map -->
<a-assets>
<a-cubemap id="pisa">
</a-cubemap>
</a-assets>
<a-light type="probe" envMap="#pisa"></a-light>
| Attribute | Component Mapping | Default Value |
|---|---|---|
| angle | light.angle | 60 |
| color | light.color | #fff |
| decay | light.decay | 1 |
| distance | light.distance | 0.0 |
| envmap | light.envMap | null |
| ground-color | light.groundColor | #fff |
| intensity | light.intensity | 1.0 |
| penumbra | light.penumbra | 0.0 |
| type | light.type | directional |
| target | light.target | null |
When we add a light, A-Frame will remove the default lighting setup (i.e., one directional light from the top-left, and one small ambient light).