SceneEnvironment QML Type

Diese Eigenschaft steuert den Antialiasing-Modus, der beim Rendern der Szene angewendet wird.

Mögliche Werte sind:

Der Standardwert ist SceneEnvironment.NoAA.

Supersampling

Die Szene wird in einer höheren Auflösung gerendert und dann auf die tatsächliche Auflösung herunterskaliert.

Vorteile: Hohe Qualität. Antialiases alle Szene Inhalt und nicht nur Geometrie Silhouetten.

Nachteile: In der Regel teurer als MSAA. Erhöht die Nutzung des Videospeichers. Unterstützt mit View3D Elementen mit allen RenderModes außer Inline, aber da die Technik voraussetzt, dass zuerst auf eine Textur gerendert wird, führt die Aktivierung von SSAA mit einem RenderMode von Underlay oder Overlay dazu, dass eine Zwischentextur und ein Renderpass verwendet werden, die normalerweise nicht erforderlich wären, was bedeutet, dass die Leistungskosten spürbarer sein können. Es wird empfohlen, SSAA nur zu verwenden, wenn der RenderMode der Standard Offscreen ist.

Multisampling

Die Kanten der Geometrie werden superabgetastet, was zu glatteren Silhouetten führt. Diese Technik hat jedoch keine Auswirkungen auf die Materialien innerhalb der Geometrie.

Vorteile: Funktioniert mit jedem View3D Element, unabhängig vom RenderMode. Gute Ergebnisse bei Geometriesilhouetten, wo Aliasing oft am auffälligsten ist; funktioniert bei schnellen Animationen ohne Probleme. Die Leistung hängt ausschließlich von den Fähigkeiten des Systems (GPU) ab.

Nachteile: Hilft nicht bei Textur- oder Reflexionsproblemen. Erhöht die Nutzung des Videospeichers. Kann auf weniger leistungsstarker Grafikhardware teuer sein. Kann je nach RenderMode pro Fenster oder für einzelne View3D Elemente gesteuert werden. Bei der Verwendung von Underlay/Overlay mit einem angewandten Effekt oder Offscreen kann MSAA für jedes Element von View3D gesteuert werden. Bei der Verwendung von Underlay/Overlay ohne Effekt oder Inline wird MSAA dagegen pro Fenster gesteuert.

Progressives Antialiasing

Diese Eigenschaft aktiviert und legt den Grad des progressiven Antialiasing fest, der auf die Szene angewendet wird.

Wenn sich der gesamte Inhalt der Szene nicht mehr bewegt, wird die Kamera zwischen den Einzelbildern leicht verwackelt, und das Ergebnis jedes neuen Einzelbildes wird mit den vorherigen Einzelbildern gemischt. Je mehr Bilder Sie anhäufen, desto besser sieht das Ergebnis aus.

Vorteile: Erzielt großartige Ergebnisse, wenn der gesamte Inhalt der Szene stillsteht.

Nachteile: Wird nicht wirksam, wenn visuelle Veränderungen stattfinden. Teuer, da die Bilder akkumuliert und gemischt werden müssen. Erhöht die Nutzung des Videospeichers.

Weitere Informationen zu Anti-Aliasing-Methoden finden Sie unter Best Practices für Anti-Aliasing.

Diese Eigenschaft legt den Grad des Antialiasing fest, der auf die Szene angewendet wird. Das Verhalten hängt von der verwendeten antialiasingMode ab. Wenn die Eigenschaft antialiasingMode auf NoAA eingestellt ist, hat diese Eigenschaft keine Auswirkung.

Mögliche Werte sind:

Der Standardwert ist SceneEnvironment.High

Diese Eigenschaft legt einen Grenzabstand fest, der verhindert, dass Objekte bei geringen Entfernungen eine Umgebungsunschärfe aufweisen. Höhere Werte erhöhen den erforderlichen Abstand zwischen den Objekten, bevor eine Umgebungsokklusion auftritt.

Der Standardwert ist 0,0.

Diese Eigenschaft legt fest, wie weit sich der Umgebungsschatten von den Objekten entfernt ausbreitet. Größere Abstände wirken sich zunehmend auf die Leistung aus.

Der Standardwert ist 5,0.

