2017-09-12 22:42:36 +02:00
<?xml version="1.0" encoding="UTF-8" ?>
2021-04-26 13:14:51 +02:00
<class name= "ResourceSaver" inherits= "Object" version= "3.4" >
2017-09-12 22:42:36 +02:00
<brief_description >
2019-06-18 18:04:29 +02:00
Singleton for saving Godot-specific resource types.
2017-09-12 22:42:36 +02:00
</brief_description>
<description >
2019-06-18 18:04:29 +02:00
Singleton for saving Godot-specific resource types to the filesystem.
It uses the many [ResourceFormatSaver] classes registered in the engine (either built-in or from a plugin) to save engine-specific resource data to text-based (e.g. [code].tres[/code] or [code].tscn[/code]) or binary files (e.g. [code].res[/code] or [code].scn[/code]).
2017-09-12 22:42:36 +02:00
</description>
<tutorials >
</tutorials>
<methods >
<method name= "get_recognized_extensions" >
2021-07-30 15:28:05 +02:00
<return type= "PoolStringArray" />
<argument index= "0" name= "type" type= "Resource" />
2017-09-12 22:42:36 +02:00
<description >
2018-09-01 20:07:51 +02:00
Returns the list of extensions available for saving a resource of a given type.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "save" >
2021-07-30 15:28:05 +02:00
<return type= "int" enum= "Error" />
<argument index= "0" name= "path" type= "String" />
<argument index= "1" name= "resource" type= "Resource" />
<argument index= "2" name= "flags" type= "int" enum= "ResourceSaver.SaverFlags" default= "0" />
2017-09-12 22:42:36 +02:00
<description >
2019-06-18 18:04:29 +02:00
Saves a resource to disk to the given path, using a [ResourceFormatSaver] that recognizes the resource object.
The [code]flags[/code] bitmask can be specified to customize the save behavior.
2019-06-27 13:24:03 +02:00
Returns [constant OK] on success.
2017-09-12 22:42:36 +02:00
</description>
</method>
</methods>
<constants >
2017-11-24 23:16:30 +01:00
<constant name= "FLAG_RELATIVE_PATHS" value= "1" enum= "SaverFlags" >
2019-06-18 18:04:29 +02:00
Save the resource with a path relative to the scene which uses it.
2017-09-12 22:42:36 +02:00
</constant>
2017-11-24 23:16:30 +01:00
<constant name= "FLAG_BUNDLE_RESOURCES" value= "2" enum= "SaverFlags" >
2019-06-18 18:04:29 +02:00
Bundles external resources.
2017-09-12 22:42:36 +02:00
</constant>
2017-11-24 23:16:30 +01:00
<constant name= "FLAG_CHANGE_PATH" value= "4" enum= "SaverFlags" >
2019-06-22 01:04:47 +02:00
Changes the [member Resource.resource_path] of the saved resource to match its new location.
2017-09-12 22:42:36 +02:00
</constant>
2017-11-24 23:16:30 +01:00
<constant name= "FLAG_OMIT_EDITOR_PROPERTIES" value= "8" enum= "SaverFlags" >
2019-06-18 18:04:29 +02:00
Do not save editor-specific metadata (identified by their [code]__editor[/code] prefix).
2017-09-12 22:42:36 +02:00
</constant>
2017-11-24 23:16:30 +01:00
<constant name= "FLAG_SAVE_BIG_ENDIAN" value= "16" enum= "SaverFlags" >
2019-06-18 18:04:29 +02:00
Save as big endian (see [member File.endian_swap]).
2017-09-12 22:42:36 +02:00
</constant>
2017-11-24 23:16:30 +01:00
<constant name= "FLAG_COMPRESS" value= "32" enum= "SaverFlags" >
2019-06-18 18:04:29 +02:00
Compress the resource on save using [constant File.COMPRESSION_ZSTD]. Only available for binary resource types.
2017-09-12 22:42:36 +02:00
</constant>
2018-10-25 15:14:36 +02:00
<constant name= "FLAG_REPLACE_SUBRESOURCE_PATHS" value= "64" enum= "SaverFlags" >
2019-06-18 18:04:29 +02:00
Take over the paths of the saved subresources (see [method Resource.take_over_path]).
2018-10-25 15:14:36 +02:00
</constant>
2017-09-12 22:42:36 +02:00
</constants>
</class>