Light Components
Applies to SuperStage 26H2.6 and later
This folder describes the emissive, beam, effect and matrix components found inside SuperStage fixtures. It is aimed at users working with fixtures and inspecting parameters, not at C++ or Blueprint developers.
Users do not normally add these components by hand. For data-driven fixtures the components are decided by the emitters in the fixture definition: the beam kind chosen on an emitter decides which component is created at runtime. See section 4 of The Fixture Definition Asset.
1. Inheritance
UE scene component
├── SuperLightingComponent Base: lens, intensity, colour, strobe
│ └── SuperConeLightComponent In-house cone light (replaces UE SpotLight)
│ ├── SuperSpotComponent Spot
│ │ ├── SuperVolumetricBeamComponent Volumetric beam
│ │ │ └── SuperVolumetricShaperComponent Volumetric framing
│ │ └── SuperBeamComponent Material beam (Legacy)
│ │ └── SuperShaperComponent Material framing (Legacy)
│ └── SuperRayBeamComponent Ray beam
│ └── SuperWashComponent Wash
│
├── SuperEffectComponent Effect plane
├── SuperMatrixComponent Pixel matrix
└── SuperLiftComponent Z-axis lift
The last three are not lighting-component derivatives: the effect plane, the pixel matrix and the lift each hang directly off a scene component, each doing one job, outside the lens-and-cone chain.
2. Visible Capabilities
| Component | Purpose | What the user sees | Document |
|---|---|---|---|
| SuperLightingComponent | Base lens and colour/intensity control | Intensity, colour, strobe, lens material changes | 01 |
| SuperConeLightComponent | Key light projection | Floor pool, gobos, colour wheels, framing, prism | 10 |
| SuperSpotComponent | Spot control | The effect of Zoom, Frost and Iris on cone angle and softening | 02 |
| SuperVolumetricBeamComponent | Volumetric column | Aerial beam, haze, occlusion by real geometry | 11 |
| SuperVolumetricShaperComponent | Volumetric framing | Volumetric beam plus four-blade framing | 12 |
| SuperRayBeamComponent | Ray beam | Column with no optical elements, for matrix and effect fixtures | 13 |
| SuperWashComponent | Wash glow | A bounded glow in front of the head, no column | 14 |
| SuperBeamComponent | Material beam (Legacy) | Aerial beam, gobo, colour wheel, prism | 03 |
| SuperShaperComponent | Material framing (Legacy) | Four-blade framing shape and rotated pool | 04 |
| SuperEffectComponent | Light strip / effect plane material | Effect number, direction, speed, width, colour and strobe | 06 |
| SuperMatrixComponent | Segmented matrix | Per-segment colour, matrix intensity, strobe | 07 |
| SuperLiftComponent | Z-axis lift | Movement within the lift range by normalised input | 09 |
3. What Changed in This Release
| Change | Description |
|---|---|
| In-house cone light added | SuperConeLightComponent replaces the UE SpotLight, saving one engine light and one light function material instance per fixture |
| Volumetric beams became primary | The shipped library is fully migrated. Fixtures newly imported from GDTF still default to the material beam and must be switched by hand |
| Ray beam and Wash added | Ray beam for matrix / effect fixtures, Wash for colour / blinder / strobe |
| Cutting renamed to Shaper | SuperCuttingComponent → SuperShaperComponent, with redirectors so existing assets are unaffected |
| Rect component removed | The rectangular area light component is gone; surface lighting is handled by the cone light |
| Bodies out of physics and navigation | Fixture meshes no longer generate collision, overlap events or navigation data; editor-only primitives such as the orientation arrows and the address label were removed along with their scene proxies. The hook is still there — it is part of the body model |
If you are reading documentation from before 26H2.6:
SuperCuttingComponentandSuperRectComponentno longer exist in this release.
4. What Users Should Check
- Whether the corresponding emitter in the fixture definition carries this capability (Zoom, Frost, Gobo, Prism, Matrix, Lift and so on);
- Whether the channel definitions in the channel library match the console's output;
- Whether materials, atlases, prism presets and other resources exist and are bound to the definition;
- In large scenes, the final result of many simultaneous volumetric beams depends on UE render settings and hardware.
5. Not a Promise
These components do not guarantee that every fixture has the same functions. What a fixture can actually do depends on its fixture definition, channel library, bindings, material resources and project settings.
SuperLightingComponentSuperLightingComponent is the base light component used by fixture assets. It handles what every light-emitting component shares: the lens mesh and lens material, intensity, colour, strobe and visibility.SuperSpotComponentSuperSpotComponent provides the spot used by fixtures. It is built on the in-house cone light — from 26H2.6 the key light is projected by the cone light, not by a UE SpotLight.SuperBeamComponent (Material Beam)SuperBeamComponent draws a column painted onto a mesh — a cone mesh carrying the beam material. It is a separate backend from the volumetric beam.SuperShaperComponent (Material Framing)SuperShaperComponent adds four-blade framing on top of the material beam. It belongs to the old material pipeline and is kept for fallback; new content should use SuperVolumetricShaperComponent.SuperEffectComponentSuperEffectComponent is used by strip lights, effect planes, and other material-driven light effects. In source, it manages a static mesh, opaque/transparent materials, intensity, strobe, color, direction, effect index, speed, and width.SuperMatrixComponentSuperMatrixComponent is used by segmented matrix lights. It manages the matrix mesh, matrix material, segment count, segment direction, per-segment colour, intensity, strobe, and optional real per-segment lights (always spot lights — there…SuperLiftComponentSuperLiftComponent provides simple Z-axis lift movement. It takes a normalised position, a lift range and a speed, then interpolates the component's relative Z towards the target.SuperConeLightComponent (Cone Light)SuperConeLightComponent is the in-house cone light pipeline added in 26H2.6. It replaces the UE SpotLight as the fixture key light, and all three beam pipelines (volumetric, ray beam, material) are built on top of it.SuperVolumetricBeamComponent (Volumetric Beam)The volumetric beam is the default backend for the aerial column. The shipped fixture library is fully migrated to it.SuperVolumetricShaperComponent (Volumetric Framing)Volumetric framing = volumetric beam + four-blade framing. It inherits the volumetric beam, so that component's whole parameter group applies.SuperRayBeamComponent (Ray Beam)The ray beam is a volumetric beam without optical elements: no gobos, no colour wheel, no prism, no blades.SuperWashComponent (Wash)Wash is for colour fixtures, strobes and audience blinders. It draws no aerial column; instead it forms a bounded glow in front of the head.