SkyMaterial: add screenspace mode and multi-view support
Add a skyboxMode property to SkyMaterial that selects how the visible
background is produced:
- Cubemap (default): the background samples the IBL radiance cube, as
before. Cheapest per frame for a static sky.
- ScreenSpaceFull / ScreenSpaceHalf / ScreenSpaceQuarter: the sky shader
is evaluated directly on screen every frame at the given scale,
decoupling the visible background from the IBL cube. Best for dynamic
skies (moving sun, animated clouds). Half/Quarter render to a reduced
offscreen target and upscale.
In the screen-space modes the radiance cube is only generated when
something actually consumes it (image-based lighting, reflection probes,
a screen-read texture, or Cubemap mode). The sky shader pipeline build
is shared between the cube and screen-space paths, and both gain
multi-view support.
[ChangeLog][SkyMaterial] Added the skyboxMode property for direct
screen-space sky rendering, decoupled from the IBL cubemap.
Pick-to: 6.12
Change-Id: I771daecb915e8620e525457f20e4e6021a13ed1e
Reviewed-by: Jonas Karlsson <jonas.karlsson@qt.io>
| commit | a1735e464fc2f6b0211efe6f1a6681b8cd8c98ee |
| parent | b110a671e521cba5872c9f15dae4d472b2704f46 |
| author | Kristoffer Skau <kristoffer.skau@qt.io> |
| committer | Kristoffer Skau <kristoffer.skau@qt.io> |
| commit time | Thu, 18 Jun 2026 09:44:08 +0000 |
- M examples/quick3d/skymaterial/SettingsPane.qml
- M examples/quick3d/skymaterial/doc/src/skymaterial.qdoc
- M examples/quick3d/skymaterial/main.qml
- M src/quick3d/qquick3dskymaterial.cpp
- M src/quick3d/qquick3dskymaterial_p.h
- M src/runtimerender/graphobjects/qssgrenderskymaterial.cpp
- M src/runtimerender/graphobjects/qssgrenderskymaterial_p.h
- M src/runtimerender/rendererimpl/qssglayerrenderdata.cpp
- M src/runtimerender/rendererimpl/qssglayerrenderdata_p.h
- M src/runtimerender/rendererimpl/qssgrenderhelpers.cpp
- M src/runtimerender/rendererimpl/qssgrenderpass.cpp
- M src/runtimerender/rendererimpl/qssgrenderpass_p.h
- A tests/baseline/data/skymaterial/ScreenSpaceSky.qml
- A tests/baseline/data/skymaterial/ScreenSpaceSkyHalf.qml
- A tests/baseline/data/skymaterial/ScreenSpaceSkyQuarter.qml
- A tests/baseline/data/skymaterial/ScreenSpaceSkyReflectionProbe.qml
- M tests/manual/skymaterial/ManualTestSkyMaterial.qml