Fog QML Type

Legt die Nebeleinstellungen für eine Szene fest. Mehr...

• Liste aller Elemente, einschließlich geerbter Elemente

Eigenschaften

• color : color
• density : real
• depthCurve : real
• depthEnabled : bool
• depthFar : real
• depthNear : real
• enabled : bool
• heightCurve : real
• heightEnabled : bool
• leastIntenseY : real
• mostIntenseY : real
• transmitCurve : real
• transmitEnabled : bool

Ausführliche Beschreibung

Wenn die Eigenschaft „ fog “ eines „ SceneEnvironment “ auf ein gültiges „Fog“-Objekt gesetzt wird, werden die Eigenschaften zur Konfiguration der Nebel-Darstellung verwendet.

Der von diesem Typ bereitgestellte einfache Nebel wird durch die Materialien implementiert. Es handelt sich nicht um einen Post-Processing-Effekt, d. h., es sind keine zusätzlichen Render-Durchläufe erforderlich, bei denen die Textur mit der Ausgabe von „ View3D “ verarbeitet wird, sondern er wird vielmehr im Fragment-Shader für jedes renderbare Objekt (Submesh von „ Model “) mit einem „ PrincipledMaterial “ oder einem „shaded CustomMaterial “ implementiert.

Der Nebel wird über eine Reihe von Eigenschaften konfiguriert:

• Allgemeine Einstellungen: color und density
• Einstellungen für Tiefennebel: depthEnabled, depthNear, depthFar, depthCurve
• Einstellungen für Höhennebel: heightEnabled, leastIntenseY, mostIntenseY, heightCurve
• Einstellungen für die Farbdurchlässigkeit: transmitEnabled, transmitCurve

Der folgende Codeausschnitt aktiviert beispielsweise Tiefennebel (jedoch keinen Höhennebel) unter Verwendung der Standard-Nebelparameter:

environment: SceneEnvironment {
    backgroundMode: SceneEnvironment.Color
    clearColor: theFog.color
    fog: Fog {
        id: theFog
        enabled: true
        depthEnabled: true
    }
}

Anstatt das Fog-Objekt inline zu definieren, ist es auch möglich, über ` id` auf ein Fog-Objekt zu verweisen. Und da ` ExtendedSceneEnvironment ` alles von seinem übergeordneten Typ ` SceneEnvironment` erbt, kann Nebel auch mit ` ExtendedSceneEnvironment ` verwendet werden:

Fog {
    id: theFog
    enabled: true
    depthEnabled: true
}
environment: ExtendedSceneEnvironment {
    fog: theFog
}

Siehe auch Qt Quick 3D – Einfaches „Fog“-Beispiel und Qt Quick 3D – Beispiel für Szeneneffekte.

Dokumentation zu den Eigenschaften

color : color

Die Farbe des Nebels. Der Standardwert lautet „#8099b3“

Dieselbe Szene mit einer bläulicheren Farbgebung:

Siehe auch density.

density : real

Steuert die Nebeldichte; in der Praxis handelt es sich hierbei um einen Multiplikator im Bereich von 0 bis 1. Der Standardwert ist 1,0. Durch Verringern des Werts wird die Intensität des Nebeleffekts reduziert. Gilt nur, wenn „ depthEnabled “ auf „true“ gesetzt ist.

Der visuelle Effekt auf dem Bildschirm kann durch eine Reihe weiterer Einstellungen unter „ ExtendedSceneEnvironment “ beeinflusst werden, beispielsweise durch Tonemapping oder Glow und Bloom. Derselbe Dichtewert kann zu unterschiedlichen Ergebnissen führen, je nachdem, welche anderen Effekte aktiviert sind und wie diese konfiguriert sind.

Eine Beispielszene mit der Dichte „ 0.95 “:

Dieselbe Szene mit auf „ 0.15 “ reduzierter Dichte:

Siehe auch „ color “.

depthCurve : real

Der Standardwert ist 1,0.

Gilt nur, wenn „ depthEnabled “ auf „true“ gesetzt ist.

Siehe auch „ depthEnabled “.

depthEnabled : bool

Legt fest, ob in der Ferne Nebel erscheint. Der Standardwert ist „false“.

Siehe auch heightEnabled, enabled, depthNear, depthFar und depthCurve.

depthFar : real

Endabstand zur Kamera. Der Standardwert beträgt 1000,0. Gilt nur, wenn „ depthEnabled “ auf „true“ gesetzt ist.

Siehe auch depthNear und depthEnabled.

depthNear : real

Startabstand zur Kamera. Der Standardwert beträgt 10,0. Gilt nur, wenn „ depthEnabled “ auf „true“ gesetzt ist.

Betrachten Sie als Beispiel diese Szene, zunächst mit einem höheren „depthNear“-Wert.

Wird der Wert von „depthNear“ verringert, „rückt“ der Nebel effektiv näher an die Kamera heran, da er nun von einer geringeren Entfernung zur Kamera ausgeht:

Siehe auch depthFar und depthEnabled.

enabled : bool

Legt fest, ob in der Szene Nebel angewendet wird. Der Standardwert ist „false“.

Das Aktivieren von Tiefen- oder Höhennebel hat keine Wirkung, wenn dieser Wert nicht auf „true“ gesetzt ist.

Siehe auch depthEnabled und heightEnabled.

heightCurve : real

Legt die Intensität des Höhennebels fest. Der Standardwert ist 1,0. Gilt nur, wenn „ heightEnabled “ auf „true“ gesetzt ist.

Siehe auch „ heightEnabled “.

heightEnabled : bool

Legt fest, ob ein Höhennebel aktiviert ist. Der Standardwert ist „false“.

Siehe auch depthEnabled, enabled, leastIntenseY, mostIntenseY und heightCurve.

leastIntenseY : real

Legt die Position (Y-Koordinate) fest, an der der Nebel am schwächsten ist. Der Standardwert beträgt 10,0. Gilt nur, wenn „ heightEnabled “ auf „true“ gesetzt ist.

Hier ist eine Szene abgebildet, in der Höhennebel aktiviert ist (kein Tiefennebel) und „leastIntenseY“ auf einen Wert eingestellt ist, sodass sich der Nebel nur am unteren Rand der Sponza-Szene ausbreitet.

Durch Erhöhen des Werts von „leastIntenseY“ breitet sich der Nebel weiter nach oben aus, da er nun effektiv an einer höheren Y-Position in der Szene beginnt. (Beachten Sie, dass die Y-Achse nach oben zeigt.)

Siehe auch mostIntenseY und heightEnabled.

mostIntenseY : real

Legt die Position (Y-Koordinate) fest, an der der Nebel am dichtesten ist. Der Standardwert ist 0. Gilt nur, wenn „ heightEnabled “ auf „true“ gesetzt ist.

Siehe auch leastIntenseY und heightEnabled.

transmitCurve : real

Intensität des Lichtdurchlässigkeitseffekts. Der Standardwert ist 1,0. Gilt nur, wenn „ transmitEnabled “ auf „true“ gesetzt ist.

transmitEnabled : bool

Legt fest, ob der Nebel einen Lichtdurchlässigkeitseffekt hat. Der Standardwert ist „false“.