ExtendedSceneEnvironment QML Type

A SceneEnvironment providing commonly used rendering effects. 更多...

import 语句：	import QtQuick3D.Helpers
Since:	Qt 6.5
继承：	SceneEnvironment

• 所有成员列表，包括继承成员

特性

• adjustmentBrightness : real
• adjustmentContrast : real
• adjustmentSaturation : real
• colorAdjustmentsEnabled : bool
• depthOfFieldBlurAmount : real
• depthOfFieldEnabled : bool
• depthOfFieldFocusDistance : real
• depthOfFieldFocusRange : real
• ditheringEnabled : bool
• exposure : real
• fxaaEnabled : bool
• glowBlendMode : int
• glowBloom : real
• glowEnabled : bool
• glowHDRMaximumValue : real
• glowHDRMinimumValue : real
• glowHDRScale : real
• glowIntensity : real
• glowLevel : int
• glowQualityHigh : bool
• glowStrength : real
• glowUseBicubicUpscale : bool
• lensFlareApplyDirtTexture : bool
• lensFlareApplyStarburstTexture : bool
• lensFlareBloomBias : real
• lensFlareBloomScale : real
• lensFlareBlurAmount : real
• lensFlareCameraDirection : vector3d
• lensFlareDistortion : real
• lensFlareEnabled : bool
• lensFlareGhostCount : int
• lensFlareGhostDispersal : real
• lensFlareHaloWidth : real
• lensFlareLensColorTexture : Texture
• lensFlareLensDirtTexture : Texture
• lensFlareLensStarburstTexture : Texture
• lensFlareStretchToAspect : real
• lutEnabled : bool
• lutFilterAlpha : real
• lutSize : real
• lutTexture : Texture
• sharpnessAmount : real
• tonemapMode : enumeration
• vignetteColor : color
• vignetteEnabled : bool
• vignetteRadius : real
• vignetteStrength : real
• whitePoint : real

详细描述

The ExtendedSceneEnvironment is an extension of QtQuick3D 's SceneEnvironment type that comes with a collection of commonly used effects built-in. The effects are exposed through a set of properties that are prefixed with the name of the effect they control.

When enabling one or more of these effects, the result is similar to manually adding post-processing effects to the SceneEnvironment 's effects list. ExtendedSceneEnvironment provides however effects that are not available in standalone form, and more importantly, it efficiently combines the effects that are enabled, reducing the number of additional render passes needed, which can lead to significantly better performance than applying individual post-processing effects to the scene. ExtendedSceneEnvironment also plays well with tonemapping, even for the more complicated multiple pass effects, and also when multiple effects are enabled and combined together. This was not always the case with standalone effects.

注意： If additional post-processing effects are added to the effects list of SceneEnvironment , then those effects will be applied before the effects provided by the ExtendedSceneEnvironment 类型。

Certain features of SceneEnvironment , such as the tonemapping, are inherited and extended with additional properties in ExtendedSceneEnvironment. For example, SceneEnvironment offers the tonemapMode property, whereas ExtendedSceneEnvironment adds control over the exposure, white point, sharpening, and dithering settings of the tonemapper as well. The tonemapMode property is not duplicated however since ExtendedSceneEnvironment inherits everything from SceneEnvironment , so the base setting of the tonemapping mode is usable regardless of which type of environment is associated with a View3D , but the additional properties are available only when using ExtendedSceneEnvironment. Other effects, such as screen space ambient occlusion (SSAO) or fog are fully part of SceneEnvironment and are usable with both types of environments.

Getting Started with ExtendedSceneEnvironment

To use the additional features offered by ExtendedSceneEnvironment, associate the View3D with an instance of it. Do not forget to import the QtQuick3D.Helpers 模块。

import QtQuick3D
import QtQuick3D.Helpers
View3D {
    environment: ExtendedSceneEnvironment {
        tonemapMode: SceneEnvironment.Filmic
        vignetteEnabled: true
        // ...
    }
}
					

注意： Experimenting with the effect parameters and tuning the values to achieve the desired visual results can often be more productive when done visually, with controls such as sliders that give instant feedback in the rendered scene when a value is changed. Using a designer tool such as Qt Design Studio, or a test bed similar to the Qt Quick 3D - Scene Effects Example is therefore often recommendable when aiming to set up a high quality scene that looks visually appealing.

