环境

Inherits: Resource < Reference < Object

类别： 核心

简要说明

环境节点的资源（如 WorldEnvironment ）定义了多个渲染选项。

属性

float	adjustment_brightness	1.0
Texture	adjustment_color_correction
float	adjustment_contrast	1.0
bool	adjustment_enabled	假
float	adjustment_saturation	1.0
Color	ambient_light_color	颜色（0，0，0，1）
float	ambient_light_energy	1.0
float	ambient_light_sky_contribution	1.0
bool	auto_exposure_enabled	假
float	auto_exposure_max_luma	8.0
float	auto_exposure_min_luma	0.05
float	auto_exposure_scale	0.4
float	auto_exposure_speed	0.5
int	background_camera_feed_id	1
int	background_canvas_max_layer	0
Color	background_color	颜色（0，0，0，1）
float	background_energy	1.0
BGMode	background_mode	0
Sky	background_sky
float	background_sky_custom_fov	0.0
Basis	background_sky_orientation	基础（1，0，0，0，1，0，0，0，1）
Vector3	background_sky_rotation	矢量3（0，0，0）
Vector3	background_sky_rotation_degrees	矢量3（0，0，0）
float	dof_blur_far_amount	0.1
float	dof_blur_far_distance	10.0
bool	dof_blur_far_enabled	假
DOFBlurQuality	dof_blur_far_quality	1
float	dof_blur_far_transition	5.0
float	dof_blur_near_amount	0.1
float	dof_blur_near_distance	2.0
bool	dof_blur_near_enabled	假
DOFBlurQuality	dof_blur_near_quality	1
float	dof_blur_near_transition	1.0
Color	fog_color	颜色（0.5、0.6、0.7、1）
float	fog_depth_begin	10.0
float	fog_depth_curve	1.0
bool	fog_depth_enabled	真
float	fog_depth_end	0.0
bool	fog_enabled	假
float	fog_height_curve	1.0
bool	fog_height_enabled	假
float	fog_height_max	100.0
float	fog_height_min	0.0
float	fog_sun_amount	0.0
Color	fog_sun_color	颜色（1，0.9，0.7，1）
float	fog_transmit_curve	1.0
bool	fog_transmit_enabled	假
bool	glow_bicubic_upscale	假
GlowBlendMode	glow_blend_mode	2
float	glow_bloom	0.0
bool	glow_enabled	假
float	glow_hdr_luminance_cap	12.0
float	glow_hdr_scale	2.0
float	glow_hdr_threshold	1.0
float	glow_intensity	0.8
bool	glow_levels/1	假
bool	glow_levels/2	假
bool	glow_levels/3	真
bool	glow_levels/4	假
bool	glow_levels/5	真
bool	glow_levels/6	假
bool	glow_levels/7	假
float	glow_strength	1.0
float	ss_reflections_depth_tolerance	0.2
bool	ss_reflections_enabled	假
float	ss_reflections_fade_in	0.15
float	ss_reflections_fade_out	2.0
int	ss_reflections_max_steps	64
bool	ss_reflections_roughness	真
float	ssao_ao_channel_affect	0.0
float	ssao_bias	0.01
SSAOBlur	ssao_blur	3
Color	ssao_color	颜色（0，0，0，1）
float	ssao_edge_sharpness	4.0
bool	ssao_enabled	假
float	ssao_intensity	1.0
float	ssao_intensity2	1.0
float	ssao_light_affect	0.0
SSAOQuality	ssao_quality	1
float	ssao_radius	1.0
float	ssao_radius2	0.0
float	tonemap_exposure	1.0
ToneMapper	tonemap_mode	0
float	tonemap_white	1.0

方法

bool	is_glow_level_enabled ( int idx ) const
无效	set_glow_level ( int idx, bool enabled )

枚举

枚举 BGMode ：

• BG_KEEP = 5 ---在屏幕上保留背景中绘制的每个像素。

• BG_CLEAR_COLOR = 0 ---使用项目的清晰颜色清除背景。

• BG_COLOR = 1 ---使用自定义的清除颜色清除背景。

