ResourceLoader

Category: Core

Singleton used to load resource files.

Singleton used to load resource files from the filesystem.

It uses the many classes registered in the engine (either built-in or from a plugin) to load files into memory and convert them to a format that can be used by the engine.

GDScript has a simplified @GDScript.load built-in method which can be used in most situations, leaving the use of for more advanced scenarios.

• bool exists ( path, String type_hint=”” )

Returns whether a recognized resource exists for the given .

• get_dependencies ( String path )

Returns the dependencies for the resource at the given path.

• get_recognized_extensions_for_type ( String type )

Returns the list of recognized extensions for a resource type.

Deprecated method. Use or exists instead.

• has_cached ( String path )

Returns whether a cached resource is available for the given .

Once a resource has been loaded by the engine, it is cached in memory for faster access, and future calls to the or load_interactive methods will use the cached version. The cached resource can be overridden by using on a new resource for that same path.

• Resource load ( path, String type_hint=”“, no_cache=false )

Loads a resource at the given path, caching the result for further access.

An optional type_hint can be used to further specify the Resource type that should be handled by the .

If is true, the resource cache will be bypassed and the resource will be loaded anew. Otherwise, the cached resource will be returned if it exists.

Returns an empty resource if no ResourceFormatLoader could handle the file.

• ResourceInteractiveLoader load_interactive ( path, String type_hint=”” )

Starts loading a resource interactively. The returned object allows to load with high granularity, calling its ResourceInteractiveLoader.poll method successively to load chunks.

An optional type_hint can be used to further specify the type that should be handled by the ResourceFormatLoader.

Change the behavior on missing sub-resources. Default is to abort load.