ResourceLoader

Inherits: Object

用于加载资源文件的单例。

描述

用于从文件系统加载资源文件的单例。

它使用在引擎中注册的许多ResourceFormatLoader类（无论是内置的还是来自插件的）来将文件加载到内存中，并将它们转换为引擎可以使用的格式。

教程

方法

bool

exists ( String path, String type_hint="" )

PoolStringArray

get_dependencies ( String path )

PoolStringArray

get_recognized_extensions_for_type ( String type )

bool

has ( String path )

bool

has_cached ( String path )

Resource

load ( String path, String type_hint="", bool no_cache=false )

ResourceInteractiveLoader

load_interactive ( String path, String type_hint="" )

void

set_abort_on_missing_resources ( bool abort )

方法说明

返回给定的path是否存在已识别的资源。

一个可选的type_hint可以用来进一步指定ResourceFormatLoader应该处理的Resource类型。

返回给定path处资源的依赖关系。

返回资源类型的已识别扩展名列表。

废弃的方法。使用has_cached或exists代替。

返回给定路径path的缓存资源是否可用。

一旦资源被引擎加载，它就会被缓存在内存中，以便更快地访问，未来对load或load_interactive方法的调用将使用缓存的版本。缓存的资源可以通过对同一路径的新资源使用Resource.take_over_path来覆盖。

在给定的路径path上加载一个资源，缓存结果以便进一步访问。

依次查询注册的ResourceFormatLoader，找到第一个可以处理该文件扩展名的加载器，然后尝试加载。如果加载失败，其余的ResourceFormatLoaders也会被尝试。

一个可选的type_hint类型提示可以用来进一步指定ResourceFormatLoader应处理的Resource资源类型。任何继承自Resource的东西都可以被用作类型提示，例如图像Image。

如果no_cache是true，资源缓存将被绕过，资源将被重新加载。否则，如果缓存的资源存在，将被返回。

如果没有ResourceFormatLoader可以处理该文件，则返回一个空资源。

GDScript有一个简化的@GDScript.load内置方法，可以在大多数情况下使用，把ResourceLoader的使用留给更高级的场景。

开始交互式加载一个资源。返回的ResourceInteractiveLoader对象允许以高粒度加载，连续调用其ResourceInteractiveLoader.poll轮询方法来加载分块。

一个可选的type_hint类型提示可以用来进一步指定应该由ResourceFormatLoader处理的资源Resource类型。任何继承自Resource的东西都可以被用作类型提示，例如Image。

  • void set_abort_on_missing_resources ( bool abort )

更改缺少子资源时的行为。默认行为是中止加载。