ResourceLoader

Inherits: Object

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

描述

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

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

方法说明

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

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


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


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


废弃的方法。使用has_cachedexists代替。


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

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


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

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

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

如果no_cachetrue,资源缓存将被绕过,资源将被重新加载。否则,如果缓存的资源存在,将被返回。

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

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


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

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


  • void set_abort_on_missing_resources ( bool abort )

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