Castle Game Engine

Class TCastleSpotLight

Description
Hierarchy
Fields
Methods
Properties

Unit

CastleScene

Declaration

type TCastleSpotLight = class(TCastleAbstractLight)

Description

Spot light shines a cone of light, from a given location, along a direction (-Z in local coordinates).

See X3D SpotLight specification for various details.

Hierarchy

Overview

Fields

Public nested const DefaultBeamWidth = Pi * 3 / 16;
Public nested const DefaultCutOffAngle = Pi / 4;
Public nested const DefaultRadius = 100.0;

Methods

Public constructor Create(AOwner: TComponent); override;
Public destructor Destroy; override;
Public function PropertySections(const PropertyName: String): TPropertySections; override;

Properties

Public property Color: TCastleColorRGB read FColor write SetColor;
Public property Attenuation: TVector3 read FAttenuation write SetAttenuation;
Published property Intensity: Single read FIntensity write SetIntensity default 1.0;
Published property Radius: Single read FRadius write SetRadius default DefaultRadius;
Published property BeamWidth: Single read FBeamWidth write SetBeamWidth default DefaultBeamWidth;
Published property CutOffAngle: Single read FCutOffAngle write SetCutOffAngle default DefaultCutOffAngle;
Published property ColorPersistent: TCastleColorRGBPersistent read FColorPersistent ;
Published property AttenuationPersistent: TCastleVector3Persistent read FAttenuationPersistent ;

Description

Fields

Public nested const DefaultBeamWidth = Pi * 3 / 16;
 
Public nested const DefaultCutOffAngle = Pi / 4;
 
Public nested const DefaultRadius = 100.0;
 

Methods

Public constructor Create(AOwner: TComponent); override;
 
Public destructor Destroy; override;
 
Public function PropertySections(const PropertyName: String): TPropertySections; override;
 

Properties

Public property Color: TCastleColorRGB read FColor write SetColor;

Light color shining over surface. By default white.

Public property Attenuation: TVector3 read FAttenuation write SetAttenuation;

Attenuation determines how quickly light intensity falls off with distance. By default Vector3(0, 0, 1), which means light falls off according to inverse square law.

Published property Intensity: Single read FIntensity write SetIntensity default 1.0;

Intensity, multiplied by color. Can be anything >= 0.

Published property Radius: Single read FRadius write SetRadius default DefaultRadius;

Light doesn't shine at all outside of a sphere with this radius. For performance reasons, set this as small as possible, to avoid even considering this light at further shapes. Set to -1 to have no limit.

Published property BeamWidth: Single read FBeamWidth write SetBeamWidth default DefaultBeamWidth;

Angle within which the spot light has maximum intensity.

If this is >= CutOffAngle (which is the default case), then the light has maximum intensity within CutOffAngle, and zero intensity outside CutOffAngle, and there it no smooth falloff.

You need to make BeamWidth < CutOffAngle to have a smooth falloff at the egdes of the spot light.

Published property CutOffAngle: Single read FCutOffAngle write SetCutOffAngle default DefaultCutOffAngle;

Angle within which the spot light has any intensity.

If BeamWidth < CutOffAngle then the light intensity falls off smoothly between BeamWidth and CutOffAngle.

The light intensity is always zero outside of CutOffAngle, regardless of the BeamWidth value.

Published property ColorPersistent: TCastleColorRGBPersistent read FColorPersistent ;

Color that can be visually edited in Castle Game Engine Editor, Lazarus and Delphi. Normal user code does not need to deal with this, instead read or write Color directly.

See also
Color
Light color shining over surface.
Published property AttenuationPersistent: TCastleVector3Persistent read FAttenuationPersistent ;

Attenuation that can be visually edited in Castle Game Engine Editor, Lazarus and Delphi. Normal user code does not need to deal with this, instead read or write Attenuation directly.

See also
Attenuation
Attenuation determines how quickly light intensity falls off with distance.
Generated by PasDoc 0.16.0.