注意： Switching SceneEnvironment to ExtendedSceneEnvironment automatically implies at least one additional render pass, just as if an Effect with a single pass was added to the SceneEnvironment's effect list . This is true regardless of how many of the individual post-processing steps are enabled. (the more complex effects may involve more than one additional render pass)

Available Effects

Below is an overview of the effects and related features provided by ExtendedSceneEnvironment, including features inherited from SceneEnvironment .

• Tonemapping - Controls how colors are tonemapped from high definition range to the 0-1 range before being displayed. ExtendedSceneEnvironment adds additional controls over the exposure, white point, sharpening, and dithering.

  Controlled by the properties tonemapMode , exposure , whitePoint , ditheringEnabled .

  
• Color adjustments - Brightness, contrast, saturation adjustment.

  Controlled by the properties colorAdjustmentsEnabled , adjustmentBrightness , adjustmentContrast , adjustmentSaturation .

  
• Color grading via lookup table (LUT) textures.

  Controlled by the properties lutEnabled , lutSize , lutFilterAlpha .

  
• Depth of field

  Controlled by the properties depthOfFieldEnabled , depthOfFieldFocusDistance , depthOfFieldFocusRange , depthOfFieldBlurAmount .

  
• Glow and bloom

  Controlled by the properties glowEnabled , glowQualityHigh , glowUseBicubicUpscale , glowStrength , glowIntensity , glowBloom , glowBlendMode , glowHDRMaximumValue , glowHDRMinimumValue , glowHDRScale .

  
• Vignette

  Controlled by the properties vignetteEnabled , vignetteStrength , vignetteColor , vignetteRadius .

  
• Lens flare

  Controlled by the properties lensFlareEnabled , lensFlareBloomBias , lensFlareGhostDispersal , lensFlareGhostCount , lensFlareHaloWidth , lensFlareStretchToAspect , lensFlareDistortion , lensFlareBlurAmount , lensFlareApplyDirtTexture , lensFlareApplyStarburstTexture , lensFlareCameraDirection , lensFlareLensColorTexture , lensFlareLensDirtTexture , lensFlareLensStarburstTexture .

  
• Screen space ambient occlusion - Provided by SceneEnvironment .

  Controlled by SceneEnvironment::aoEnabled , SceneEnvironment::aoStrength , SceneEnvironment::aoDistance , SceneEnvironment::aoSoftness , SceneEnvironment::aoDither , SceneEnvironment::aoSampleRate , SceneEnvironment::aoBias .

  
• Fog - Provided by SceneEnvironment . This is not a post-processing type of effect, but is rather applied to the materials of the renderable objects in the scene.

  Controlled by the Fog object associated with the SceneEnvironment::fog 特性。

  
• 抗锯齿 - Multisampling, supersampling, progressive antialiasing, specular antialiasing, temporal antialiasing are provided by SceneEnvironment . ExtendedSceneEnvironment adds the option for using a form of FXAA .

  FXAA is controlled by fxaaEnabled . Other antialiasing modes are controlled by SceneEnvironment::antialiasingMode , SceneEnvironment::temporalAAEnabled , SceneEnvironment::temporalAAStrength ，和 SceneEnvironment::specularAAEnabled .

  

另请参阅 SceneEnvironment and Qt Quick 3D - Scene Effects Example .

特性文档编制

adjustmentBrightness : real [default: 1]

Adjusts the brightness of the scene.

Brightness of 1	Brightness of 4

adjustmentContrast : real [default: 1]

Adjusts the contrast of the scene.

Contrast of 1	Contrast of 4

adjustmentSaturation : real [default: 1]

Adjusts the saturation of the scene.

Saturation of 1	Saturation of 4

colorAdjustmentsEnabled : bool [default: false]

Enables color adjustments.

另请参阅 colorAdjustmentsEnabled.

depthOfFieldBlurAmount : real [default: 4.0]

amount of blur applied to objects outside the focus range. Sensible values are in the range 0 to 10 . A value of 0 applies no additional blur.

Blur amount of 0	Blur amount of 15

depthOfFieldEnabled : bool [default: false]

Enables the depth of field blur effect.

depthOfFieldFocusDistance : real [default: 600]

Sets the distance from the camera at which objects are in focus.

Here the Sponza scene has a scale of 100 applied in order to have a suitably big range to get blur applied to the back and the front of the view. The picture below is taken with a focus distance of 753 and a focus range of 482.

glowLevel = (ExtendedSceneEnvironment.GlowLevel.One | ExtendedSceneEnvironment.GlowLevel.Six)