Skip to main content
Version: 2.0.0-preview

Spot Light

:::caution Experimental

This 3D feature is under development and the API may change without notice.

:::

A cone-shaped spotlight defined by inner and outer cone angles. Brightness fades from full inside the inner cone to zero outside the outer cone.

Library location​

Library → 3D (Experimental) → Spot Light

Properties​

Position​

World-space position of the spotlight.

  • Type: Vector3
  • Default: (0, -500, 0)
  • Animatable: Yes

Direction​

Direction the cone is aimed toward.

  • Type: Vector3
  • Default: (0, 1, 0)
  • Animatable: Yes

Inner Cone Angle (InnerConeAngle)​

Half-angle of the fully lit inner cone (degrees).

  • Type: float
  • Default: 12.5
  • Animatable: Yes
  • Range: [0, 90]

Outer Cone Angle (OuterConeAngle)​

Half-angle of the outer cone where the light fades to zero (degrees).

  • Type: float
  • Default: 17.5
  • Animatable: Yes
  • Range: [0, 90]

Constant Attenuation (ConstantAttenuation)​

Constant term of the distance falloff.

  • Type: float
  • Default: 1.0
  • Animatable: Yes
  • Range: [0, ∞)

Linear Attenuation (LinearAttenuation)​

Linear term of the distance falloff.

  • Type: float
  • Default: 0.0009
  • Animatable: Yes
  • Range: [0, ∞)

Quadratic Attenuation (QuadraticAttenuation)​

Quadratic term of the distance falloff.

  • Type: float
  • Default: 0.0000032
  • Animatable: Yes
  • Range: [0, ∞)

Range​

Maximum distance the spotlight reaches.

  • Type: float
  • Default: 5000
  • Animatable: Yes
  • Range: [0, ∞)

Common properties​

This object inherits from Light3D and exposes the common properties declared on its base classes.

Source​

src/Beutl.Engine/Graphics3D/Lighting/SpotLight3D.cs