Hier abgebildet mit dem Standardwert aoSoftness und dem Maximalwert aoStrength:

Siehe auch aoStrength und aoSoftness.

Wenn diese Eigenschaft aktiviert ist, werden die Kanten der Schattenbänder der Umgebungsokklusion gestreut, um die Glättung zu verbessern (auch auf die Gefahr hin, dass manchmal offensichtliche gemusterte Artefakte entstehen).

Der Standardwert ist false.

Siehe auch PerspectiveCamera.clipFar und OrthographicCamera.clipFar.

Aktivieren oder deaktivieren Sie die Umgebungsokklusion.

Der Standardwert ist false, was bedeutet, dass die Umgebungsokklusion deaktiviert ist.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

Siehe auch aoStrength und aoDistance.

Diese Eigenschaft definiert die Qualität der Umgebungsokklusion (mehr Graustufen) auf Kosten der Leistung.

Der Wert muss 2, 3 oder 4 sein. Der Standardwert ist 2.

Diese Eigenschaft legt fest, wie glatt die Kanten der Umgebungsschattierung sind.

Der Wert muss zwischen 0,0 und 50,0 liegen. Der Standardwert ist 50,0.

Hier abgebildet mit dem Standardwert aoDistance und dem Maximalwert aoStrength:

Siehe auch aoStrength und aoDistance.

Diese Eigenschaft definiert die Stärke der Umgebungsokkusation. Ambient Occulusion ist eine Form der approximierten globalen Beleuchtung, die bei nahe beieinander liegenden Objekten eine ungerichtete Selbstabschattung bewirkt. Ein Wert von 100 bewirkt, dass die Schatten vollständig dunkel sind; niedrigere Werte lassen die Schatten heller erscheinen. Ein Wert von 0 deaktiviert die Umgebungshelligkeit vollständig und verbessert die Leistung auf Kosten des visuellen Realismus der in der Szene gerenderten 3D-Objekte.

Alle anderen Werte als 0 haben die gleichen Auswirkungen auf die Leistung.

Der Standardwert ist 0,0. Der Höchstwert ist 100,0.

Ein Wert von 0 ist gleichbedeutend mit der Einstellung aoEnabled auf false.

Hier abgebildet mit den Standardwerten aoSoftness und aoDistance:

Siehe auch aoEnabled, aoDistance und aoSoftness.

Diese Eigenschaft steuert, ob und wie der Hintergrund der Szene geleert werden soll.

Der Standardwert ist SceneEnvironment.Transparent

Nehmen Sie das folgende Beispiel. Es wird erwartet, dass das Suzanne-Modell mit dem Tool balsam vorverarbeitet wurde und aus dem glTF Sample Models Repository stammt.

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
        }
    }
}

Die Verwendung von bildbasierter Beleuchtung zusätzlich zu DirectionalLight und die Verwendung der Lichtsondentextur als Skybox führt zu folgendem Ergebnis:

Was passiert, wenn es keine Lichtsonde gibt?

backgroundMode: SceneEnvironment.Transparent

Hier wird der Hintergrund nicht von View3D, sondern von QQuickWindow oder QQuickView bereitgestellt, die die 2D- und 3D-Szene enthalten. Die Beleuchtung basiert nur auf der DirectionalLight.

Es wird eine feste klare Farbe verwendet:

backgroundMode: SceneEnvironment.Color
clearColor: "green"

Siehe auch lightProbe, QQuickWindow::setColor(), Window::color, und View3D.

Diese Eigenschaft definiert, welche Farbe verwendet wird, um das Ansichtsfenster zu löschen, wenn SceneEnvironment.Color für die Eigenschaft backgroundMode verwendet wird.

Der Standardwert ist Qt::black

Siehe auch backgroundMode.

Diese Eigenschaft spezifiziert ein DebugSettings Objekt, das verwendet wird, um die Debugging-Tools des Renderers zu konfigurieren. Während der Erstellung erstellt SceneEnvironment automatisch ein DebugSettings Objekt, das mit sich selbst verknüpft ist, und daher ist die Einstellung eines benutzerdefinierten DebugSettings normalerweise nicht erforderlich.

