HemisphericLight

The HemisphericLight simulates the ambient environment light, so the passed direction is the light reflection direction, not the incoming direction.

Hierarchy

Index

Constructors

constructor

  • Creates a HemisphericLight object in the scene according to the passed direction (Vector3). The HemisphericLight simulates the ambient environment light, so the passed direction is the light reflection direction, not the incoming direction. The HemisphericLight can't cast shadows. Documentation : http://doc.babylonjs.com/tutorials/lights

    Parameters

    • name: string

      The friendly name of the light

    • direction: Vector3

      The direction of the light reflection

    • scene: Scene

      The scene the light belongs to

    Returns HemisphericLight

Properties

animationPropertiesOverride

animationPropertiesOverride: Nullable<AnimationPropertiesOverride>

Gets or sets the animation properties override

animations

animations: Animation[]

Gets a list of Animations associated with the node

behaviors

behaviors: Behavior<Node>[]

Gets the list of attached behaviors

see

http://doc.babylonjs.com/features/behaviour

diffuse

diffuse: Color3

Diffuse gives the basic color to an object.

direction

direction: Vector3

The light reflection direction, not the incoming direction.

doNotSerialize

doNotSerialize: boolean

Gets or sets a boolean used to define if the node must be serialized

excludeWithLayerMask

excludeWithLayerMask: number

Sets the layer id use to find what meshes are not impacted by the light. Inactive if 0

excludedMeshes

excludedMeshes: AbstractMesh[]

Sets the meshes not impacted by this light.

groundColor

groundColor: Color3

The groundColor is the light in the opposite direction to the one specified during creation. You can think of the diffuse and specular light as coming from the centre of the object in the given direction and the groundColor light in the opposite direction.

id

id: string

Gets or sets the id of the node

includeOnlyWithLayerMask

includeOnlyWithLayerMask: number

Sets the layer id use to find what meshes are impacted by the light. Inactive if 0

includedOnlyMeshes

includedOnlyMeshes: AbstractMesh[]

Sets the only meshes impacted by this light.

intensity

intensity: number

Strength of the light. Note: By default it is define in the framework own unit. Note: In PBR materials the intensityMode can be use to chose what unit the intensity is defined in.

intensityMode

intensityMode: number

Sets the photometric scale used to interpret the intensity. This is only relevant with PBR Materials where the light intensity can be defined in a physical way.

lightmapMode

lightmapMode: number

Sets the lightmap mode of this light (should be one of the constants defined by Light.LIGHTMAP_x)

metadata

metadata: any

Gets or sets an object used to store user defined information for the node

name

name: string

Gets or sets the name of the node

onDispose

onDispose: function

Sets a callback that will be raised when the node will be disposed

Type declaration

    • (): void
    • Returns void

onDisposeObservable

onDisposeObservable: Observable<Node>

An event triggered when the mesh is disposed

onReady

onReady: function

Callback raised when the node is ready to be used

Type declaration

    • (node: Node): void
    • Parameters

      Returns void

parent

parent: Nullable<Node>

Gets or sets the parent of the node

radius

radius: number

sets the light radius used by PBR Materials to simulate soft area lights.

range

range: number

Defines how far from the source the light is impacting in scene units. Note: Unused in PBR material as the distance light falloff is defined following the inverse squared falloff.

renderPriority

renderPriority: number

Defines the rendering priority of the lights. It can help in case of fallback or number of lights exceeding the number allowed of the materials.

shadowEnabled

shadowEnabled: boolean

Defines wether or not the shadows are enabled for this light. This can help turning off/on shadow without detaching the current shadow generator.

specular

specular: Color3

Specular produces a highlight color on an object. Note: This is note affecting PBR materials.

state

state: string

Gets or sets a string used to store user defined state for the node

uniqueId

uniqueId: number

Gets or sets the unique id of the node

Static INTENSITYMODE_AUTOMATIC

INTENSITYMODE_AUTOMATIC: number

Each light type uses the default quantity according to its type: point/spot lights use luminous intensity directional lights use illuminance

Static INTENSITYMODE_ILLUMINANCE

INTENSITYMODE_ILLUMINANCE: number

lux (lm/m^2)

Static INTENSITYMODE_LUMINANCE

INTENSITYMODE_LUMINANCE: number

nit (cd/m^2)

Static INTENSITYMODE_LUMINOUSINTENSITY

INTENSITYMODE_LUMINOUSINTENSITY: number

candela (lm/sr)

Static INTENSITYMODE_LUMINOUSPOWER

INTENSITYMODE_LUMINOUSPOWER: number

lumen (lm)

Static LIGHTMAP_DEFAULT

LIGHTMAP_DEFAULT: number

If every light affecting the material is in this lightmapMode, material.lightmapTexture adds or multiplies (depends on material.useLightmapAsShadowmap) after every other light calculations.

Static LIGHTMAP_SHADOWSONLY

LIGHTMAP_SHADOWSONLY: number

material.lightmapTexture as only lighting no light calculation from this light only adds dynamic shadows from this light

Static LIGHTMAP_SPECULAR

LIGHTMAP_SPECULAR: number