• BG_SKY = 2 ---在背景中显示用户定义的天空。

• BG_COLOR_SKY = 3 ---使用自定义的清晰颜色清除背景，并允许为阴影和反射定义天空。

• BG_CANVAS = 4 ---显示A CanvasLayer 在背景中。

• BG_CAMERA_FEED = 6 ---在背景中显示摄像头进纸。

• BG_MAX = 7 ---表示 BGMode 枚举。

枚举 GlowBlendMode ：

• GLOW_BLEND_MODE_ADDITIVE = 0 ——添加辉光混合模式。主要用于粒子、发光体（光晕）、透镜光斑、光源。

• GLOW_BLEND_MODE_SCREEN = 1 ---屏幕辉光混合模式。增加亮度，经常与花一起使用。

• GLOW_BLEND_MODE_SOFTLIGHT = 2 ---软光辉光混合模式。修改对比度，暴露阴影和高光，生动的绽放。

• GLOW_BLEND_MODE_REPLACE = 3 ---更换辉光混合模式。用辉光值替换所有像素的颜色。

枚举 ToneMapper ：

• TONE_MAPPER_LINEAR = 0 ---线性色调映射器运算符。读取线性数据并执行曝光调整。

• TONE_MAPPER_REINHARDT = 1 ---Reinhardt Tonemapper运算符。按以下公式对渲染像素的颜色执行变化： color = color / (1 + color) .

• TONE_MAPPER_FILMIC = 2 ---电影调音师。

• TONE_MAPPER_ACES = 3 ---Academy彩色编码系统，色调映射器操作员。

枚举 DOFBlurQuality ：

• DOF_BLUR_QUALITY_LOW = 0 ---景深模糊质量低。

• DOF_BLUR_QUALITY_MEDIUM = 1 ---中等景深模糊质量。

• DOF_BLUR_QUALITY_HIGH = 2 ---高景深模糊质量。

枚举 SSAOBlur ：

• SSAO_BLUR_DISABLED = 0

• SSAO_BLUR_1x1 = 1

• SSAO_BLUR_2x2 = 2

• SSAO_BLUR_3x3 = 3

枚举 SSAOQuality ：

• SSAO_QUALITY_LOW = 0

• SSAO_QUALITY_MEDIUM = 1

• SSAO_QUALITY_HIGH = 2

描述

环境节点的资源（如 WorldEnvironment ）定义多个环境操作（如后台 Sky 或 Color ，环境光，雾，景深…）。这些参数会影响场景的最终渲染。这些操作的顺序是：

• 焦点模糊

• 辉光

• 色调图（自动曝光）

• 调整

教程

• 环境与后处理

• 高动态范围

属性描述

• float adjustment_brightness

违约	1.0
设定器	设置亮度（值）
吸气剂	获取调整亮度（）。

渲染场景的全局亮度值（默认值为1）。

• Texture adjustment_color_correction

设定器	设置调整颜色校正（值）
吸气剂	获取调整颜色校正

应用提供的 Texture 资源以影响渲染场景的全局颜色方面。

• float adjustment_contrast

违约	1.0
设定器	设置调整对比度（值）
吸气剂	获取调整对比度

渲染场景的全局对比度值（默认值为1）。

• bool adjustment_enabled

违约	假
设定器	设置调整启用（值）
吸气剂	是否启用调整（）。

启用调整_ * 此资源提供的选项。如果 false ，调整修改对渲染场景没有影响。

• float adjustment_saturation

违约	1.0
设定器	设置调整饱和度（值）
吸气剂	获取调整饱和度

渲染场景的全局颜色饱和度值（默认值为1）。

• Color ambient_light_color

违约	颜色（0，0，0，1）
设定器	设置环境光颜色（值）
吸气剂	获取环境光颜色

Color 环境光。

• float ambient_light_energy

违约	1.0
设定器	设置环境光能量（值）
吸气剂	获取环境光能量

环境光的能量。值越高，光就越强。

• float ambient_light_sky_contribution

违约	1.0
设定器	设置环境光天空贡献（值）
吸气剂	获取环境光天空贡献

