6236a688b7
This PR is a continuation of #50381 (which was implemented exactly a year ago!) * Add a visual interface to select which classes should not be built into Godot (well, they are built if something else uses them, but if not used the optimizer will remove them out). * Add a detection system to scan the project and figure out the actual classes used. * Added the ability for SCons to load build profiles. Obligatory Screen: A simple test with a couple of nodes in the scene resulted in a 25% reduction for the final binary size TODO: * Script languages need to implement used class detection (left for another PR). * Options to disable servers or server functionalities (like 2D or 3D physics, navigation, etc). Are missing, that should also greatly aid in reducing binary size. * Options to disable some modules would be desired. * More options to disable drivers (OpenGL, Vulkan, etc) would be desired. In general this PR is a starting point for more contributors to improve and enhance this functionality.
93 lines
5.3 KiB
XML
93 lines
5.3 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="ResourceFormatLoader" inherits="RefCounted" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
|
|
<brief_description>
|
|
Loads a specific resource type from a file.
|
|
</brief_description>
|
|
<description>
|
|
Godot loads resources in the editor or in exported games using ResourceFormatLoaders. They are queried automatically via the [ResourceLoader] singleton, or when a resource with internal dependencies is loaded. Each file type may load as a different resource type, so multiple ResourceFormatLoaders are registered in the engine.
|
|
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 [code]class_name[/code] 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].
|
|
[b]Note:[/b] You can also extend [EditorImportPlugin] if the resource type you need exists but Godot is unable to load its format. Choosing one way over another depends on if the format is suitable or not for the final exported game. For example, it's better to import [code].png[/code] textures as [code].ctex[/code] ([CompressedTexture2D]) first, so they can be loaded with better efficiency on the graphics card.
|
|
</description>
|
|
<tutorials>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="_exists" qualifiers="virtual const">
|
|
<return type="bool" />
|
|
<argument index="0" name="path" type="String" />
|
|
<description>
|
|
</description>
|
|
</method>
|
|
<method name="_get_classes_used" qualifiers="virtual const">
|
|
<return type="PackedStringArray" />
|
|
<argument index="0" name="path" type="String" />
|
|
<description>
|
|
</description>
|
|
</method>
|
|
<method name="_get_dependencies" qualifiers="virtual const">
|
|
<return type="PackedStringArray" />
|
|
<argument index="0" name="path" type="String" />
|
|
<argument index="1" name="add_types" type="bool" />
|
|
<description>
|
|
If implemented, gets the dependencies of a given resource. If [code]add_types[/code] is [code]true[/code], paths should be appended [code]::TypeName[/code], where [code]TypeName[/code] is the class name of the dependency.
|
|
[b]Note:[/b] Custom resource types defined by scripts aren't known by the [ClassDB], so you might just return [code]"Resource"[/code] for them.
|
|
</description>
|
|
</method>
|
|
<method name="_get_recognized_extensions" qualifiers="virtual const">
|
|
<return type="PackedStringArray" />
|
|
<description>
|
|
Gets the list of extensions for files this loader is able to read.
|
|
</description>
|
|
</method>
|
|
<method name="_get_resource_type" qualifiers="virtual const">
|
|
<return type="String" />
|
|
<argument index="0" name="path" type="String" />
|
|
<description>
|
|
Gets the class name of the resource associated with the given path. If the loader cannot handle it, it should return [code]""[/code].
|
|
[b]Note:[/b] Custom resource types defined by scripts aren't known by the [ClassDB], so you might just return [code]"Resource"[/code] for them.
|
|
</description>
|
|
</method>
|
|
<method name="_get_resource_uid" qualifiers="virtual const">
|
|
<return type="int" />
|
|
<argument index="0" name="path" type="String" />
|
|
<description>
|
|
</description>
|
|
</method>
|
|
<method name="_handles_type" qualifiers="virtual const">
|
|
<return type="bool" />
|
|
<argument index="0" name="type" type="StringName" />
|
|
<description>
|
|
Tells which resource class this loader can load.
|
|
[b]Note:[/b] Custom resource types defined by scripts aren't known by the [ClassDB], so you might just handle [code]"Resource"[/code] for them.
|
|
</description>
|
|
</method>
|
|
<method name="_load" qualifiers="virtual const">
|
|
<return type="Variant" />
|
|
<argument index="0" name="path" type="String" />
|
|
<argument index="1" name="original_path" type="String" />
|
|
<argument index="2" name="use_sub_threads" type="bool" />
|
|
<argument index="3" name="cache_mode" type="int" />
|
|
<description>
|
|
Loads a resource when the engine finds this loader to be compatible. If the loaded resource is the result of an import, [code]original_path[/code] will target the source file. Returns a [Resource] object on success, or an [enum Error] constant in case of failure.
|
|
The [code]cache_mode[/code] property defines whether and how the cache should be used or updated when loading the resource. See [enum CacheMode] for details.
|
|
</description>
|
|
</method>
|
|
<method name="_rename_dependencies" qualifiers="virtual const">
|
|
<return type="int" />
|
|
<argument index="0" name="path" type="String" />
|
|
<argument index="1" name="renames" type="Dictionary" />
|
|
<description>
|
|
If implemented, renames dependencies within the given resource and saves it. [code]renames[/code] is a dictionary [code]{ String => String }[/code] mapping old dependency paths to new paths.
|
|
Returns [constant OK] on success, or an [enum Error] constant in case of failure.
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<constants>
|
|
<constant name="CACHE_MODE_IGNORE" value="0" enum="CacheMode">
|
|
</constant>
|
|
<constant name="CACHE_MODE_REUSE" value="1" enum="CacheMode">
|
|
</constant>
|
|
<constant name="CACHE_MODE_REPLACE" value="2" enum="CacheMode">
|
|
</constant>
|
|
</constants>
|
|
</class>
|