Fog QML Type

Spécifie les paramètres de brouillard pour une scène. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• 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

Description détaillée

Lorsque la propriété fog d'un SceneEnvironment est définie sur un objet Fog valide, les propriétés sont utilisées pour configurer le rendu du brouillard.

Le brouillard simple fourni par ce type est mis en œuvre par les matériaux. Il ne s'agit pas d'un effet de post-traitement, ce qui signifie qu'il n'implique pas de passes de rendu supplémentaires traitant la texture avec la sortie de View3D, mais il est plutôt mis en œuvre dans le nuanceur de fragment pour chaque objet pouvant être rendu (sous-maille de Model) avec PrincipledMaterial ou ombré CustomMaterial.

Le brouillard est configuré par un certain nombre de propriétés :

• Paramètres généraux : color et density
• Paramètres de brouillard en profondeur : depthEnabled, depthNear, depthFar, depthCurve
• Paramètres du brouillard en hauteur : heightEnabled leastIntenseY , mostIntenseY, heightCurve
• Paramètres de transmission des couleurs : transmitEnabled, transmitCurve

Par exemple, l'extrait suivant active le brouillard en profondeur (mais pas en hauteur) en utilisant les paramètres de brouillard par défaut :

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

Au lieu de définir l'objet Fog en ligne, il est également possible de référencer un objet Fog par id. Et comme ExtendedSceneEnvironment hérite tout de son type parent SceneEnvironment, le brouillard peut également être utilisé avec ExtendedSceneEnvironment:

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

Voir également Qt Quick 3D - Exemple de brouillard simple et Qt Quick 3D - Exemple d'effets de scène.

Documentation sur les propriétés

color : color

La couleur du brouillard. La valeur par défaut est "#8099b3"

La même scène avec une couleur plus bleue :

Voir aussi density.

density : real

Contrôle la quantité de brouillard. En pratique, il s'agit d'un multiplicateur compris entre 0 et 1. La valeur par défaut est 1,0. La réduction de la valeur diminue l'intensité de l'effet de brouillard. Applicable uniquement lorsque depthEnabled est réglé sur true.

L'effet visuel à l'écran peut être affecté par un certain nombre d'autres paramètres de ExtendedSceneEnvironment, tels que la cartographie des tons ou l'éclat et l'efflorescence. La même valeur de densité peut donner des résultats différents en fonction des autres effets activés et de leur configuration.

Exemple de scène avec une densité réglée sur 0.95:

La même scène avec une densité réduite à 0.15:

Voir aussi color.

depthCurve : real

La valeur par défaut est 1.0.

Applicable uniquement lorsque depthEnabled a la valeur true.

Voir également depthEnabled.

depthEnabled : bool

Contrôle si le brouillard apparaît au loin. La valeur par défaut est false.

Voir aussi heightEnabled, enabled, depthNear, depthFar, et depthCurve.

depthFar : real

Distance finale de la caméra. La valeur par défaut est 1000.0. Applicable uniquement lorsque depthEnabled a la valeur true.

Voir également depthNear et depthEnabled.

depthNear : real

Distance de départ de la caméra. La valeur par défaut est 10,0. Applicable uniquement lorsque depthEnabled est défini sur true.

Prenons l'exemple de cette scène, d'abord avec une valeur de depthNear plus élevée.

En diminuant la valeur de depthNear, le brouillard se rapproche effectivement de la caméra puisqu'il part d'une distance plus faible :

Voir également depthFar et depthEnabled.

enabled : bool

Contrôle si le brouillard est appliqué à la scène. La valeur par défaut est false.

L'activation du brouillard de profondeur ou de hauteur n'a aucun effet si cette valeur n'est pas réglée sur true (vrai).

Voir également depthEnabled et heightEnabled.

heightCurve : real

Spécifie l'intensité du brouillard de hauteur. La valeur par défaut est 1,0. Applicable uniquement lorsque heightEnabled a la valeur true.

Voir également heightEnabled.

heightEnabled : bool

Contrôle si un brouillard de hauteur est activé. La valeur par défaut est false.

Voir aussi depthEnabled, enabled, leastIntenseY, mostIntenseY, et heightCurve.

leastIntenseY : real

Spécifie la position (coordonnée Y) où le brouillard est le moins intense. La valeur par défaut est 10,0. Applicable uniquement lorsque heightEnabled a la valeur true (vrai).

La photo montre une scène où le brouillard de hauteur est activé (pas de brouillard de profondeur) et où la valeur de leastIntenseY est réglée de manière à ce que le brouillard ne s'étende qu'autour du bas de la scène de Sponza.

En augmentant la valeur de leastIntenseY, le brouillard se répand plus haut puisqu'il commence à une position Y plus élevée dans la scène. (rappelez-vous que l'axe Y pointe vers le haut)

Voir également mostIntenseY et heightEnabled.

mostIntenseY : real

Spécifie la position (coordonnée Y) où le brouillard est le plus intense. La valeur par défaut est 0. Applicable uniquement lorsque heightEnabled est défini comme vrai.

Voir également leastIntenseY et heightEnabled.

transmitCurve : real

Intensité de l'effet de transmission de la lumière. La valeur par défaut est 1,0. Applicable uniquement lorsque transmitEnabled est défini sur true.

transmitEnabled : bool

Contrôle si le brouillard a un effet de transmission de la lumière. La valeur par défaut est false.