SceneEnvironment QML Type

该属性控制渲染场景时应用的抗锯齿模式。

可能的值有

默认值为SceneEnvironment.NoAA 。

超采样

以较高分辨率渲染场景，然后缩放到实际分辨率。

优点高质量。可反差所有场景内容，而不仅仅是几何轮廓。

缺点：通常比 MSAA 更昂贵。会增加视频内存使用量。支持View3D 项目中除 Inline 之外的所有渲染模式，但由于该技术意味着首先要渲染到纹理，因此使用 Underlay 或 Overlay 渲染模式启用 SSAA 会导致使用通常不需要的中间纹理和渲染传递，这意味着性能成本可能会更加明显。建议仅在默认渲染模式为 "离屏 "时使用 SSAA。

多重采样

对几何体的边缘进行超级采样，使轮廓更加平滑。但这种技术对几何体内部的材质没有影响。

优点适用于任何View3D 项目，与渲染模式无关。对几何体轮廓的效果很好，因为在几何体轮廓中混叠现象通常最明显；在快速动画中也能正常工作。性能完全取决于系统（GPU）的能力。

缺点：无助于解决纹理或反射问题。会增加视频内存使用量。在性能较弱的图形硬件上使用可能比较昂贵。可根据 renderMode 控制每个窗口或单个View3D 项目。在使用已应用特效的 Underlay/Overlay 或 Offscreen 时，可为每个View3D 项目控制 MSAA。另一方面，使用不带任何效果的 Underlay/Overlay 或 Inline 会使 MSAA 受控于每个窗口。

渐进式抗锯齿

该属性用于启用和设置应用于场景的渐进抗锯齿级别。

当场景中的所有内容都停止移动时，摄像机会在帧与帧之间轻微抖动，每个新帧的结果都会与之前的帧混合。累积的帧数越多，效果越好。

优点当场景中的所有内容都静止不动时，效果会很好。

缺点：在发生任何视觉变化时都不会生效。由于需要累积和混合，因此成本较高。增加视频内存使用量。

有关抗锯齿方法的更多讨论，请参阅 "抗锯齿最佳实践"。

此属性设置应用于场景的抗锯齿级别。行为取决于所使用的antialiasingMode 。当antialiasingMode 属性设置为NoAA 时，该属性不会产生影响。

可能的值有

默认值为SceneEnvironment.High

该属性定义了防止物体在近距离显示环境遮挡的截止距离。数值越大，在出现环境遮挡之前物体之间所需的距离就越长。

默认值为 0.0。

该属性大致定义了环境闭塞阴影从物体扩散的距离。距离越远，对性能的影响越大。

默认值为 5.0。

图片为默认aoSoftness 和最大aoStrength ：

另请参见 aoStrength 和aoSoftness 。

当启用该属性时，它会分散环境闭塞阴影带的边缘，以提高平滑度（有时可能会产生明显的图案伪影）。

默认值为false 。

另请参阅 PerspectiveCamera.clipFar 和OrthographicCamera.clipFar 。

启用或禁用环境遮蔽。

默认值为false ，表示已禁用环境遮蔽。

该属性在 Qt 6.5 中引入。

另请参见 aoStrength 和aoDistance 。

该属性以牺牲性能为代价定义环境闭塞的质量（更多灰色阴影）。

值必须为 2、3 或 4。默认值为 2。

该属性定义环境遮蔽阴影边缘的平滑程度。

数值必须在 0.0 和 50.0 之间。默认值为 50.0。

图片为默认值aoDistance 和最大值aoStrength ：

另请参见 aoStrength 和aoDistance 。

该属性定义了所应用的环境隐蔽量。环境遮蔽是一种近似全局光照的形式，会在物体靠近时产生非定向的自阴影。值为 100 时，会产生全黑阴影；值越小，阴影越淡。如果数值为 0，则会完全禁用环境光遮蔽，从而提高性能，但会影响场景中 3D 物体渲染的视觉逼真度。

0 以外的所有值对性能的影响相同。

默认值为 0.0。最大值为 100.0。

值为 0 相当于将aoEnabled 设置为 false。

图中为默认的aoSoftness 和aoDistance ：

另请参见 aoEnabled,aoDistance, 和aoSoftness 。

