Class LightSource

Acts as a source of light in the scene.

See

Light and Shadows guide.

Example

// Sets the intensity of a light source
//@input Component.LightSource lightSource

script.lightSource.intensity = 0.0;

Hierarchy (View Summary, Expand)

Constructors

constructor

Properties

autoLightSourcePosition autoShadowFrustumSize castsShadows color diffuseEnvmapTexture enabled envmapExposure envmapRotation intensity lightType renderLayer sceneObject shadowBlurRadius shadowColor shadowDensity shadowFrustumFarClipPlane shadowFrustumNearClipPlane shadowFrustumSize specularEnvmapTexture uniqueIdentifier useEnvmap

Methods

destroy getSceneObject getTransform getTypeName isOfType isSame

Constructors

Protectedconstructor

Properties

autoLightSourcePosition

autoLightSourcePosition: boolean

If enabled, the LightSource will be automatically positioned based on its orientation relative to any shadow casting meshes in the scene.

autoShadowFrustumSize

autoShadowFrustumSize: boolean

If enabled, shadowFrustumSize will be automatically updated based on its orientation relative to any shadow casting meshes in the scene.

castsShadows

castsShadows: boolean

If enabled, the LightSource will be able to cast shadows.

color

color: vec3

The color of the light.

diffuseEnvmapTexture

diffuseEnvmapTexture: Texture

A color image applied to an imaginary skybox the LightSource will use for color information.

enabled

enabled: boolean

If disabled, the Component will stop enacting its behavior.

envmapExposure

envmapExposure: number

A value used to increase the intensity of light information derived from the diffuseEnvmapTexture exponentially.

envmapRotation

envmapRotation: number

Controls the amount of rotation applied to the diffuseEnvmapTexture.

intensity

intensity: number

The strength of the light on a scale of 0.0 1.0.

lightType

lightType: LightType

The type of light emitted from this light source.

renderLayer

renderLayer: LayerSet

The set of layers this LightSource will affect.

ReadonlysceneObject

sceneObject: SceneObject

The scene object this component is on.

shadowBlurRadius

shadowBlurRadius: number

Controls the blurring size used when casting shadows from this LightSource.

shadowColor

shadowColor: vec4

Controls the color used when casting shadows from this LightSource.

shadowDensity

shadowDensity: number

The lightness and darkness value of the shadow cast by objects from this light source.

shadowFrustumFarClipPlane

shadowFrustumFarClipPlane: number

The maximum distance at which shadows will be calculated for this LightSource.

shadowFrustumNearClipPlane

shadowFrustumNearClipPlane: number

The minimum distance at which shadows will be calculated for this LightSource.

shadowFrustumSize

shadowFrustumSize: number

The simulated distance of the light source from objects to calculate the softness of the shadow.

specularEnvmapTexture

specularEnvmapTexture: Texture

A color image applied to an imaginary skybox the light source will use for specular and reflection information.

ReadonlyuniqueIdentifier

uniqueIdentifier: string

useEnvmap

useEnvmap: boolean

Enable if you would like the LightSource to use information from the diffuseEnvmapTexture for light color information.

Methods

destroy

  • destroy(): void

    Destroys the component.

    Returns void

getSceneObject

getTransform

getTypeName

  • getTypeName(): string

    Returns the name of this object's type.

    Returns string

isOfType

  • isOfType(type: string): boolean

    Returns true if the object matches or derives from the passed in type.

    Parameters

    • type: string

    Returns boolean

isSame

  • isSame(other: ScriptObject): boolean

    Returns true if this object is the same as other. Useful for checking if two references point to the same thing.

    Parameters

    Returns boolean

Settings

Member Visibility

On This Page

Constructors
Properties
Methods
MMNEPVFCICPMFPCPTTAAATR