Ein Beispiel für das Rendern der Szene mit aktiviertem Drahtgittermodus:

Visualisierung der Normalenvektoren der Meshes:

Visualisierung des spiegelnden Beleuchtungsbeitrags:

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

Siehe auch DebugSettings.

Wenn diese Eigenschaft aktiviert ist, führt der Renderer einen Z-Prepass für opake Objekte durch, d.h. er rendert sie mit einem einfachen Shader und deaktiviertem Farbschreiben, um den Tiefenpuffer vorzufüllen, bevor er Zeichenaufrufe für die Haupt-Rendering-Passes ausgibt.

Dies kann die Leistung je nach Inhalt der Szene verbessern. In der Regel sind es Szenen mit vielen überlappenden Objekten und teurem Fragment-Shading, die hiervon profitieren. Gleichzeitig ist anzumerken, dass der Renderer bei undurchsichtigen Objekten eine Sortierung von vorne nach hinten vorn vornimmt, was an sich schon dazu beiträgt, unnötiges Fragment-Shading zu reduzieren, so dass der Z-Prepass nicht immer erhebliche Verbesserungen bringt.

Auf GPUs, die eine gekachelte Rendering-Architektur verwenden, was bei mobilen und eingebetteten Systemen üblich ist, wird empfohlen, dies auf false zu setzen.

Der Standardwert ist false.

Der Standardwert ist true. Standardmäßig klassifiziert der Renderer die Objekte in der Szene entweder als opaque oder als semi-transparent. Die Objekte (Submeshes mit dem zugehörigen Material) in der Liste opaque werden zuerst gerendert, wobei die Tiefenprüfung und das Schreiben in die Tiefe aktiviert sind, was ein optimales Z-Culling für typische 3D-Objekte ermöglicht, die keine halbtransparenten Bereiche aufweisen. Die Objekte in der Liste semi-transparent werden mit deaktivierter Tiefenschreibefunktion gerendert, aber immer noch mit aktivierter Tiefenprüfung (um gegen die undurchsichtigen Objekte zu testen), und zwar in der Reihenfolge von hinten nach vorne (sortiert nach dem Abstand ihres Mittelpunkts von der Kamera). Dies ermöglicht eine korrekte Überblendung ("Durchsicht") für 3D-Objekte, die halbtransparente Bereiche auf ihrer Oberfläche aufweisen, entweder aufgrund der node opacity oder aufgrund einer Farb- oder Texturkarte im Material.

Wenn diese Eigenschaft auf false gesetzt ist, wird der Z-Puffer nicht geschrieben und getestet, der Tiefentest wird übersprungen, und alle Objekte, auch die völlig undurchsichtigen, werden in einem Durchgang gerendert, von hinten nach vorne sortiert.

Die Einstellung dieser Eigenschaft auf false sollte selten benötigt werden. Sie kann in Szenen nützlich sein, bei denen bekannt ist, dass der Zwei-Runden-Ansatz kaum Vorteile bringt, weil es entweder nur sehr wenige undurchsichtige Objekte gibt oder diese so transformiert sind, dass ein einzelner, von hinten nach vorne sortierter Durchgang besser funktioniert.

Diese Eigenschaft enthält eine Liste von Nachbearbeitungseffekten, die auf das gesamte Ansichtsfenster angewendet werden. Das Ergebnis eines jeden Effekts wird an den nächsten weitergegeben, so dass die Reihenfolge von Bedeutung ist.

Wenn diese Eigenschaft auf ein gültiges Fog Objekt gesetzt ist, wird sie verwendet, um die eingebaute Nebelunterstützung des Renderers zu konfigurieren.

Der Standardwert ist null, was keinen Nebel bedeutet. Dies ist gleichbedeutend mit dem Setzen eines Fog-Objekts mit der Einstellung enabled auf false.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

Siehe auch Fog.

Diese Eigenschaft definiert ein Bild, das zur Beleuchtung der Szene verwendet wird, entweder anstelle von oder zusätzlich zu den Standardlichtern.

