Lens Flare - Lumberyard User Guide
Lens Flare Component PropertiesEBus Request Bus InterfaceEBus Notification Bus Interface

Lens Flare

Open 3D Engine (O3DE), the successor to Lumberyard, is now available in Developer Preview. Download O3DE or visit the AWS Game Tech blog to learn more.

The Lens Flare component allows the placement of a lens flare on an entity.

Lens Flare Component Properties

The Lens Flare component has the following properties:

Visible

If selected, shows the lens flare.

Library

Select a lens flare library that has been authored by the Lens Flare editor.

Lens flare

Select a lens flare from the available flares in the lens flare library.

Flare Settings

Minimum spec

The minimum spec at which this lens flare is enabled.

Default: Low

FOV

The field of view (FOV) in degrees around the lens flare. Use 360 degrees to make the lens flare visible from all angles.

Default: 360

Size

The size of the lens flare.

Attach to sun

If selected, attaches the lens flare to the sun (as opposed to attaching to the entity).

Ignore vis areas

If selected, lens flare ignores vis areas.

Indoor only

If selected, lens flare is rendered indoors only.

On initially

If selected, the lens flare is on when the scene starts.

View distance multiplier

Adjust the maximum view distance. For example, 1.0 would use the default and 1.1 would be 10% further than the default.

Color Settings

Tint

Color of the lens flare.

Tint [alpha]

Alpha value that sets the flare's transparency.

Brightness

Brightness of the lens flare.

Animation

Sync with light

If selected, uses the animation settings of the provided light. Select the light entity in the Light setting.

Light

This setting appears when the Sync with light setting is selected. Use the picker (hand icon) to select the light component you want to sync animation settings with.

Style

Light animation curve ID (style) as it corresponds to values in Light.cfx.

Speed

Multiple of the base animation rate.

Phase

Animation start offset from 0 to 1. 0.1 would be 10% into the animation.

EBus Request Bus Interface

Use the following request function with the EBus interface to communicate with other components of your game.

For more information about using the Event Bus (EBus) interface, see Working with the Event Bus (EBus) system.

  • SetLensFlareState (On or Off) – Turns the lens flare on or off.

  • TurnOnLensFlare – Turns the lens flare on.

  • TurnOffLensFlare – Turns the lens flare off.

  • ToggleLensFlare – Toggles the lens flare state (on to off, or off to on).

EBus Notification Bus Interface

Use the following notification functions with the EBus interface to communicate with other components of your game.

For more information about using the Event Bus (EBus) interface, see Working with the Event Bus (EBus) system.

  • LensFlareTurnedOn – Sends a signal when the lens flare is turned on.

  • LensFlareTurnedOff – Sends a signal when the lens flare is turned off.

The following is an example of script using the Request Bus Interface.

function example:OnActivate()
    LensFlareComponentRequestBus.Event.SetLensFlareState(self.entityId, LensFlareComponentState.Off)
    LensFlareComponentRequestBus.Event.TurnOnLensFlare(self.entityId)
    LensFlareComponentRequestBus.Event.TurnOffLensFlare(self.entityId)
    LensFlareComponentRequestBus.Event.ToggleLensFlare(self.entityId)
end