该属性控制是否以及如何清除场景背景。

默认值为SceneEnvironment.Transparent

以下面的示例为例。苏珊娜模型应使用balsam 工具进行预处理，并来自glTF 示例模型库。

import QtQuick
import QtQuick3D
import QtQuick3D.Helpers

Item {
    width: 1280
    height: 720

    View3D {
        id: v3d
        anchors.fill: parent

        environment: ExtendedSceneEnvironment {
            backgroundMode: SceneEnvironment.SkyBox
            lightProbe: Texture { source: "00455_OpenfootageNET_field_low.hdr" }

            glowEnabled: true
            glowStrength: 1.25
            glowBloom: 0.25
            glowBlendMode: ExtendedSceneEnvironment.GlowBlendMode.Additive
        }

        DirectionalLight {
        }

        Suzanne {
            scale: Qt.vector3d(50, 50, 50)
            z: -500
        }

        PerspectiveCamera {
            id: camera
        }

        WasdController {
            controlledObject: camera
        }
    }
}

除了使用DirectionalLight 之外，我们还使用了基于图像的照明，并将探针纹理用作天空盒，结果如下：

如果没有光探测器会发生什么？

backgroundMode: SceneEnvironment.Transparent

这里的背景不是由View3D 提供的，而是由托管 2D 和 3D 场景的QQuickWindow 或QQuickView 提供的。照明仅基于DirectionalLight 。

使用固定的透明色：

backgroundMode: SceneEnvironment.Color
clearColor: "green"

另请参阅 lightProbe,QQuickWindow::setColor(),Window::color, 和View3D 。

当SceneEnvironment.Color 用于backgroundMode 属性时，该属性定义了用于清除视口的颜色。

默认值为Qt::black

另请参阅 backgroundMode 。

该属性指定了一个DebugSettings 对象，用于配置渲染器的调试工具。在构建过程中，SceneEnvironment 会自动创建一个与自身相关的DebugSettings 对象，因此通常不需要设置自定义的DebugSettings 。

启用线框模式渲染场景的示例：

可视化网格的法向量：

可视化镜面光照贡献：

该属性在 Qt 6.5 中引入。

另请参阅 DebugSettings 。

启用该属性后，渲染器会对不透明对象执行 Z-prepass（Z-prepass）处理，这意味着渲染器在渲染不透明对象时会禁用简单着色器和颜色写入功能，以便在为主要渲染处理发出绘制调用之前预先填充深度缓冲区。

这可以根据场景内容提高性能。通常情况下，有大量重叠对象和昂贵片段着色的场景会从中受益。同时，值得注意的是，渲染器会对不透明对象执行前后排序，这本身就有助于减少不必要的片段着色，因此 Z-prepass 并不总能带来显著的改善。

在使用平铺渲染架构（这在移动和嵌入式系统中很常见）的 GPU 上，建议将其设置为false 。

默认值为false 。

默认值为true 。默认情况下，渲染器会将场景中的对象分类为opaque 或semi-transparent 。首先渲染opaque 列表中的对象（具有相关材质的子模型），并启用深度测试和深度写入，从而为没有半透明区域的典型 3D 物体提供最佳的 Z 剔除效果。semi-transparent 列表中的物体将在禁用深度写入的情况下进行渲染，但仍会启用深度测试（针对不透明物体进行测试），并按照从后向前的顺序（根据中心点与摄像机的距离排序）进行渲染。这样就可以正确混合（"透视"）三维物体的表面半透明区域，这些半透明区域可能是由于node opacity ，也可能是由于材质中的某些颜色或纹理贴图。

将此属性设置为false 时，Z 缓冲区不会被写入并进行测试，深度测试也会被跳过，所有物体（包括完全不透明的物体）都会按从前到后的顺序一次性渲染。

将此属性设置为false 应该很少需要。在一些场景中，使用两轮渲染的好处不大，因为不透明对象很少，或者这些对象的变换方式使得从后往前排序的单次渲染效果更好，这时就需要使用该属性。

此属性包含将应用于整个视口的后处理效果列表。每种效果的结果都会反馈给下一种效果，因此顺序非常重要。

当此属性设置为有效的Fog 对象时，它将用于配置渲染器的内置雾化支持。