定义天空给场景带来的光线量。值为0表示天空的光发射对场景照明没有影响，因此所有环境照明都由环境光提供。相反，值为1表示影响场景的所有灯光都由天空提供，因此环境光参数对场景没有影响。

• bool auto_exposure_enabled

违约	假
设定器	设置色调映射自动曝光（值）
吸气剂	获取色调图自动曝光（）。

启用场景渲染器的色调映射自动曝光模式。如果激活，渲染器将自动确定曝光设置，以适应场景和观察到的灯光的照明。

• float auto_exposure_max_luma

违约	8.0
设定器	设置色调图自动曝光最大值
吸气剂	获取色调图自动曝光最大值

自动曝光的最大亮度值。

• float auto_exposure_min_luma

违约	0.05
设定器	设置色调图自动曝光最小值
吸气剂	获取色调图自动曝光

自动曝光的最小亮度值。

• float auto_exposure_scale

违约	0.4
设定器	设置色调图自动曝光灰色（值）
吸气剂	获取色调图自动曝光灰色（）。

自动曝光效果的比例。影响自动曝光的强度。

• float auto_exposure_speed

违约	0.5
设定器	设置色调图自动曝光速度（值）
吸气剂	获取色调图自动曝光速度（）。

自动曝光效果的速度。影响相机执行自动曝光所需的时间。

• int background_camera_feed_id

违约	1
设定器	设置摄像机馈送ID（值）
吸气剂	获取摄像机馈送

要在后台显示的摄像头源的ID。

• int background_canvas_max_layer

违约	0
设定器	设置画布最大层（值）
吸气剂	获取画布最大层（）

最大层ID（如果使用层背景模式）。

• Color background_color

违约	颜色（0，0，0，1）
设定器	设置颜色（值）
吸气剂	获取颜色

为场景的透明区域显示的颜色（如果使用自定义颜色或颜色+天空背景模式）。

• float background_energy

违约	1.0
设定器	设置能量（值）
吸气剂	获取能量

由背景发出的光的功率。

• BGMode background_mode

违约	0
设定器	设置背景（值）
吸气剂	获取背景（）

定义背景模式。

• Sky background_sky

设定器	设置天空（值）
吸气剂	得到天空

Sky 定义为背景的资源。

• float background_sky_custom_fov

违约	0.0
设定器	设置天空自定义视野（值）
吸气剂	获取天空定制视频

Sky 资源的自定义视图域。

• Basis background_sky_orientation

违约	基础（1，0，0，0，1，0，0，0，1）
设定器	设置天空方向（值）
吸气剂	获取天空方向（）。

Sky resource's rotation expressed as a Basis

• Vector3 background_sky_rotation

违约	矢量3（0，0，0）
设定器	设置天空旋转（值）
吸气剂	获取天空旋转（）。

Sky 以弧度表示的欧拉角表示的资源旋转

• Vector3 background_sky_rotation_degrees

违约	矢量3（0，0，0）
设定器	设置天空旋转度（值）
吸气剂	得到天空旋转度

Sky 资源的旋转表示为以度数表示的欧拉角

• float dof_blur_far_amount

违约	0.1
设定器	设置模糊量（值）
吸气剂	获取模糊量

远模糊量。

• float dof_blur_far_distance

违约	10.0
设定器	设置模糊距离（值）
吸气剂	获取模糊距离

与摄影机的距离，远模糊效果会影响渲染。

• bool dof_blur_far_enabled

违约	假
设定器	设置“模糊”启用（值）
吸气剂	是否启用了“模糊”（）

启用远模糊效果。

• DOFBlurQuality dof_blur_far_quality

违约	1
设定器	设置“模糊”的“远”质量（值）
吸气剂	获得模糊的质量

远模糊的质量。

• float dof_blur_far_transition

违约	5.0
设定器	设置“Dof”模糊“Far”过渡（值）
吸气剂	获取模糊过渡

无模糊区域和远模糊之间的过渡。

• float dof_blur_near_amount

违约	0.1
设定器	在“数量”附近设置“模糊”（值）
吸气剂	获取_dof_blur_near_amount（）。