Das Bild ist vorzugsweise ein High-Dynamic-Range-Bild oder eine vorgenerierte Cubemap. Das Vorbacken bietet erhebliche Leistungsverbesserungen zur Laufzeit, da keine Zeit für Filterung und Mipmap-Generierung aufgewendet werden muss. Handelt es sich bei der Quelle um ein .hdr- oder ein anderes Bild, erfolgt die GPU-basierte Vorverarbeitung zur Laufzeit nach dem Laden der Bilddatei, was insbesondere auf eingebetteter und mobiler Hardware zeitaufwändig sein kann. Daher wird dringend empfohlen, dass Anwendungen .hdr-Bilder spätestens zum Zeitpunkt der Erstellung vorverarbeiten, wie hier beschrieben.

Weitere Informationen zur bildbasierten Beleuchtung finden Sie unter Verwendung bildbasierter Beleuchtung.

Die folgenden Beispiele wurden unter Variation der backgroundMode in der Umgebung der folgenden Szene erzeugt. Die Szene hat kein DirectionLight, PointLight oder SpotLight. Die gesamte Beleuchtung basiert auf dem HDRI-Panoramabild.

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
        }
    }
}

Ergebnisse mit der obigen Umgebung:

Ein Wechsel von backgroundMode zu SceneEnvironment.Transparent würde zu diesem Ergebnis führen:

Hier ist die Beleuchtung der 3D-Szene dieselbe wie zuvor, d. h. die Materialien verwenden die Lichtsonde in den Beleuchtungsberechnungen auf dieselbe Weise wie zuvor, aber es wird keine Skybox gerendert. Der Hintergrund ist weiß, da dies die Standardfarbe der QQuickWindow ist, die die 2D- und 3D-Szene enthält.

Es ist sinnvoll, den Wert der Eigenschaft lightProbe wieder auf den Standardwert null zu setzen. Dadurch wird die Zuweisung der zuvor zugeordneten Textur aufgehoben. Verwenden Sie beispielsweise die Entf-Taste, um dynamisch zwischen einer bildbasierten Beleuchtung mit einer Skybox und keiner bildbasierten Beleuchtung mit einer festen klaren Farbe für den Hintergrund umzuschalten:

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;
    }
}

Das Drücken der Entf-Taste führt zu folgendem Ergebnis. Denken Sie daran, dass die hier verwendete Szene keine Beleuchtung hat, so dass alle 3D-Modelle komplett schwarz erscheinen.

Während lightProbe üblicherweise in Kombination mit Textur-Instanzen verwendet wird, die ihre Daten aus einer Bilddatei beziehen (typischerweise .hdr oder .ktx), kann es auch sinnvoll sein, sie mit einer Textur zu verknüpfen, die speicherintern procedurally generated image data verwendet. Ein Paradebeispiel hierfür ist eine Textur, bei der die Bilddaten von ProceduralSkyTextureData aus dem QtQuick3D.Helpers-Modul generiert werden:

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

So erhalten wir eine prozedural generierte HDR-Skybox-Textur, die nun sowohl als Skybox als auch für die bildbasierte Beleuchtung verwendet wird:

Siehe auch backgroundMode, Image-Based Lighting verwenden, IBL-Cubemap vorgenerieren, probeExposure, probeHorizon, probeOrientation und ProceduralSkyTextureData.

Wenn diese Eigenschaft auf ein gültiges Lightmapper-Objekt gesetzt ist, werden die von diesem Objekt angegebenen Einstellungen beim Backen von Lightmaps berücksichtigt.

Der Standardwert ist null, was bedeutet, dass die Standardwerte für alle mit dem Baking verbundenen Einstellungen verwendet werden.

Weitere Informationen zum Backen von Lightmaps finden Sie in der Dokumentation Lightmapper.

Wenn Lightmaps für eine Anwendung nicht relevant sind und keine gebackene Beleuchtung erzeugt wird, haben die Eigenschaft und das zugehörige Objekt in der Praxis keinen Zweck.

Siehe auch Model::usedInBakedLighting, Model::bakedLightmap, Light::bakeMode, und Lightmapper.

Mit dieser Eigenschaft wird die von der Lichtsonde abgegebene Lichtmenge verändert. Ein Teil des Tonemappings ist das Belichtungsmapping, und diese Eigenschaft passt an, wie die Lichtwerte in den Lichtsonden tonemappt werden.