默认值为空，表示没有雾。这相当于将enabled 设置为 false 的雾对象。

此属性在 Qt 6.5 中引入。

另请参阅 Fog 。

该属性定义了用于场景照明的图像，可以代替标准灯光，也可以作为标准灯光的补充。

图像最好是高动态范围图像或预生成的立方体地图。由于无需在滤波和生成立方体贴图上花费时间，预制图像在运行时可大大提高性能。如果源文件是 .hdr 或其他图像，基于 GPU 的预处理会在加载图像文件后的运行时进行，这可能会耗费大量时间，尤其是在嵌入式和移动硬件上。因此，强烈建议应用程序最迟在构建时对 .hdr 图像进行预处理，如此处所述。

有关基于图像的照明的更多信息，请参阅使用基于图像的照明。

下面的示例是通过改变以下场景环境中的backgroundMode 生成的。该场景没有 DirectionLight、PointLight 或SpotLight 。所有照明均基于全景 HDRI 图像。

import QtQuick
import QtQuick3D
import QtQuick3D.Helpers

Item {
    width: 1280
    height: 720

    View3D {
        id: v3d
        anchors.fill: parent

        environment: ExtendedSceneEnvironment {
            backgroundMode: SceneEnvironment.SkyBox
            lightProbe: Texture { source: "00455_OpenfootageNET_field_low.hdr" }

            tonemapMode: SceneEnvironment.TonemapModeFilmic
            sharpnessAmount: 0.4

            glowEnabled: true
            glowStrength: 1.25
            glowBloom: 0.25
            glowBlendMode: ExtendedSceneEnvironment.GlowBlendMode.Additive
        }

        Node {
            scale: Qt.vector3d(100, 100, 100)

            Sponza {
            }

            Suzanne {
                y: 1
                scale: Qt.vector3d(0.5, 0.5, 0.5)
                eulerRotation.y: -90
            }
        }

        PerspectiveCamera {
            id: camera
            y: 100
        }

        WasdController {
            controlledObject: camera
        }
    }
}

上述环境下的结果：

将backgroundMode 切换为SceneEnvironment.Transparent 会得到以下结果：

在这里，三维场景的照明与之前相同，这意味着材质在照明计算中使用光探针的方式与之前相同，但没有渲染天空盒。背景是白色的，因为这是托管 2D 和 3D 场景的QQuickWindow 的默认透明色。

将 lightProbe 属性值设回默认的空值是有效的。这样就取消了之前关联纹理的分配。例如，让我们使用 Delete 键在基于图像的天空盒照明和不基于图像的背景固定透明色照明之间进行动态切换：

environment: ExtendedSceneEnvironment {
    id: env

    backgroundMode: SceneEnvironment.SkyBox
    lightProbe: iblTex

    tonemapMode: SceneEnvironment.TonemapModeFilmic
    sharpnessAmount: 0.4

    glowEnabled: true
    glowStrength: 1.25
    glowBloom: 0.25
    glowBlendMode: ExtendedSceneEnvironment.GlowBlendMode.Additive
}

Texture {
    id: iblTex
    source: "00455_OpenfootageNET_field_low.hdr"
}

focus: true
Keys.onDeletePressed: {
    if (env.backgroundMode == SceneEnvironment.SkyBox) {
        env.backgroundMode = SceneEnvironment.Color;
        env.clearColor = "green";
        env.lightProbe = null;
    } else {
        env.backgroundMode = SceneEnvironment.SkyBox;
        env.lightProbe = iblTex;
    }
}

按下 Delete 键的结果如下。请记住，这里使用的场景没有灯光，因此所有 3D 模型看起来都是全黑的。

虽然 lightProbe 通常与从图像文件（通常为 .hdr 或 .ktx）中获取数据的纹理实例结合使用，但它也可以与使用内存procedurally generated image data 的纹理实例结合使用。一个典型的例子就是纹理，其中的图像数据由ProceduralSkyTextureData 从QtQuick3D.Helpers 模块生成：

backgroundMode: SceneEnvironment.SkyBox
lightProbe: Texture {
    textureData: ProceduralSkyTextureData {
    }
}