近模糊量。

• float dof_blur_near_distance

违约	2.0
设定器	设置“距离”附近的“模糊”（值）
吸气剂	在距离（）附近获得模糊

与相机的距离，在这里近模糊效果会影响渲染。

• bool dof_blur_near_enabled

违约	假
设定器	设置_-dof_-blur_-near_启用（值）
吸气剂	_dof_blur_near_enabled（）是否已启用？

启用近模糊效果。

• DOFBlurQuality dof_blur_near_quality

违约	1
设定器	在质量（值）附近设置模糊
吸气剂	获得接近质量的模糊

质量接近模糊质量。

• float dof_blur_near_transition

违约	1.0
设定器	设置_dof_blur_near_transition（值）
吸气剂	获取_dof_blur_near_transition（）。

在近模糊和无模糊区域之间切换。

• Color fog_color

违约	颜色（0.5、0.6、0.7、1）
设定器	设置雾颜色（值）
吸气剂	获取雾颜色（）。

雾的 Color .

• float fog_depth_begin

违约	10.0
设定器	设置雾深开始（值）
吸气剂	获取雾的深度开始（）。

雾的深度从相机开始的距离。

• float fog_depth_curve

违约	1.0
设定器	设置雾深曲线（值）
吸气剂	得到雾深曲线

定义雾深强度的值。

• bool fog_depth_enabled

违约	真
设定器	设置雾深启用（值）
吸气剂	是否启用了“雾深”（）

启用雾深。

• float fog_depth_end

违约	0.0
设定器	设置雾深结束（值）
吸气剂	获得雾深（结束）

• bool fog_enabled

违约	假
设定器	设置雾启用（值）
吸气剂	是否启用雾（）。

启用雾。需要启用“雾高”和/或启用“雾深”以实际显示雾。

• float fog_height_curve

违约	1.0
设定器	设置雾高曲线（值）
吸气剂	得到雾高曲线

定义雾高度强度的值。

• bool fog_height_enabled

违约	假
设定器	设置雾高（值）
吸气剂	是否启用了雾高度（）。

启用雾高度。

• float fog_height_max

违约	100.0
设定器	设置雾高度最大值
吸气剂	获得雾高度最大值

雾的最大高度。

• float fog_height_min

违约	0.0
设定器	设置雾高度最小值
吸气剂	得到雾高度最小值

最小雾高。

• float fog_sun_amount

违约	0.0
设定器	设置雾日量（值）
吸气剂	得到雾太阳量

影响雾渲染的日光量。

• Color fog_sun_color

违约	颜色（1，0.9，0.7，1）
设定器	设置雾太阳颜色（值）
吸气剂	获取雾太阳色（）。

太阳 Color .

• float fog_transmit_curve

违约	1.0
设定器	设置雾传输曲线（值）
吸气剂	获取雾传输曲线

雾传播的光量。

• bool fog_transmit_enabled

违约	假
设定器	设置雾传输启用（值）
吸气剂	是否已启用“雾传送”（）

启用雾的光传输。如果启用，则让反射光通过雾传输。

• bool glow_bicubic_upscale

违约	假
设定器	设置“辉光双三次”高级（值）
吸气剂	是否启用了“发光”双三次“高档”（）

• GlowBlendMode glow_blend_mode

违约	2
设定器	设置发光混合模式（值）
吸气剂	获取发光混合模式（）

辉光混合模式。

• float glow_bloom

违约	0.0
设定器	设置光晕（值）
吸气剂	获得光晕（Bloom）

光华值（全局辉光）。

• bool glow_enabled

违约	假
设定器	设置发光（值）
吸气剂	是否启用了发光功能（）

启用辉光渲染。

• float glow_hdr_luminance_cap

违约	12.0
设定器	设置亮度上限（值）
吸气剂	获得发光度

• float glow_hdr_scale

违约	2.0
设定器	设置发光度（值）
吸气剂	获取发光度

HDR辉光的出血比例。

• float glow_hdr_threshold

