class-description NEWS COMMUNITY STORE LABS SIGN UP LOGIN LOGOUT ROKOJORI NEWSLETTER SIGN UP LOGIN LOGOUT NEWS COMMUNITY STORE LABS TOGGLE FULLSCREEN VOLLBILD AN/AUS Object ResourceLoader
A singleton for loading resource files.

A singleton used to load resource files from the filesystem.

It uses the many ResourceFormatLoader 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.

 Enum ThreadLoadStatus<>():Enum

THREAD_LOAD_INVALID_RESOURCE = 0

The resource is invalid, or has not been loaded with load_threaded_request.


THREAD_LOAD_IN_PROGRESS = 1

The resource is still being loaded.


THREAD_LOAD_FAILED = 2

Some error occurred during loading and it failed.


THREAD_LOAD_LOADED = 3

The resource was loaded successfully and can be accessed via load_threaded_get.

 Enum CacheMode<>():Enum

CACHE_MODE_IGNORE = 0

The resource is always loaded from disk, even if a cache entry exists for its path, and the newly loaded copy will not be cached. Instances loaded with this mode will exist independently.


CACHE_MODE_REUSE = 1

If a resource is cached, returns the cached reference. Otherwise it's loaded from disk.


CACHE_MODE_REPLACE = 2

The resource is always loaded from disk, even if a cache entry exists for its path. The cached entry will be replaced by the newly loaded copy.

 void add_resource_format_loader<>( ResourceFormatLoader=, ResourceFormatLoader:=, bool at_front=false, at_front:bool=false, ):void

Registers a new ResourceFormatLoader. The ResourceLoader will use the ResourceFormatLoader as described in load.

This method is performed implicitly for ResourceFormatLoaders written in GDScript (see ResourceFormatLoader for more information).

 bool exists<>( String path=, path:String=, String type_hint="", type_hint:String="", ):bool

Returns whether a recognized resource exists for the given path.

An optional type_hint can be used to further specify the Resource type that should be handled by the ResourceFormatLoader. Anything that inherits from Resource can be used as a type hint, for example Image.

Note: If you use Resource.take_over_path, this method will return true for the taken path even if the resource wasn't saved (i.e. exists only in resource cache).

 PackedStringArray get_dependencies<>( String path=, path:String=, ):PackedStringArray

Returns the dependencies for the resource at the given path.

Note: The dependencies are returned with slices separated by ::. You can use String.get_slice to get their components.

for dep in ResourceLoader.get_dependencies(path): print(dep.get_slice("::", 0)) # Prints UID. print(dep.get_slice("::", 2)) # Prints path.
PackedStringArray get_recognized_extensions_for_type<>( String type=, type:String=, ):PackedStringArray

Returns the list of recognized extensions for a resource type.

 int get_resource_uid<>( String path=, path:String=, ):int

Returns the ID associated with a given resource path, or -1 when no such ID exists.

 bool has_cached<>( String path=, path:String=, ):bool

Returns whether a cached resource is available for the given path.

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

 Resource load<>( String path=, path:String=, String type_hint="", type_hint:String="", CacheMode cache_mode=1, cache_mode:CacheMode=1, ):Resource

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

The registered ResourceFormatLoaders are queried sequentially to find the first one which can handle the file's extension, and then attempt loading. If loading fails, the remaining ResourceFormatLoaders are also attempted.

An optional type_hint can be used to further specify the Resource type that should be handled by the ResourceFormatLoader. Anything that inherits from Resource can be used as a type hint, for example Image.

The cache_mode property defines whether and how the cache should be used or updated when loading the resource. See CacheMode for details.

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

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

Note: If ProjectSettings.editor/export/convert_text_resources_to_binary is true, @GDScript.load will not be able to read converted files in an exported project. If you rely on run-time loading of files present within the PCK, set ProjectSettings.editor/export/convert_text_resources_to_binary to false.

 Resource load_threaded_get<>( String path=, path:String=, ):Resource

Returns the resource loaded by load_threaded_request.

If this is called before the loading thread is done (i.e. load_threaded_get_status is not THREAD_LOAD_LOADED), the calling thread will be blocked until the resource has finished loading.

 ThreadLoadStatus load_threaded_get_status<>( String path=, path:String=, Array=, Array:=, ):ThreadLoadStatus

Returns the status of a threaded loading operation started with load_threaded_request for the resource at path. See ThreadLoadStatus for possible return values.

An array variable can optionally be passed via progress, and will return a one-element array containing the percentage of completion of the threaded loading.

 Error load_threaded_request<>( String path=, path:String=, String type_hint="", type_hint:String="", bool use_sub_threads=false, use_sub_threads:bool=false, CacheMode cache_mode=1, cache_mode:CacheMode=1, ):Error

Loads the resource using threads. If use_sub_threads is true, multiple threads will be used to load the resource, which makes loading faster, but may affect the main thread (and thus cause game slowdowns).

The cache_mode property defines whether and how the cache should be used or updated when loading the resource. See CacheMode for details.

 void remove_resource_format_loader<>( ResourceFormatLoader=, ResourceFormatLoader:=, ):void

Unregisters the given ResourceFormatLoader.

 void set_abort_on_missing_resources<>( bool abort=, abort:bool=, ):void

Changes the behavior on missing sub-resources. The default behavior is to abort loading.


All social media brands are registrated trademarks and belong to their respective owners.





CONTACT IMPRINT TERMS OF USE PRIVACY © ROKOROJI ® 2021 rokojori.com CONTACT IMPRINT TERMS OF USE PRIVACY © ROKOROJI ® 2021 rokojori.com We are using cookies on this site. Read more... Wir benutzen Cookies auf dieser Seite. Mehr lesen...