gpu-curtains
    Preparing search index...

    Class PointLight

    Create a point light, that is emitted from a point to all directions with an attenuation. A common use case for this type of light is to replicate the light emitted from a bare light bulb.

    This light can cast PointShadow.

    // assuming 'renderer' is a valid Camera renderer

    // this point light will not cast any shadows
    const pointLight = new PointLight(renderer, {
      color: new Vec3(1),
      intensity: 1,
      position: new Vec3(5, 2, 3),
    })

    // this point light will cast shadows
    const pointLightWithShadows = new PointLight(renderer, {
      color: new Vec3(1),
      intensity: 10,
      range: 3,
      position: new Vec3(-10, 10, -5),
      shadow: {
        intensity: 1,
      },
    })

    // this point light will ALSO cast shadows!
    const anotherPointLightWithShadows = new PointLight(renderer, {
      color: new Vec3(1),
      intensity: 5,
      range: 100,
      position: new Vec3(12, 0.5, 5),
      shadow: {}, // that's enough to start casting shadows
    })

    // this point light will cast shadows as well...
    const lastPointLightWithShadows = new PointLight(renderer, {
      color: new Vec3(1),
      intensity: 1,
      position: new Vec3(10),
    })

    // ... because we're telling it here to start casting shadows
    lastPointLightWithShadows.shadow.cast()

    Hierarchy (View Summary)

    Index

    Constructors

    constructor

    Properties

    type uuid index renderer color rendererBinding userData _onBeforeRenderCallback options shadow transforms matrices up actualPosition children object3DIndex matricesNeedUpdate

    Accessors

    visible parentVisibility actualColor intensity range parent rotation quaternion position scale transformOrigin modelMatrix worldMatrix

    Methods

    setRendererBinding onPropertyChanged onBeforeRenderScene onBeforeRender remove setRenderer reset setPosition updateMatrixStack onMaxLightOverflow destroy setTransforms applyPosition setMatrices shouldUpdateModelMatrix shouldUpdateWorldMatrix lookAt applyLookAt updateModelMatrix updateWorldMatrix shouldUpdateMatrices

    Constructors

    Properties

    type: string

    Type of the light.

    uuid: string

    The universal unique id of this Light

    index: number

    Index of this Light, i.e. the number of time a Light of this type has been created.

    renderer: CameraRenderer

    CameraRenderer used by this Light

    color: Vec3

    Current color of this Light.

    rendererBinding: BufferBinding

    CameraRenderer corresponding BufferBinding that holds all the bindings to send to the shaders.

    userData: Record<string, unknown>

    Empty object to store any additional data or custom properties into your Light.

    _onBeforeRenderCallback

    _onBeforeRenderCallback: () => void

    function assigned to the onBeforeRender callback

    options: PointLightBaseParams

    Options used to create this PointLight.

    shadow: PointShadow

    PointShadow associated with this PointLight.

    transforms: Object3DTransforms

    Transformation object of the Object3D

    matrices: Object3DMatrices

    Matrices object of the Object3D

    up: Vec3

    Vec3 used by the lookAt method, to determine the orientation of the result. Default to new Vec3(0, 1, 0).

    actualPosition: Vec3

    Vec3 holding the actual position of this Object3D from its worldMatrix.

    children: Object3D[]

    Children Object3D in the scene graph, used to compute their own worldMatrix.

    object3DIndex: number

    Index (order of creation) of this Object3D. Used in the parent / children relation.

    matricesNeedUpdate: boolean

    Whether at least one of this Object3D matrix needs an update.

    Accessors

    • get parentVisibility(): boolean

      Get whether all this Light parents are visible or not. Should not be used directly.

      Returns boolean

    • set parentVisibility(value: boolean): void

      Set this Light parent visiblity, and update its actualColor property accordingly. Should not be used directly.

      Parameters

      • value: boolean

      Returns void

    Methods

    • Callback to execute before updating the Scene matrix stack. This means it is called early and allows to update transformations values before actually setting the Light matrices. The callback won't be called if the renderer is not ready.

      Parameters

      • callback: () => void

        callback to run just before updating the Scene matrix stack.

      Returns this

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Accessors
    Methods