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.

EditorResourcePreviewGenerator

Eredita: RefCounted < Object

Generatore personalizzato di anteprime.

Descrizione

Codice personalizzato per generare anteprime. Controlla EditorSettings.filesystem/file_dialog/thumbnail_size per individuare una dimensione appropriata con cui generare le anteprime.

Metodi

bool

_can_generate_small_preview() virtual const

Texture2D

_generate(resource: Resource, size: Vector2i, metadata: Dictionary) virtual required const

Texture2D

_generate_from_path(path: String, size: Vector2i, metadata: Dictionary) virtual const

bool

_generate_small_preview_automatically() virtual const

bool

_handles(type: String) virtual required const

void

request_draw_and_wait(viewport: RID) const


Descrizioni dei metodi

bool _can_generate_small_preview() virtual const 🔗

Se questa funzione restituisce true, il generatore chiamerà anche _generate() o _generate_from_path() per piccole anteprime.

Per impostazione predefinita, restituisce false.


Texture2D _generate(resource: Resource, size: Vector2i, metadata: Dictionary) virtual required const 🔗

Genera un'anteprima da una determinata risorsa con la dimensione specificata. Questo deve essere sempre implementato.

Restituire null è un buon modo per fallire e lasciare che un altro generatore se ne occupi.

Bisogna fare attenzione perché questa funzione viene sempre chiamata da un altro thread (non dal thread principale).

Il dizionario metadata può essere modificato per memorizzare metadati specifici del file che possono essere utilizzati in EditorResourceTooltipPlugin._make_tooltip_for_path() (come le dimensioni dell'immagine, lunghezza dei campioni ecc.).


Texture2D _generate_from_path(path: String, size: Vector2i, metadata: Dictionary) virtual const 🔗

Genera un'anteprima direttamente da un percorso con le dimensioni specificate. L'implementazione è facoltativa, poiché il codice predefinito verrà caricato e chiamerà _generate().

Restituire null è un buon modo per fallire e lasciare che un altro generatore se ne occupi.

Bisogna fare attenzione perché questa funzione viene sempre chiamata da un altro thread (non dal thread principale).

Il dizionario metadata può essere modificato per memorizzare metadati specifici del file che possono essere utilizzati in EditorResourceTooltipPlugin._make_tooltip_for_path() (come le dimensioni dell'immagine, lunghezza dei campioni ecc.).


bool _generate_small_preview_automatically() virtual const 🔗

Se questa funzione restituisce true, il generatore genererà automaticamente le piccole anteprime dalla texture dell'anteprima generata dai metodi _generate() o _generate_from_path().

Per impostazione predefinita, restituisce false.


bool _handles(type: String) virtual required const 🔗

Restituisce true se il generatore supporta la risorsa di tipo type.


void request_draw_and_wait(viewport: RID) const 🔗

Call from within _generate() to request the rendering server draw to the viewport.