Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

ResourcePreloader

继承: Node < Object

用于预加载场景子资源的节点。

描述

这个节点可以预加载场景中的子资源,这样场景加载完成时,所有的资源就都处于就绪可用状态,可以从预加载器获取。选中该节点后,可以使用 ResourcePreloader 选项卡来添加资源。

GDScript 提供了简化的 @GDScript.preload 内置方法,可以在大多数场景使用,ResourcePreloader 则可用于更高阶的场合。

方法

void

add_resource ( StringName name, Resource resource )

Resource

get_resource ( StringName name ) const

PackedStringArray

get_resource_list ( ) const

bool

has_resource ( StringName name ) const

void

remove_resource ( StringName name )

void

rename_resource ( StringName name, StringName newname )


方法说明

void add_resource ( StringName name, Resource resource )

将资源以给定的名称 name 添加至预加载器。如果已存在名为 name 的资源,则新资源会被重命名为 "name N",这里的 N 是从 2 开始递增的数字。


Resource get_resource ( StringName name ) const

返回与 name 关联的资源。


PackedStringArray get_resource_list ( ) const

返回预加载器内的资源列表。


bool has_resource ( StringName name ) const

如果预加载器包含一个与 name 关联的资源,则返回 true


void remove_resource ( StringName name )

从预加载器中删除与 name 关联的资源。


void rename_resource ( StringName name, StringName newname )

将预加载器中的资源从 name 重命名为 newname