EditorResourceConversionPlugin

继承： RefCounted < Object

用于在编辑器资源选择器的上下文菜单中添加从一种资源格式到另一种资源格式的自定义转换器的插件；例如，将 StandardMaterial3D 转换为 ShaderMaterial。

描述

当编辑器检查器中的资源被调出上下文菜单时，EditorResourceConversionPlugin 被调用。相关的转换插件将作为菜单选项出现，以将给定的资源转换为目标类型。

下面展示了一个将 ImageTexture 转换为 PortableCompressedTexture2D 的基本插件示例。

GDScript

extends EditorResourceConversionPlugin
func _handles(resource: Resource):
    return resource is ImageTexture
func _converts_to():
    return "PortableCompressedTexture2D"
func _convert(itex: Resource):
    var ptex = PortableCompressedTexture2D.new()
    ptex.create_from_image(itex.get_image(), PortableCompressedTexture2D.COMPRESSION_MODE_LOSSLESS)
    return ptex

要使用 EditorResourceConversionPlugin，请先使用 EditorPlugin.add_resource_conversion_plugin 方法注册它。

方法

方法说明

Resource _convert(resource: Resource) virtual const 🔗

获取输入 Resource 并将其转换为 _converts_to 中给定的类型。返回的 Resource 是转换后的结果，输入的 Resource 保持不变。

String _converts_to() virtual const 🔗

返回该插件将源资源转换为的 Resource 的目标类型的类名。

bool _handles(resource: Resource) virtual const 🔗

调用以确定特定 Resource 是否可以通过该插件转换为目标资源类型。