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.

EditorResourceConversionPlugin

Eredita: RefCounted < Object

Estensione per aggiungere convertitori personalizzati da un formato di risorsa a un altro nel menu contestuale del selettore delle risorse dell'editor; ad esempio, convertire uno StandardMaterial3D in uno ShaderMaterial.

Descrizione

EditorResourceConversionPlugin è utilizzato nel menu contestuale per una risorsa nell'ispettore dell'editor. Le estensioni di conversione pertinenti appariranno come opzioni del menu per convertire la risorsa specificata in un determinato tipo.

Di seguito è riportato un esempio di un'estensione base che convertirà un ImageTexture in un 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

Per usare un EditorResourceConversionPlugin, registralo prima attraverso il metodo EditorPlugin.add_resource_conversion_plugin().

Metodi

Resource

_convert(resource: Resource) virtual const

String

_converts_to() virtual const

bool

_handles(resource: Resource) virtual const


Descrizioni dei metodi

Resource _convert(resource: Resource) virtual const 🔗

Accetta un Resource in input e la converte nel tipo specificato in _converts_to(). Il valore restituito Resource è il risultato della conversione e la Resource in input rimane invariato.


String _converts_to() virtual const 🔗

Restituisce il nome della classe del tipo di destinazione di Resource in cui questo plugin converte le risorse di origine.


bool _handles(resource: Resource) virtual const 🔗

Chiamato per determinare se una particolare Resource può essere convertita nel tipo specificato di risorsa da questa estensione.