Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

ResourceLoader

Inherits: Object

A singleton for loading resource files.

Description

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.

Note: You have to import the files into the engine first to load them using load. If you want to load Images at run-time, you may use Image.load. If you want to import audio files, you can use the snippet described in AudioStreamMP3.data.

Tutorials

Methods

void

add_resource_format_loader ( ResourceFormatLoader format_loader, bool at_front=false )

bool

exists ( String path, String type_hint="" )

PackedStringArray

get_dependencies ( String path )

PackedStringArray

get_recognized_extensions_for_type ( String type )

int

get_resource_uid ( String path )

bool

has_cached ( String path )

Resource

load ( String path, String type_hint="", CacheMode cache_mode=1 )

Resource

load_threaded_get ( String path )

ThreadLoadStatus

load_threaded_get_status ( String path, Array progress=[] )

Error

load_threaded_request ( String path, String type_hint="", bool use_sub_threads=false, CacheMode cache_mode=1 )

void

remove_resource_format_loader ( ResourceFormatLoader format_loader )

void