---
title: PointLightComponent
framework: realitykit
role: symbol
role_heading: Structure
path: realitykit/pointlightcomponent
---

# PointLightComponent

A component that defines a point light source.

## Declaration

```swift
struct PointLightComponent
```

## Mentioned in

Automatically animating RealityKit entities

## Overview

Overview The strength of a point light depends on a combination of its intensity and attenuationRadius. The default values for these properties make this light comparable to high-power streetlights, or outdoor floodlights. This table shows a few examples of common scenarios similar to a point light source:  |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |   |  |  |  Use this component by applying it to an entity’s components set. In this example, the light’s color is red: let lightEntity = Entity()

let redLightComponent = PointLightComponent(color: .red) lightEntity.components.set(redLightComponent) The point light illuminates entities based on its distance from them. Here is a visual example of how a red PointLightComponent illuminates elements based on distance:  |  |  note: The green dot in the above illustrations is only a visual representation of the light’s position.

## Topics

### Creating a point light component

- [init(cgColor:intensity:attenuationRadius:)](realitykit/pointlightcomponent/init(cgcolor:intensity:attenuationradius:).md)

### Configuring the light

- [attenuationRadius](realitykit/pointlightcomponent/attenuationradius.md)
- [intensity](realitykit/pointlightcomponent/intensity.md)
- [attenuationFalloffExponent](realitykit/pointlightcomponent/attenuationfalloffexponent.md)

### Supporting types

- [PointLightComponent.Color](realitykit/pointlightcomponent/color-swift.typealias.md)

### Assigning render layers

- [layers](realitykit/pointlightcomponent/layers.md)

### Lighting the surroundings

- [PointLightComponent.SurroundingsLight](realitykit/pointlightcomponent/surroundingslight.md)

### Initializers

- [init(color:intensity:attenuationRadius:)](realitykit/pointlightcomponent/init(color:intensity:attenuationradius:).md)
- [init(color:intensity:attenuationRadius:attenuationFalloffExponent:)](realitykit/pointlightcomponent/init(color:intensity:attenuationradius:attenuationfalloffexponent:).md)

### Instance Properties

- [color](realitykit/pointlightcomponent/color-4ksx7.md)
- [color](realitykit/pointlightcomponent/color-8gecu.md)

## Relationships

### Conforms To

- [Component](realitykit/component.md)
- [Copyable](swift/copyable.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
