Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

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
String	_converts_to ( ) virtual const
bool	_handles ( Resource resource ) virtual const

---

方法说明

Resource _convert ( Resource resource ) virtual const

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

---

String _converts_to ( ) virtual const

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

---

bool _handles ( Resource resource ) virtual const

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