这样我们就得到了一个程序化生成的 HDR 天幕纹理，它现在既可用作天幕，也可用于基于图像的照明：

另请参阅 backgroundMode,使用基于图像的照明,预生成 IBL 立方体地图,probeExposure,probeHorizon,probeOrientation, 和ProceduralSkyTextureData 。

当此属性设置为有效的 Lightmapper 对象时，烘焙光贴图时将考虑该对象指定的设置。

默认值为空，这意味着所有与烘焙相关的设置都将使用默认值。

有关如何烘焙光贴图的更多信息，请参阅Lightmapper 文档。

如果光照贴图与应用程序无关，且从未生成烘焙光照，则该属性和相关对象在实践中没有任何作用。

另请参阅 Model::usedInBakedLighting,Model::bakedLightmap,Light::bakeMode, 和Lightmapper 。

该属性包含 "阶独立透明度 "方法。将此属性设置为有效的 OIT 方法会使呈现器按照正确的深度顺序呈现透明像素。

可能的值有

默认值为None ，阶次独立透明度关闭。

加权混合

近似于阶次无关透明。透明片段被渲染到屏幕外的缓冲区，同时根据每个片段到摄像机的距离对其进行加权。然后在对每个像素去重后，将该缓冲区与后缓冲区混合。这种方法并不遵循所有片段的源过合成规则，因此结果与正确的结果不同，但这种方法也适用于较旧的硬件，而且比其他更严格的方法更快。

此属性在 Qt 6.9 中引入。

该属性可修改光探针发出的光量。色调映射的一部分是曝光映射，该属性调整光探针中的光值如何进行色调映射。

默认情况下，曝光值设置为 1.0。

另请参阅 lightProbe,probeHorizon, 和probeOrientation 。

该属性定义为递增值时，会在环境的下半部分增加黑暗（黑色），迫使照明主要来自图像的顶部（并消除下半部分的特定反射）。该属性可用于考虑地平面，因为地平面会遮挡探针从地面反射的光线。这是必要的，因为光探头的贡献直接来自图像，而不考虑场景的内容。

probeHorizon 属性的预期值范围在 0.0 和 1.0 之间。任何超出此范围的值都将被箝制在预期范围内。

默认情况下，probeHorizon 设置为 0.0，这意味着使用整个光线探针而无需调整。

另请参阅 lightProbe,probeExposure, 和probeOrientation 。

该属性用于定义探针的方向。方向是以 x、y 和 z 轴上的欧拉角为单位定义的。

另请参阅 lightProbe,probeHorizon, 和probeExposure 。

该属性在视图坐标中定义了一个剪刀矩形，其左上角位于 [0, 0] 处。

此属性在 Qt 6.5 中引入。

当背景模式为SkyBoxCubeMap 时，该属性定义了用作天空盒的立方体地图。

该属性在 Qt 6.4 中引入。

当SceneEnvironment.SkyBox 用于backgroundMode 属性时，该属性决定天空盒的模糊程度。默认值为0.0 ，表示不模糊。

可接受的值范围在 0.0 和 1.0 之间，所有其他值将被箝制在此范围内。

该属性在 Qt 6.4 中引入。

启用该属性后，镜面反射将得到缓解。镜面反差通常以亮点的形式出现，在移动摄像头时可能会闪烁。

默认值为 false。

此属性在 Qt 6.4 中引入。

启用该属性后，将使用时态抗锯齿。

摄像机会在帧与帧之间轻微抖动，每个新帧的结果都会与前一帧混合。

优点由于摄像机的抖动，它可以找到原本丢失的真实细节；对性能影响较小。

缺点：快速移动的物体会造成单帧重影。

该属性可修改时间移动量（抗锯齿）。只有当temporalAAEnabled 属性为 true 时才会生效。

另请参阅 temporalAAEnabled 。

该属性定义了在渲染前如何对颜色进行色调映射。Qt Quick 3D 中的所有渲染都是在线性色彩空间中进行的，在很多情况下会产生无法显示的色彩值。tonemapMode 决定了用于将颜色重新映射到可显示范围的技术。

默认值为SceneEnvironment.TonemapModeLinear

有关这些不同模式的示例，请参阅ExtendedSceneEnvironment 。

此属性在 Qt 6.0 中引入。