API reference

Every public class, method, and event in @codexo/exojs. Generated from source.

C

classLightmapLighting

@codexo/exojs-lighting / lighting / stable

Lighting accumulated into a target of its own and multiplied onto the frame. ```ts const lighting = new LightmapLighting(app, { lightResolution: 0.5, shadowResolution: 256 }); scene.systems.add(lighting); lighting.occludeFrom(new PhysicsOccluder(world)); ``` Light no longer costs a loop iteration per fragment per light, so there is no cap on how many there may be, and the accumulated field is a texture a shadow term folds into: each light gets one polar row built from the registered occluder sources. Normals come from a prepass over the surfaces registered with Lighting.normalsFrom rather than from a material. The host is required and is the first argument: this renderer lights the frame that host drew, installs its passes in that host's frame slot, and follows its surface when it resizes. It is read, never owned.

11
props
11
methods
0
events
Import
import { LightmapLighting } from '@codexo/exojs-lighting'

Lighting accumulated into a target of its own and multiplied onto the frame.

```ts const lighting = new LightmapLighting(app, { lightResolution: 0.5, shadowResolution: 256 });

scene.systems.add(lighting); lighting.occludeFrom(new PhysicsOccluder(world)); ```

Light no longer costs a loop iteration per fragment per light, so there is no cap on how many there may be, and the accumulated field is a texture a shadow term folds into: each light gets one polar row built from the registered occluder sources. Normals come from a prepass over the surfaces registered with Lighting.normalsFrom rather than from a material.

The host is required and is the first argument: this renderer lights the frame that host drew, installs its passes in that host's frame slot, and follows its surface when it resizes. It is read, never owned.

Constructors1
new(host: LightingHostWhat a lighting system needs of the application whose frame it lights. A renderer that composes the frame reads the drawn frame, installs its passes in the fra…, options: FrameLightingOptionsWhat LightmapLighting and RadianceLighting both take.): LightmapLighting
Methods11
add(light: T): T
Register a light and return it, so it can be created, parented and registered in one expression. Registering the same light twice shades it twice; the second registration is ignored instead.
clear(): this
Unregister every light.
clearOccluders(): this
Unregister every occluder source.
clearSurfaces(): this
Unregister every normal surface.
destroy(): void
Release the renderer's resources. Registered lights and sources are unregistered, not destroyed.
normalsFrom(drawable: T, normals: NormalSourceWhere a LitMaterial takes its surface normals from. An object rather than a name, so a source carries its own parameters and a user can add one: anything that…): T
Give a drawable surface normals, and return it so it can be created, parented and registered in one expression. ts lighting.normalsFrom(crate, new NormalMap(crateNormals)); Only lightmap reads these. forward shades inside the sprite stage and takes its normals from LitMaterial instead, and radiance gathers each probe's rays into one arriving colour, which leaves no incident direction at a fragment for a normal to be measured against - under both, registering a surface is recorded and ignored, and activeSurfaceCount stays at zero. Nothing is required of a drawable that is not registered: it is lit as a plane, which is what the renderer already assumed of everything. The drawable and the source are the caller's; the system only reads them. Registering the same drawable twice replaces its source rather than describing the surface twice.
occludeFrom(source: T): T
Register something that blocks light, and return it so it can be built and registered in one expression. Only a renderer with shadows reads them - forward has no light field to darken, and skips collecting entirely. ts lighting.occludeFrom(new PhysicsOccluder(world)); The source is asked, once per frame, for the edges in the region the visible lights jointly reach. It is the caller's; the system only reads it. Registering the same source twice collects it twice, so the second registration is ignored instead.
remove(light: LightBase class for every light: a scene node that emits rather than draws. Being a node is the point. A light parents to whatever carries it - a torch to the playe…): boolean
Unregister a light. Returns false when it was not registered here.
stopNormals(drawable: NormalSurfaceDrawableA drawable whose own texture, frame and layout box say where its normals belong on screen. Core's `Sprite` - and therefore `AnimatedSprite` and `Video`, which…): boolean
Take a drawable's normals away again. Returns false when it had none here.
stopOccluding(source: OccluderSourceSomething that can say which edges block light in a region. Occluders are registered sources rather than a flag on a drawable. A flag would put lighting vocabu…): boolean
Unregister an occluder source. Returns false when it was not registered here.
update(): void
System update phase: publish this frame's lights, occluders and surfaces to the renderer.
Properties11
ambient: Color32-bit RGBA color value with channel-wise accessors. Red, green, and blue are integers in 0..255; alpha is a float in 0..1. Out-of-range values are saturated o…
Baseline colour applied to every lit fragment. Mutable; re-read every frame.
activeLightCount: number
Lights the last frame actually shaded with. Lower than lights when some are disabled, have no intensity, or fall beyond what the renderer in use can carry.
activeSurfaceCount: number
Surfaces the last frame actually took normals from. Lower than surfaces when some are hidden or carry no texture, and zero under every renderer but lightmap. See normalsFrom.
debug: LightingDebugViewIntermediate to draw instead of the shaded frame. `null` shades normally. - `'light'` shows the accumulated light field on its own, which is how you see where…
Intermediate to show instead of the shaded frame. See LightingDebugView.
debugExposure: number
Scale applied to the shaded output, 1 by default. It moves the exposure only: the lights, the transport and the bounce history are all untouched, so raising it shows what a light field holds above 1.0 without changing what any of it computed. That is what makes it the right knob for looking at an overbright scene - turning a light down instead would change the scene being looked at. Under forward, where nothing is composited, it does nothing. It is not a tone map: values still clip, one stop further along.
hdr: boolean
Whether light accumulates with headroom above 1.0, so that overlapping lights add up instead of saturating to white and a filter over the frame has something above the clipping point to work with. false under forward, which shades straight into the frame, and under lightmap on a WebGL2 context without EXT_color_buffer_float. The picture is still correct there - it clips earlier, and a bloom keyed on a threshold near 1.0 finds little to bloom.
lights: readonly LightBase class for every light: a scene node that emits rather than draws. Being a node is the point. A light parents to whatever carries it - a torch to the playe…[]
Registered lights, in registration order.
occluders: readonly OccluderSourceSomething that can say which edges block light in a region. Occluders are registered sources rather than a flag on a drawable. A flag would put lighting vocabu…[]
Registered occluder sources, in registration order.
post: readonly FilterAbstract base class for post-process filters applied to a drawable's render output. Filters are rendered into a temporary RenderTexture (the `output`) that is…[]
Filters over the shaded frame, in order. Caller-owned and fixed for this system's lifetime.
quality: LightingQualityWhich renderer shades the scene, as Lighting.quality reports it. A scene never names one: it constructs the system it wants - see ForwardLighting, LightmapLigh…
The renderer in use.
surfaces: readonly NormalSurfaceA registered drawable and the normals it contributes.[]
Registered normal surfaces, in registration order.
Source
packages/exojs-lighting/src/LightmapLighting.ts