material.lightmapTexture as only diffuse lighting from this light adds only specular lighting from this light adds dynamic shadows

Static LIGHTTYPEID_DIRECTIONALLIGHT

LIGHTTYPEID_DIRECTIONALLIGHT: number

Light type const id of the directional light.

Static LIGHTTYPEID_HEMISPHERICLIGHT

LIGHTTYPEID_HEMISPHERICLIGHT: number

Light type const id of the hemispheric light.

Static LIGHTTYPEID_POINTLIGHT

LIGHTTYPEID_POINTLIGHT: number

Light type const id of the point light.

Static LIGHTTYPEID_SPOTLIGHT

LIGHTTYPEID_SPOTLIGHT: number

Light type const id of the spot light.

Methods

addBehavior

beginAnimation

  • beginAnimation(name: string, loop?: boolean, speedRatio?: number, onAnimationEnd?: function): Nullable<Animatable>
  • Will start the animation sequence

    Parameters

    • name: string

      defines the range frames for animation sequence

    • Optional loop: boolean

      defines if the animation should loop (false by default)

    • Optional speedRatio: number

      defines the speed factor in which to run the animation (1 by default)

    • Optional onAnimationEnd: function

      defines a function to be executed when the animation ended (undefined by default)

        • (): void
        • Returns void

    Returns Nullable<Animatable>

    the object created for this animation. If range does not exist, it will return null

canAffectMesh

  • Specifies if the light will affect the passed mesh.

    Parameters

    Returns boolean

    true the mesh is affected otherwise, false.

clone

  • Returns a new Light object, named "name", from the current one.

    Parameters

    • name: string

      The name of the cloned light

    Returns Nullable<Light>

    the new created light

computeWorldMatrix

  • computeWorldMatrix(force?: boolean): Matrix
  • Computes the world matrix of the node

    Parameters

    • Optional force: boolean

      defines if the cache version should be invalidated forcing the world matrix to be created from scratch

    Returns Matrix

    the world matrix

createAnimationRange

  • createAnimationRange(name: string, from: number, to: number): void
  • Creates an animation range for this node

    Parameters

    • name: string

      defines the name of the range

    • from: number

      defines the starting key

    • to: number

      defines the end key

    Returns void

deleteAnimationRange

  • deleteAnimationRange(name: string, deleteFrames?: boolean): void
  • Delete a specific animation range

    Parameters

    • name: string

      defines the name of the range to delete

    • Optional deleteFrames: boolean

      defines if animation frames from the range must be deleted as well

    Returns void

dispose

  • dispose(doNotRecurse?: boolean, disposeMaterialAndTextures?: boolean): void
  • Releases resources associated with this node.

    Parameters

    • Optional doNotRecurse: boolean

      Set to true to not recurse into each children (recurse into each children by default)

    • Optional disposeMaterialAndTextures: boolean

      Set to true to also dispose referenced materials and textures (false by default)

    Returns void

getAbsolutePosition

  • Returns a Vector3, the absolute light position in the World.

    Returns Vector3

    the world space position of the light

getAnimationByName

  • Get an animation by name

    Parameters

    • name: string

      defines the name of the animation to look for

    Returns Nullable<Animation>

    null if not found else the requested animation

getAnimationRange

  • Get an animation range by name

    Parameters

    • name: string

      defines the name of the animation range to look for

    Returns Nullable<AnimationRange>

    null if not found else the requested animation range

getBehaviorByName

getChildMeshes

  • getChildMeshes(directDescendantsOnly?: boolean, predicate?: function): AbstractMesh[]
  • Get all child-meshes of this node

    Parameters

    • Optional directDescendantsOnly: boolean

      defines if true only direct descendants of 'this' will be considered, if false direct and also indirect (children of children, an so on in a recursive manner) descendants of 'this' will be considered

    • Optional predicate: function

      defines an optional predicate that will be called on every evaluated child, the predicate must return true for a given child to be part of the result, otherwise it will be ignored

        • (node: Node): boolean
        • Parameters

          Returns boolean

    Returns AbstractMesh[]

    an array of {BABYLON.AbstractMesh}

getChildTransformNodes

  • getChildTransformNodes(directDescendantsOnly?: boolean, predicate?: function): TransformNode[]
  • Get all child-transformNodes of this node

    Parameters

    • Optional directDescendantsOnly: boolean

      defines if true only direct descendants of 'this' will be considered, if false direct and also indirect (children of children, an so on in a recursive manner) descendants of 'this' will be considered

    • Optional predicate: function

      defines an optional predicate that will be called on every evaluated child, the predicate must return true for a given child to be part of the result, otherwise it will be ignored

        • (node: Node): boolean
        • Parameters

          Returns boolean

    Returns TransformNode[]

    an array of {BABYLON.TransformNode}

getChildren

  • getChildren(predicate?: function): Node[]
  • Get all direct children of this node

    Parameters

    • Optional predicate: function

      defines an optional predicate that will be called on every evaluated child, the predicate must return true for a given child to be part of the result, otherwise it will be ignored

        • (node: Node): boolean
        • Parameters

          Returns boolean

    Returns Node[]

    an array of {BABYLON.Node}

