浅色2d

Inherits: Node2D < CanvasItem < Node < Object

类别： 核心

简要说明

在二维环境中投射灯光。

属性

Color	color	颜色（1，1，1，1）
bool	editor_only	假
bool	enabled	真
float	energy	1.0
Mode	mode	0
Vector2	offset	矢量2（0，0）
float	range_height	0.0
int	range_item_cull_mask	1
int	range_layer_max	0
int	range_layer_min	0
int	range_z_max	1024
int	range_z_min	-1024
int	shadow_buffer_size	2048
Color	shadow_color	颜色（0，0，0，0）
bool	shadow_enabled	假
ShadowFilter	shadow_filter	0
float	shadow_filter_smooth	0.0
float	shadow_gradient_length	0.0
int	shadow_item_cull_mask	1
Texture	texture
float	texture_scale	1.0

枚举

枚举 Mode ：

• MODE_ADD = 0 ---将与light2d对应的像素值添加到其下的像素值中。这是光的常见行为。

• MODE_SUB = 1 ---将与light2d对应的像素值减去其下的像素值，从而产生反向光效应。

• MODE_MIX = 2 ---通过线性插值，将Light2d对应的像素值与其下的像素值混合。

• MODE_MASK = 3 ---Light2d的灯光纹理用作遮罩，根据灯光（遮罩）纹理的每个像素的值隐藏或显示屏幕下方的部分。

枚举 ShadowFilter ：

• SHADOW_FILTER_NONE = 0 ---阴影贴图不应用过滤器。见 shadow_filter .

• SHADOW_FILTER_PCF3 = 1 ---百分比接近过滤（3个样本）适用于阴影贴图。见 shadow_filter .

• SHADOW_FILTER_PCF5 = 2 ---百分百近距离过滤（5个样本）适用于阴影图。见 shadow_filter .

• SHADOW_FILTER_PCF7 = 3 ---百分比接近过滤（7个样本）适用于阴影图。见 shadow_filter .

• SHADOW_FILTER_PCF9 = 4 ---百分比接近过滤（9个样本）适用于阴影图。见 shadow_filter .

• SHADOW_FILTER_PCF13 = 5 ---百分比接近过滤（13个样本）适用于阴影图。见 shadow_filter .

描述

在二维环境中投射灯光。光由（通常为灰度）纹理、颜色、能量值、模式（请参见常量）和各种其他参数（范围和阴影相关）定义。

注： light2d也可以用作遮罩。

教程

• 二维灯光和阴影

属性描述

• Color color

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

Light2d的 Color .

• bool editor_only

违约	假
设定器	仅设置编辑器（值）
吸气剂	是_编辑器_only（）

如果 true ，light2d仅在编辑场景时出现。

• bool enabled

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

如果 true ，light2d将发光。

• float energy

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

Light2d的能量值。值越大，光就越强。

• Mode mode

违约	0
设定器	设置模式（值）
吸气剂	获取_模式（）

Light2d的模式。见 MODE_* 值的常量。

• Vector2 offset

违约	矢量2（0，0）
设定器	设置纹理偏移（值）
吸气剂	获取纹理偏移量（）

Light2d的偏移量 texture .

• float range_height

违约	0.0
设定器	设置高度（值）
吸气剂	获取“高度”（）

灯光的高度2d。与2d法线映射一起使用。

• int range_item_cull_mask

违约	1
设定器	设置“项目剔除”掩码（值）
吸气剂	获取项目筛选页面（）。

图层蒙版。只有具有匹配遮罩的对象才会受Light2d的影响。

• int range_layer_max

违约	0
设定器	设置层范围最大值
吸气剂	获取层范围最大值

受light2d影响的对象的最大层值。

• int range_layer_min

违约	0
设定器	设置层范围最小值
吸气剂	获取层范围最小值

受light2d影响的对象的最小层值。

• int range_z_max

违约	1024
设定器	设置范围最大值
吸气剂	获取范围最大值

最大值 z 受Light2d影响的对象的值。

• int range_z_min

违约	-1024
设定器	设置范围最小值
吸气剂	获取范围（最小值）

最小值 z 受Light2d影响的对象的值。

• int shadow_buffer_size

违约	2048
设定器	设置阴影缓冲区大小（值）
吸气剂	获取阴影缓冲区大小（）。

阴影缓冲区大小。

• Color shadow_color

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

Color 由灯光2d投射的阴影。

• bool shadow_enabled

违约	假
设定器	设置阴影（值）
吸气剂	_shadow_enabled（）是否启用？

如果 true ，light2d将投射阴影。

• ShadowFilter shadow_filter

违约	0
设定器	设置阴影过滤器（值）
吸气剂	获取_shadow_filter（）

阴影过滤器类型。见 ShadowFilter 对于可能的值。

• float shadow_filter_smooth

违约	0.0
设定器	设置阴影平滑（值）
吸气剂	得到阴影（平滑）

阴影平滑值。

• float shadow_gradient_length

违约	0.0
设定器	设置阴影渐变长度（值）
吸气剂	获取阴影渐变长度（）

平滑阴影渐变长度。

• int shadow_item_cull_mask

违约	1
设定器	设置“项目”“阴影”“剔除”遮罩（值）
吸气剂	获取_item_shadow_cull_mask（）。

阴影遮罩。用于 LightOccluder2D 投射阴影。只有具有匹配阴影遮罩的遮光罩才会投射阴影。

• Texture texture

设定器	设置纹理（值）
吸气剂	获取纹理（）

Texture 用于Light2d的外观。

• float texture_scale

违约	1.0
设定器	设置纹理比例（值）
吸气剂	获取纹理比例

这个 texture 的比例因子。