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...
Icone dell'editor
Quando si crea una nuova classe e la si rende disponibile per gli script, l'interfaccia dell'editor la visualizzerà con un'icona predefinita che rappresenta la classe base da cui eredita. Nella maggior parte dei casi, tuttavia, si consiglia di creare icone personalizzate per le nuove classi al fine di migliorare l'esperienza utente.
Creazione di icone
Per creare nuove icone, è necessario innanzitutto installare un editor di grafica vettoriale. Ad esempio, è possibile utilizzare l'editor open source Inkscape.
Clona il repository godot contenente tutte le icone dell'editor:
git clone https://github.com/godotengine/godot.git
È necessario creare le icone in un editor di grafica vettoriale in formato SVG. Ci sono tre requisiti principali da rispettare:
Le icone devono essere di 16×16 pixel. In Inkscape, è possibile configurare le dimensioni del documento in File > Proprietà del documento.
Le linee dovrebbero essere allineate ai pixel, ove possibile, per rimanere nitide anche a bassi DPI. Per semplificare l'operazione, puoi creare una griglia 16x16 in Inkscape.
Se l'utente ha configurato il proprio editor per utilizzare un tema chiaro, Godot convertirà i colori dell'icona in base a un set di mappature di colore predefinite. Questo per garantire che l'icona venga sempre visualizzata con un contrasto sufficiente. Prova a limitare la tavolozza dei colori dell'icona ai colori presenti nell'elenco sopra. In caso contrario, l'icona potrebbe risultare difficile da leggere su uno sfondo chiaro.
Una volta soddisfatti con il design dell'icona, salvala nella cartella editor/icons del repository clonato. Il nome dell'icona deve corrispondere al nome desiderato, rispettando la distinzione tra maiuscole e minuscole. Ad esempio, per creare un'icona per CPUParticles2D, rinomina il file CPUParticles2D.svg.
Suggerimento
È inoltre possibile esplorare tutte le icone esistenti sul sito web Godot editor icons.
Opzioni di importazione per le icone personalizzate
Per le icone personalizzate presenti nei progetti (a differenza del codice sorgente del motore), si dovrebbero abilitare due opzioni di importazione:
Ridimensionamento per i display hiDPI
Le icone si devono ridimensionare correttamente sui display hiDPI per garantire che rimangano nitide e grandi abbastanza da essere leggibili.
Per garantire che l'icona sia renderizzata con la scala corretta sui display hiDPI, seleziona il file SVG nel pannello Filesystem, abilita l'opzione Editor > Scale with Editor Scale nel pannello Importazione e clicca su . Tieni presente che questa opzione è disponibile solo per le icone in formato SVG, poiché richiede un formato vettoriale per poter funzionare.
Conversione dei colori per i temi chiari dell'editor
Per garantire che i colori dell'icona siano convertiti quando l'utente sta usando un tema chiaro, selezionare il file SVG nel pannello Filesystem, abilitare l'opzione Editor > Convert Colors with Editor Theme nel pannello Importazione e cliccare su . Tieni presente che questa opzione è disponibile solo per le icone in formato SVG, poiché richiede un formato vettoriale per poter funzionare.
Ottimizzazione delle icone
Poiché l'editor renderizza gli SVG una sola volta al momento del caricamento, è necessario che siano di piccole dimensioni per poterli elaborare efficientemente. Quando viene eseguito il pre-commit hook, l'SVG viene automaticamente ottimizzato tramite svgo.
Nota
Sebbene questa fase di ottimizzazione non influisca notevolmente sulla qualità dell'icona, rimuoverà comunque informazioni riservate all'editor, come le guide. Pertanto, si consiglia di conservare l'SVG originale se si desidera apportare ulteriori modifiche.
Integrare e condividere le icone
Se stai contribuendo al motore stesso, dovresti inviare una "pull request" per aggiungere icone ottimizzate a editor/icons nel repository principale. Ricompila il motore per fare in modo che raccolga le nuove icone per le classi.
It's also possible to create custom icons within a module. If you're creating your own module and don't plan to integrate it with Godot, you don't need to make a separate pull request for your icons to be available within the editor as they can be self-contained.
Per istruzioni specifiche su come creare icone per i moduli, riferisciti a Creare icone personalizzate per i moduli.
Risoluzione dei problemi
Se le icone non appaiono nell'editor, assicurati che:
Il nome del file di ciascuna icona corrisponde alla nomenclatura descritta in precedenza.
Il modulo
svgè abilitato in fase di compilazione (è abilitato come predefinito). Senza questo modulo, le icone non appariranno nell'editor.