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: Light) static
Variant	get_additional_data(extension_name: StringName)
void	set_additional_data(extension_name: StringName, additional_data: Variant)
Dictionary	to_dictionary() const
Light | 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()

聚光灯中锥体的内角必须小于或等于外锥角。

在这个角度下，光线处于全亮度状态。在内锥角和外锥角之间，光线亮度从全亮度逐渐过渡到零亮度。在创建 i3D 中的 SpotLight 时，会使用内锥角和外锥角之间的比例来计算光线的衰减程度。

---

float intensity = 1.0 🔗

• void set_intensity(value: float)

• float get_intensity()

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

---

String light_type = "" 🔗

• void set_light_type(value: String)

• String get_light_type()

光源的类型。i3D接受的值有“point”、“spot”、“directional”，分别对应 i3D 的 PointLight、SpotLight、DirectionalLight。

---

float outer_cone_angle = 0.785398 🔗

• void set_outer_cone_angle(value: float)

• float get_outer_cone_angle()

聚光灯中锥体的外角必须大于或等于内角。

在这个角度下，光线的亮度会降至零。在内锥角和外锥角之间，会有一个从全亮度到零亮度的过渡。如果这个角度是半周，则聚光灯会向各个方向发射光线。在创建 i3D 中的 SpotLight 时，外锥角被用作聚光灯的角度。 .. rst-class:: classref-item-separator

---

float range = inf 🔗

• void set_range(value: float)

• float get_range()

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

---

方法说明

GLTFLight from_dictionary(dictionary: Dictionary) static 🔗

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

---

GLTFLight from_node(light_node: Light) static 🔗

从给定的 i3D Light 节点新建 GLTFLight 实例。

---

Variant get_additional_data(extension_name: StringName) 🔗

---

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

---

Dictionary to_dictionary() const 🔗

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

---

Light to_node() const 🔗

将这个 GLTFLight 实例转换为 i3D Light 节点。