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

GLTFMesh

继承： Resource < RefCounted < Object

GLTFMesh 代表 glTF 网格。

描述

GLTFMesh 处理从 glTF 文件导入的 3D 网格数据，包括混合通道、混合权重、实例材质等属性和网格本身。

教程

运行时文件加载与保存

属性

PackedFloat32Array	blend_weights	`PackedFloat32Array()`
Array[Material]	instance_materials	`[]`
ImporterMesh	mesh
String	original_name	`""`

方法

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

属性说明

PackedFloat32Array blend_weights = PackedFloat32Array() 🔗

void set_blend_weights(value: PackedFloat32Array)
PackedFloat32Array get_blend_weights()

float 数组，代表网格的混合权重。

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

Array[Material] instance_materials = [] 🔗

void set_instance_materials(value: Array[Material])
Array[Material] get_instance_materials()

Material 对象数组，代表网格所使用的材质。

ImporterMesh mesh 🔗

void set_mesh(value: ImporterMesh)
ImporterMesh get_mesh()

代表网格本身的 ImporterMesh 对象。

String original_name = "" 🔗

void set_original_name(value: String)
String get_original_name()

网格的原名。

方法说明

Variant get_additional_data(extension_name: StringName) 🔗

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

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

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

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

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