ResourceFormatLoader

    Inherited By: , ResourceFormatDDS, , ResourceFormatLoaderBMFont, , ResourceFormatLoaderDynamicFont, , ResourceFormatLoaderImage, , ResourceFormatLoaderShader, , ResourceFormatLoaderText, , ResourceFormatLoaderTheora, , ResourceFormatLoaderWebm, , ResourceFormatPVR,

    Category: Core

    Loads a specific resource type from a file.

    Extending this class allows you to define your own loader. Be sure to respect the documented return types and values. You should give it a global class name with for it to be registered. Like built-in ResourceFormatLoaders, it will be called automatically when loading resources of its handled type(s). You may also implement a ResourceFormatSaver.

    Note: You can also extend if the resource type you need exists but Godot is unable to load its format. Choosing one way over another depends if the format is suitable or not for the final exported game. For example, it’s better to import .png textures as .stex (StreamTexture) first, so they can be loaded with better efficiency on the graphics card.

    • void get_dependencies ( path, String add_types ) virtual

    If implemented, gets the dependencies of a given resource. If add_types is , paths should be appended ::TypeName, where TypeName is the class name of the dependency. Note that custom resource types defined by scripts aren’t known by the , so you might just return "Resource" for them.

    • String get_resource_type ( path ) virtual

    Gets the class name of the resource associated with the given path. If the loader cannot handle it, it should return . Note that custom resource types defined by scripts aren’t known by the ClassDB, so you might just return "Resource" for them.

    • handles_type ( String typename ) virtual

    Tells which resource class this loader can load. Note that custom resource types defined by scripts aren’t known by the , so you might just handle "Resource" for them.

    Loads a resource when the engine finds this loader to be compatible. If the loaded resource is the result of an import, original_path will target the source file. Returns a Resource object on success, or an constant in case of failure.

    • int rename_dependencies ( path, String renames ) virtual

    Returns on success, or an Error constant in case of failure.