Revision control
Copy as Markdown
// Copyright (C) 2025 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\title Qt Quick 3D - SSGI Lightmap Example
\example ssgilightmap
\ingroup quick3d-examples
\brief An example showing scenes using SSGI and Lightmaps.
\examplecategory {3D}
\meta {tag} {quick, 3d, ssgi, lightmaps}
\meta {docdependencies} {QtQuick3D}
\image {ssgilightmap-screenshot.webp} {A 3D scene showing a cabin bedroom}
This example demonstrates two global illumination techniques available in
Qt Quick 3D: Screen Space Global Illumination (SSGI) and baked lightmaps.
It allows comparing the visual differences and performance characteristics of
real-time and precomputed lighting.
The application includes three common test scenes used to evaluate rendering:
\list
\li Cornell Box -
A classic lighting test setup highlighting diffuse
color bleeding and indirect illumination.
\li Bedroom -
An indoor environment with soft, warm lighting and a
mixture of materials and occluded spaces.
\li Sponza Atrium -
A large architectural test scene with drapery,
arcades, and multiple layers of indirect lighting.
\endlist
Each scene provides a number of predefined camera positions. A built-in
Demo mode automatically cycles through these viewpoints to show how the
lighting behaves from different angles.
The lighting mode can be changed at runtime to one of the following:
\list
\li SSGI -
Enables real-time, screen-space global illumination.
This is controlled through the
\l{Qt Quick 3D Helpers::ExtendedSceneEnvironment::ssgiEnabled}{ssgiEnabled}
property of \l{Qt Quick 3D Helpers::ExtendedSceneEnvironment}{ExtendedSceneEnvironment}.
SSGI offers dynamic indirect lighting suitable for interactive and animated
content, at some performance cost and with approximations inherent to
screen-space techniques.
\li Baked Lightmaps -
Uses precomputed direct, indirect, or both lighting stored in texture lightmaps.
Lightmap baking is performed offline by the Qt Quick 3D Lightmap Baker.
See \l{Qt Quick 3D Lightmap Baking}{Lightmap Baking} for details.
This provides high-quality, path-traced illumination with very low
runtime cost, best suited for mostly static environments.
\li Off -
Disables both SSGI and baked lightmaps for comparison against direct
lighting only.
\endlist
\sa {Qt Quick 3D Helpers::ExtendedSceneEnvironment::ssgiEnabled}{ExtendedSceneEnvironment::ssgiEnabled}
\sa {Qt Quick 3D Lightmap Baking}
*/