mirror of
https://github.com/godotengine/godot
synced 2024-09-16 01:45:04 +00:00
81064cc239
We don't use that info for anything, and it generates unnecessary diffs every time we bump the minor version (and CI failures if we forget to sync some files from opt-in modules (mono, text_server_fb).
52 lines
2.3 KiB
XML
52 lines
2.3 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="EditorResourceConversionPlugin" inherits="RefCounted" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
|
|
<brief_description>
|
|
Plugin for adding custom converters from one resource format to another in the editor resource picker context menu; for example, converting a [StandardMaterial3D] to a [ShaderMaterial].
|
|
</brief_description>
|
|
<description>
|
|
[EditorResourceConversionPlugin] is invoked when the context menu is brought up for a resource in the editor inspector. Relevant conversion plugins will appear as menu options to convert the given resource to a target type.
|
|
Below shows an example of a basic plugin that will convert an [ImageTexture] to a [PortableCompressedTexture2D].
|
|
[codeblocks]
|
|
[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
|
|
[/gdscript]
|
|
[/codeblocks]
|
|
To use an [EditorResourceConversionPlugin], register it using the [method EditorPlugin.add_resource_conversion_plugin] method first.
|
|
</description>
|
|
<tutorials>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="_convert" qualifiers="virtual const">
|
|
<return type="Resource" />
|
|
<param index="0" name="resource" type="Resource" />
|
|
<description>
|
|
Takes an input [Resource] and converts it to the type given in [method _converts_to]. The returned [Resource] is the result of the conversion, and the input [Resource] remains unchanged.
|
|
</description>
|
|
</method>
|
|
<method name="_converts_to" qualifiers="virtual const">
|
|
<return type="String" />
|
|
<description>
|
|
Returns the class name of the target type of [Resource] that this plugin converts source resources to.
|
|
</description>
|
|
</method>
|
|
<method name="_handles" qualifiers="virtual const">
|
|
<return type="bool" />
|
|
<param index="0" name="resource" type="Resource" />
|
|
<description>
|
|
Called to determine whether a particular [Resource] can be converted to the target resource type by this plugin.
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
</class>
|