Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

GLTFLight¶

继承： Resource < RefCounted < Object

代表 GLTF 灯光。

描述¶

代表由 KHR_lights_punctual GLTF 扩展定义的灯光。

教程¶

属性¶

Color	color	`Color(1, 1, 1, 1)`
float	inner_cone_angle	`0.0`
float	intensity	`1.0`
String	light_type	`""`
float	outer_cone_angle	`0.785398`
float	range	`inf`

方法¶

GLTFLight	from_dictionary(dictionary: Dictionary) static
GLTFLight	from_node(light_node: Light3D) static
Variant	get_additional_data(extension_name: StringName)
void	set_additional_data(extension_name: StringName, additional_data: Variant)
Dictionary	to_dictionary() const
Light3D	to_node() const

属性说明¶

Color color = Color(1, 1, 1, 1) 🔗

void set_color(value: Color)
Color get_color()

灯的 Color。默认为白色。黑色会导致灯光无效。

float inner_cone_angle = 0.0 🔗

void set_inner_cone_angle(value: float)
float get_inner_cone_angle()

聚光灯下圆锥体的内角。必须小于等于外锥角。

在这个角度内，光线处于全亮状态。在内锥角和外锥角之间，存在一个从全亮度到零亮度的过渡。创建 Godot SpotLight3D 时，内外锥角之间的比率将被来计算光的衰减。

float intensity = 1.0 🔗

void set_intensity(value: float)
float get_intensity()

光的强度。对于点光和聚光，用烛光（流明/立体光）表示；对于平行光，用勒克斯（流明/平方米）表示。在创建 Godot 灯光时，这个值会被转换为无单位的乘数。

String light_type = "" 🔗

void set_light_type(value: String)
String get_light_type()

灯光的类型。Godot接受的值有“point”、“spot”、“directional”，分别对应 Godot 的 OmniLight3D、SpotLight3D、DirectionalLight3D。

float outer_cone_angle = 0.785398 🔗

void set_outer_cone_angle(value: float)
float get_outer_cone_angle()

聚光灯下圆锥体的外角。必须大于等于内锥角。

在这个角度，光线会下降到零亮度。在内锥角和外锥角之间，存在一个从全亮度到零亮度的过渡。如果这个角度是一个半圆，那么聚光灯会向所有方向发射。创建一个 Godot SpotLight3D 时，外锥角被用作聚光灯的角度。

float range = inf 🔗

void set_range(value: float)
float get_range()

灯光的范围，超过这个范围灯光无效。没有定义范围的 GLTF 灯光的行为与无限范围的物理灯光一样。当创建 Godot 灯光时，范围限制在 4096。

方法说明¶

GLTFLight from_dictionary(dictionary: Dictionary) static 🔗

通过解析给定的 Dictionary 新建 GLTFLight 实例。

GLTFLight from_node(light_node: Light3D) static 🔗

从给定的 Godot Light3D 节点新建 GLTFLight 实例。

Variant get_additional_data(extension_name: StringName) 🔗

该方法目前没有描述，请帮我们贡献一个吧！

void set_additional_data(extension_name: StringName, additional_data: Variant) 🔗

该方法目前没有描述，请帮我们贡献一个吧！

Dictionary to_dictionary() const 🔗

将这个 GLTFLight 实例序列化为 Dictionary。

Light3D to_node() const 🔗

将这个 GLTFLight 实例转换为 Godot Light3D 节点。