Standardmäßig ist die Belichtung auf 1,0 eingestellt.

Siehe auch lightProbe, probeHorizon, und probeOrientation.

Diese Eigenschaft fügt der unteren Hälfte der Umgebung Dunkelheit (Schwarz) hinzu, wenn sie mit steigenden Werten definiert wird, und zwingt die Beleuchtung dazu, überwiegend von der oberen Hälfte des Bildes zu kommen (und entfernt bestimmte Reflexionen aus der unteren Hälfte). Diese Eigenschaft ist nützlich, um eine Bodenebene zu berücksichtigen, die die Reflexion der Lichtsonde am Boden verdecken würde. Dies ist notwendig, da die Beiträge der Lichtsonde direkt aus dem Bild stammen, ohne den Inhalt der Szene zu berücksichtigen.

Der erwartete Wertebereich für die Eigenschaft probeHorizon liegt zwischen 0,0 und 1,0. Jeder Wert, der außerhalb dieses Bereichs liegt, wird auf den erwarteten Bereich geklemmt.

Standardmäßig ist probeHorizon auf 0.0 eingestellt, was bedeutet, dass die gesamte Lichtsonde ohne Anpassung verwendet wird.

Siehe auch lightProbe, probeExposure, und probeOrientation.

Mit dieser Eigenschaft wird die Ausrichtung der Lichtsonde definiert. Die Ausrichtung wird in Form von Eulerwinkeln in Grad über die x-, y- und z-Achse definiert.

Siehe auch lightProbe, probeHorizon, und probeExposure.

Diese Eigenschaft definiert ein Scherenrechteck in Ansichtskoordinaten, mit der oberen linken Ecke bei [0, 0].

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

Diese Eigenschaft definiert eine Cubemap, die als Skybox verwendet wird, wenn der Hintergrundmodus SkyBoxCubeMap ist.

Diese Eigenschaft wurde in Qt 6.4 eingeführt.

Diese Eigenschaft bestimmt, wie stark die Skybox verschwommen sein soll, wenn SceneEnvironment.SkyBox für die Eigenschaft backgroundMode verwendet wird. Der Standardwert ist 0.0, was bedeutet, dass es keine Unschärfe gibt.

Akzeptable Werte liegen zwischen 0.0 und 1.0, alle anderen Werte werden auf diesen Bereich geklemmt.

Diese Eigenschaft wurde in Qt 6.4 eingeführt.

Wenn diese Eigenschaft aktiviert ist, wird spiegelndes Aliasing abgeschwächt. Specular Aliasing ist oft in Form von hellen Punkten sichtbar, die möglicherweise flackern, wenn die Kamera bewegt wird.

Der Standardwert ist false.

Diese Eigenschaft wurde in Qt 6.4 eingeführt.

Wenn diese Eigenschaft aktiviert ist, wird temporales Antialiasing verwendet.

Die Kamera wird zwischen den Frames leicht verwackelt, und das Ergebnis jedes neuen Frames wird mit dem vorherigen Frame gemischt.

Vorteile: Durch die wackelnde Kamera werden echte Details gefunden, die sonst verloren gehen würden; geringe Auswirkungen auf die Leistung.

Nachteile: Sich schnell bewegende Objekte führen zu Geisterbildern in einem Bild.

Diese Eigenschaft ändert den Umfang der zeitlichen Bewegung (Antialiasing). Sie wirkt sich nur aus, wenn die Eigenschaft temporalAAEnabled wahr ist.

Siehe auch temporalAAEnabled.

Diese Eigenschaft definiert, wie Farben vor dem Rendering tonemapped werden. Das gesamte Rendering in Qt Quick 3D wird im linearen Farbraum durchgeführt und kann in vielen Fällen dazu führen, dass Farbwerte erzeugt werden, die nicht darstellbar sind. Der tonemapMode bestimmt die Technik, die verwendet wird, um Farben in einen anzeigbaren Bereich umzuwandeln.

Der Standardwert ist SceneEnvironment.TonemapModeLinear

Unter ExtendedSceneEnvironment finden Sie ein Beispiel für diese verschiedenen Modi.

Diese Eigenschaft wurde in Qt 6.0 eingeführt.