ResourceSaver

Inherits: Object

用于保存Godot特定资源类型的单例。

描述

用于将Godot特定的资源类型保存到文件系统的单例。

它使用在引擎中注册的许多ResourceFormatSaver类(无论是内置的还是来自插件的),将引擎特定的资源数据保存到基于文本(如.res.tscn)或二进制文件(如.res.scn)。

枚举

enum SaverFlags:

  • FLAG_RELATIVE_PATHS = 1 --- 用相对于使用该资源的场景的路径来保存该资源。

  • FLAG_BUNDLE_RESOURCES = 2 --- 捆绑外部资源。

  • FLAG_CHANGE_PATH = 4 --- 更改已保存资源的 Resource.resource_path 以匹配其新位置。

  • FLAG_OMIT_EDITOR_PROPERTIES = 8 --- 不要保存编辑器特定的元数据(由其 __editor 前缀标识)。

  • FLAG_SAVE_BIG_ENDIAN = 16 --- 保存为大端(参阅 File.endian_swap)。

  • FLAG_COMPRESS = 32 --- 在保存时使用 File.COMPRESSION_ZSTD 压缩资源。仅适用于二进制资源类型。

  • FLAG_REPLACE_SUBRESOURCE_PATHS = 64 --- 接管保存的子资源的路径(见Resource.take_over_path)。

方法说明

返回可用于保存给定类型的资源的扩展列表。


使用识别资源对象的ResourceFormatSaver将资源保存到给定路径的磁盘。

可以指定 flags 位掩码来自定义保存行为。

成功后返回@GlobalScope.OK