lightmapsettings.lightprobes
This is an old revision of the document!
Light Probes
- Unity stores the probes for all loaded scenes into the LightingData.asset file, even when baking only a single scene.
LightmapSettings.lightProbes
Honestly, I'm still fairly fuzzy on how this field works. Here's the best of my knowledge.
- The
LightmapSettings.lightProbesstores the light probes all scenes currently loaded. It is a single merged array of lightProbes, which is updated whenever a scene is additively loaded or removed. - When a scene is unloaded, LightmapSettings.lightProbes will still
- Presumably, the values in
LightingData.assetare baked into the scene during standalone build. - The Object
LightmapSettings.lightProbeslives within the active scene'sLightingData.assetlighting asset. - Changing the active scene in the Editor changes the
LightmapSettings.lightProbesreference to the active scene's lighting data. If the active scene does not have valid lighting data, the old light probes are left in the lighting cache. - If you try to set LightmapSettings.lightProbes, this can result in an error “pred(*previous, *i)”
There is no way to manually specify light probes, as far as I'm aware. The only mutable field on LightmapSettings.lightProbes are the spherical harmonic values (LightmapSettings.lightProbes.bakedProbes). You can blend and modify the lighting values of the probes, but there is no way to fully create new probes at runtime, even if you have the positions and values. Probes cannot be moved at runtime, because the positions array has no setter.
LightmapSettings.lightProbes will be null if there is no valid lighting data in the active scene.
lightmapsettings.lightprobes.1612893737.txt.gz · Last modified: 2025/01/15 04:35 (external edit)