Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

EditorResourceConversionPlugin

继承: RefCounted < Object

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

描述

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

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

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 是否可以通过该插件转换为目标资源类型。