ResourceLoader¶
Inherits: Object
用于加载资源文件的单例。
描述¶
用于从文件系统加载资源文件的单例。
它使用在引擎中注册的许多ResourceFormatLoader类(无论是内置的还是来自插件的)来将文件加载到内存中,并将它们转换为引擎可以使用的格式。
教程¶
方法¶
get_dependencies ( String path ) |
|
get_recognized_extensions_for_type ( String type ) |
|
has_cached ( String path ) |
|
load ( String path, String type_hint="", bool no_cache=false ) |
|
load_interactive ( String path, String type_hint="" ) |
|
void |
set_abort_on_missing_resources ( bool abort ) |
方法说明¶
返回给定的path
是否存在已识别的资源。
一个可选的type_hint
可以用来进一步指定ResourceFormatLoader应该处理的Resource类型。
PoolStringArray get_dependencies ( String path )
返回给定path
处资源的依赖关系。
PoolStringArray get_recognized_extensions_for_type ( String type )
返回资源类型的已识别扩展名列表。
废弃的方法。使用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 load_interactive ( String path, String type_hint="" )
开始交互式加载一个资源。返回的ResourceInteractiveLoader对象允许以高粒度加载,连续调用其ResourceInteractiveLoader.poll轮询方法来加载分块。
一个可选的type_hint
类型提示可以用来进一步指定应该由ResourceFormatLoader处理的资源Resource类型。任何继承自Resource的东西都可以被用作类型提示,例如Image。
void set_abort_on_missing_resources ( bool abort )
更改缺少子资源时的行为。默认行为是中止加载。