getClassName

  • getClassName(): string
  • Returns the string "HemisphericLight".

    Returns string

    The class name

getDescendants

  • getDescendants(directDescendantsOnly?: boolean, predicate?: function): Node[]
  • Will return all nodes that have this node as ascendant

    Parameters

    • Optional directDescendantsOnly: boolean

      defines if true only direct descendants of 'this' will be considered, if false direct and also indirect (children of children, an so on in a recursive manner) descendants of 'this' will be considered

    • Optional predicate: function

      defines an optional predicate that will be called on every evaluated child, the predicate must return true for a given child to be part of the result, otherwise it will be ignored

        • (node: Node): boolean
        • Parameters

          Returns boolean

    Returns Node[]

    all children nodes of all types

getEngine

getScaledIntensity

  • getScaledIntensity(): number
  • Returns the intensity scaled by the Photometric Scale according to the light type and intensity mode.

    Returns number

    the scaled intensity in intensity mode unit

getScene

  • Gets the scene of the node

    Returns Scene

    a {BABYLON.Scene}

getShadowGenerator

getTypeID

  • getTypeID(): number
  • Returns the integer 3.

    Returns number

    The light Type id as a constant defines in Light.LIGHTTYPEID_x

isDescendantOf

  • isDescendantOf(ancestor: Node): boolean
  • Is this node a descendant of the given node? The function will iterate up the hierarchy until the ancestor was found or no more parents defined

    Parameters

    • ancestor: Node

      defines the parent node to inspect

    Returns boolean

    a boolean indicating if this node is a descendant of the given node

isDisposed

  • isDisposed(): boolean
  • Gets a boolean indicating if the node has been disposed

    Returns boolean

    true if the node was disposed

isEnabled

  • isEnabled(checkAncestors?: boolean): boolean
  • Is this node enabled? If the node has a parent, all ancestors will be checked and false will be returned if any are false (not enabled), otherwise will return true

    Parameters

    • Optional checkAncestors: boolean

      indicates if this method should check the ancestors. The default is to check the ancestors. If set to false, the method will return the value of this node without checking ancestors

    Returns boolean

    whether this node (and its parent) is enabled

isReady

  • isReady(completeCheck?: boolean): boolean
  • Is this node ready to be used/rendered

    Parameters

    • Optional completeCheck: boolean

      defines if a complete check (including materials and lights) has to be done (false by default)

    Returns boolean

    true if the node is ready

removeBehavior

serialize

  • serialize(): any
  • Serializes the current light into a Serialization object.

    Returns any

    the serialized object.

serializeAnimationRanges

  • serializeAnimationRanges(): any

setDirectionToTarget

  • Sets the HemisphericLight direction towards the passed target (Vector3). Returns the updated direction.

    Parameters

    • target: Vector3

      The target the direction should point to

    Returns Vector3

    The computed direction

setEnabled

  • setEnabled(value: boolean): void
  • Set the enabled state of this node.

    Parameters

    • value: boolean

      the new enabled state

    Returns void

toString

  • toString(fullDetails?: boolean): string
  • Converts the light information to a readable string for debug purpose.

    Parameters

    • Optional fullDetails: boolean

      Supports for multiple levels of logging within scene loading

    Returns string

    the human readable light info

transferToEffect

  • Sets the passed Effect object with the HemisphericLight normalized direction and color and the passed name (string).

    Parameters

    • effect: Effect

      The effect to update

    • lightIndex: string

      The index of the light in the effect to update

    Returns HemisphericLight

    The hemispheric light

Static CompareLightsPriority

  • CompareLightsPriority(a: Light, b: Light): number
  • Sort function to order lights for rendering.

    Parameters

    • a: Light

      First Light object to compare to second.

    • b: Light

      Second Light object to compare first.

    Returns number

    -1 to reduce's a's index relative to be, 0 for no change, 1 to increase a's index relative to b.

Static GetConstructorFromName

  • GetConstructorFromName(type: number, name: string, scene: Scene): Nullable<function>
  • Creates a new typed light from the passed type (integer) : point light = 0, directional light = 1, spot light = 2, hemispheric light = 3. This new light is named "name" and added to the passed scene.

    Parameters

    • type: number

      Type according to the types available in Light.LIGHTTYPEID_x

    • name: string

      The friendly name of the light

    • scene: Scene

      The scene the new light will belong to

    Returns Nullable<function>

    the constructor function

Static Parse

  • Parses the passed "parsedLight" and returns a new instanced Light from this parsing.

    Parameters

    • parsedLight: any

      The JSON representation of the light

    • scene: Scene

      The scene to create the parsed light in

    Returns Nullable<Light>

    the created light after parsing

Static ParseAnimationRanges

  • ParseAnimationRanges(node: Node, parsedNode: any, scene: Scene): void
  • Parse animation range data from a serialization object and store them into a given node

    Parameters

    • node: Node

      defines where to store the animation ranges

    • parsedNode: any

      defines the serialization object to read data from

    • scene: Scene

      defines the hosting scene

    Returns void

Generated using TypeDoc