违约	1.0
设定器	设置发光阈值
吸气剂	获得发光阈值

HDR辉光的出血阈值。

• float glow_intensity

违约	0.8
设定器	设置光晕强度（值）
吸气剂	获得发光强度

发光强度。

• bool glow_levels/1

违约	假
设定器	设置发光度（值）
吸气剂	是否启用了发光级别（）。

第一级辉光（最局部）。

• bool glow_levels/2

违约	假
设定器	设置发光度（值）
吸气剂	是否启用了发光级别（）。

第二级光晕。

• bool glow_levels/3

违约	真
设定器	设置发光度（值）
吸气剂	是否启用了发光级别（）。

第三级光晕。

• bool glow_levels/4

违约	假
设定器	设置发光度（值）
吸气剂	是否启用了发光级别（）。

第四级光晕。

• bool glow_levels/5

违约	真
设定器	设置发光度（值）
吸气剂	是否启用了发光级别（）。

第五级光晕。

• bool glow_levels/6

违约	假
设定器	设置发光度（值）
吸气剂	是否启用了发光级别（）。

第六级光晕。

• bool glow_levels/7

违约	假
设定器	设置发光度（值）
吸气剂	是否启用了发光级别（）。

第七级辉光（大多数全球）。

• float glow_strength

违约	1.0
设定器	设置光晕强度（值）
吸气剂	获得发光强度

发光强度。

• float ss_reflections_depth_tolerance

违约	0.2
设定器	设置深度公差（值）
吸气剂	获取“深度公差”（）

• bool ss_reflections_enabled

违约	假
设定器	设置启用（值）
吸气剂	_ssr_已启用（）

• float ss_reflections_fade_in

违约	0.15
设定器	设置“淡入”（值）
吸气剂	使…淡入

• float ss_reflections_fade_out

违约	2.0
设定器	设置“淡出”（值）
吸气剂	使…淡出

• int ss_reflections_max_steps

违约	64
设定器	设置最大步数（值）
吸气剂	获取“最大步数”（）

• bool ss_reflections_roughness

违约	真
设定器	设置粗略（值）
吸气剂	是粗糙的

• float ssao_ao_channel_affect

违约	0.0
设定器	设置频道影响（值）
吸气剂	获取频道效果

• float ssao_bias

违约	0.01
设定器	设置“偏移”（值）
吸气剂	获取“偏差”（）

• SSAOBlur ssao_blur

违约	3
设定器	设置模糊（值）
吸气剂	获取“模糊”（）

• Color ssao_color

违约	颜色（0，0，0，1）
设定器	设置颜色（值）
吸气剂	获取“颜色”（）

• float ssao_edge_sharpness

违约	4.0
设定器	设置锐度（值）
吸气剂	获得“锐利”（）

• bool ssao_enabled

违约	假
设定器	设置已启用（值）
吸气剂	是否启用了suso_（）

• float ssao_intensity

违约	1.0
设定器	设置强度（值）
吸气剂	获得强度（））

• float ssao_intensity2

违约	1.0
设定器	设置强度2（值）
吸气剂	获取强度2（）

• float ssao_light_affect

违约	0.0
设定器	设置直接光影响（值）
吸气剂	获得直接光影响

• SSAOQuality ssao_quality

违约	1
设定器	设置质量（值）
吸气剂	获得质量

• float ssao_radius

违约	1.0
设定器	设置半径（值）
吸气剂	获取半径（）

• float ssao_radius2

违约	0.0
设定器	设置半径2（值）
吸气剂	获取半径2（）

• float tonemap_exposure

违约	1.0
设定器	设置色调映射曝光（值）
吸气剂	获取色调图曝光（）。

色调图的默认曝光。

• ToneMapper tonemap_mode

违约	0
设定器	设置色调映射器（值）
吸气剂	获取色调映射器（）

色调映射模式。

• float tonemap_white

违约	1.0
设定器	设置色调图白色（值）
吸气剂	获取色调图（白色）

色调图的白色参考值。

方法说明

• bool is_glow_level_enabled ( int idx ) const

• void set_glow_level ( int idx, bool enabled )