ProceduralSkyTextureData QML Type
生成一个HDR天空盒立方贴图。更多...
| Import Statement: | import QtQuick3D.Helpers |
| Inherits: |
属性
- groundBottomColor : color
- groundCurve : real
- groundEnergy : real
- groundHorizonColor : color
- skyCurve : real
- skyEnergy : real
- skyHorizonColor : color
- skyTopColor : color
- sunAngleMax : real
- sunAngleMin : real
- sunColor : color
- sunCurve : real
- sunEnergy : real
- sunLatitude : real
- sunLongitude : real
- textureQuality : SkyTextureQuality
详细说明
此辅助类型提供了一种生成HDR格式光探针/天空盒纹理的简便方法。请注意,生成光探针是一个计算开销较大的过程,在嵌入式硬件上可能需要相当长的时间。
生成的立方贴图由三个元素组成:天空、地面和太阳。天空和地面分别覆盖上半球和下半球。可以通过设置sunLatitude 和sunLongitude 来指定太阳的位置。
View3D {
environment: SceneEnvironment {
backgroundMode: SceneEnvironment.SkyBox
lightProbe: Texture {
textureData: ProceduralSkyTextureData {
}
}
}
}
另请参阅 SceneEnvironment 。
属性文档
groundBottomColor : color
指定天空盒底部的地面颜色。天空盒的下半部分采用从groundHorizonColor 到groundBottomColor 的渐变效果。
groundCurve : real
修改地面坡度的曲线。
groundEnergy : real
指定天空盒下半部分的亮度。地面渐变值将乘以该系数。
groundHorizonColor : color
指定地平线处的地面颜色。天空盒的下半部分呈现从groundHorizonColor 到groundBottomColor 的渐变效果。
skyCurve : real
修改天空渐变的曲线。
skyEnergy : real
指定天空盒上半部分的亮度。天空渐变值将乘以该系数。
skyHorizonColor : color
指定地平线处的天空颜色。天空盒的上半部分呈现从skyHorizonColor 到skyTopColor 的渐变效果。
skyTopColor : color
指定天空盒顶部的天空颜色。天空盒的上半部分呈现从skyHorizonColor 到skyTopColor 的渐变效果。
sunAngleMax : real
指定从太阳中心到太阳完全淡出的位置之间的角度。
sunAngleMin : real
指定从太阳中心到太阳开始变暗的位置之间的角度。
sunColor : color
指定太阳的颜色。
sunCurve : real
修改太阳渐变的曲线。
sunEnergy : real
指定太阳的强度。
sunLatitude : real
指定地平线与太阳位置之间的夹角。
sunLongitude : real
指定前进方向与太阳位置之间的夹角。
textureQuality : SkyTextureQuality
此属性用于设置天空纹理的质量。支持的取值包括:
| Constant | 描述 |
|---|---|
ProceduralSkyTextureData.SkyTextureQualityLow | 生成一张 512x512 的纹理 |
ProceduralSkyTextureData.SkyTextureQualityMedium | 生成一张 1024x1024 的纹理 |
ProceduralSkyTextureData.SkyTextureQualityHigh | 生成 2048x2048 的纹理 |
ProceduralSkyTextureData.SkyTextureQualityVeryHigh | 生成一张 4096x4096 的纹理 |
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.