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...

GLTFNode

继承： Resource < RefCounted < Object

glTF 节点类。

描述

代表 glTF 节点。glTF 节点中可以包含名称、变换、子节点（glTF 节点）以及其他专门的属性（由各自不同的类表示）。

glTF 节点通常存在于表示 glTF 文件中的所有数据的 GLTFState 内部。大多数 GLTFNode 的属性都是 glTF 文件中其他数据的索引。你可以使用 get_additional_data() 和 set_additional_data() 来添加额外的属性，扩展 glTF 节点。

教程

属性

int	camera	`-1`
PackedInt32Array	children	`PackedInt32Array()`
int	height	`-1`
int	light	`-1`
int	mesh	`-1`
String	original_name	`""`
int	parent	`-1`
Vector3	position	`Vector3(0, 0, 0)`
Quaternion	rotation	`Quaternion(0, 0, 0, 1)`
Vector3	scale	`Vector3(1, 1, 1)`
int	skeleton	`-1`
int	skin	`-1`
Transform3D	xform	`Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0)`

方法

void	append_child_index(child_index: int)
Variant	get_additional_data(extension_name: StringName)
NodePath	get_scene_node_path(gltf_state: GLTFState, handle_skeletons: bool = true)
void	set_additional_data(extension_name: StringName, additional_data: Variant)

属性说明

int camera = -1 🔗

void set_camera(value: int)
int get_camera()

如果该 glTF 节点是一个相机，则 GLTFState 中 GLTFCamera 的索引将描述该相机的属性。如果为 -1，则该节点不是相机。

PackedInt32Array children = PackedInt32Array() 🔗

void set_children(value: PackedInt32Array)
PackedInt32Array get_children()

GLTFState 中子节点的索引。如果该 glTF 节点没有子节点，则这将是一个空数组。

Note: The returned array is copied and any changes to it will not update the original property value. See PackedInt32Array for more details.

int height = -1 🔗

void set_height(value: int)
int get_height()

该节点在节点层次结构中的深度。根节点的高度为 0，其子节点的高度为 1，依此类推。如果为 -1，则尚未计算高度。

int light = -1 🔗

void set_light(value: int)
int get_light()

如果该 glTF 节点是一盏灯，则 GLTFState 中 GLTFLight 的索引将描述该灯的属性。如果为 -1，则该节点不是灯。

int mesh = -1 🔗

void set_mesh(value: int)
int get_mesh()

如果该 glTF 节点是网格，则 GLTFState 中 GLTFMesh 的索引将描述该网格的属性。如果为 -1，则该节点不是网格。

String original_name = "" 🔗

void set_original_name(value: String)
String get_original_name()

节点的原名。

int parent = -1 🔗

void set_parent(value: int)
int get_parent()

GLTFState 中父节点的索引。如果为 -1，则该节点为根节点。

Vector3 position = Vector3(0, 0, 0) 🔗

void set_position(value: Vector3)
Vector3 get_position()

该 glTF 节点相对于其父节点的位置。

Quaternion rotation = Quaternion(0, 0, 0, 1) 🔗

void set_rotation(value: Quaternion)
Quaternion get_rotation()

该 glTF 节点相对于其父节点的旋转。

Vector3 scale = Vector3(1, 1, 1) 🔗

void set_scale(value: Vector3)
Vector3 get_scale()

该 glTF 节点相对于其父节点的缩放。

int skeleton = -1 🔗

void set_skeleton(value: int)
int get_skeleton()

如果该 glTF 节点具有骨架，则 GLTFState 中的 GLTFSkeleton 的索引将描述骨架的属性。如果为 -1，则该节点没有骨架。

int skin = -1 🔗

void set_skin(value: int)
int get_skin()

如果该 glTF 节点有皮肤，则 GLTFState 中的 GLTFSkin 的索引将描述皮肤的属性。如果为 -1，则该节点没有皮肤。

Transform3D xform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0) 🔗

void set_xform(value: Transform3D)
Transform3D get_xform()

glTF 节点相对于其父节点的变换。由于通常首选位置、旋转和缩放属性，因此不使用该属性。

方法说明

void append_child_index(child_index: int) 🔗

将给定的子节点索引附加到 children 数组。

Variant get_additional_data(extension_name: StringName) 🔗

在这个 GLTFNode 实例中获取额外的任意数据。这可以用来保持 GLTFDocumentExtension 类中每个节点的状态数据，这很重要，因为它们是无状态的。

参数应该是 GLTFDocumentExtension 的名字（不必与 glTF 文件中的扩展名相匹配），而该返回值可以是你设置的任何值。如果没有设置任何值，则返回值为 null。

NodePath get_scene_node_path(gltf_state: GLTFState, handle_skeletons: bool = true) 🔗

返回该 GLTF 节点导入后在 Godot 场景树中的 NodePath。这在使用 GLTFObjectModelProperty 导入 glTF 对象模型指针时非常有用，可以处理 KHR_animation_pointer、KHR_interactivity 等扩展。

如果 handle_skeletons 为 true，则会正确解析骨骼 glTF 节点的路径。例如为 false 时为 ^"A/B/C/Bone1/Bone2/Bone3" 的路径在为 true 时会变成 ^"A/B/C/Skeleton3D:Bone3"。

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

在这个 GLTFNode 实例中设置额外的任意数据。这可以用来保持 GLTFDocumentExtension 类中每个节点的状态数据，这很重要，因为它们是无状态的。

第一个参数应该是 GLTFDocumentExtension 的名字（不必与 glTF 文件中的扩展名相匹配），第二个参数可以是任何你想要的东西。