Supportare diversi fattori di forma e dimensioni dello schermo

I dispositivi Android sono disponibili in una varietà di fattori di forma e dimensioni dello schermo. Le categorie più comuni includono:

  • Telefoni cellulari
  • Dispositivi pieghevoli
  • Tablet
  • Televisori e set-top box per TV
  • Laptop con Android Runtime per Chrome

Questa varietà significa che il tuo gioco incontra una gamma di diverse risoluzioni dello schermo, spesso con proporzioni diverse. Ad esempio:

  • Uno smartphone in orientamento orizzontale con proporzioni 19:9 (2280 x 1080)
  • Un altro smartphone in orientamento orizzontale con proporzioni 20:9 (3200 x 1400)
  • Un display interno aperto di un pieghevole con proporzioni 1:1 (2106 x 2106) o 4:3 (2688 x 2016)
  • Una TV HD 1080p con proporzioni 16:9 (1920 x 1080)
  • Un tablet con proporzioni 4:3 (2048 x 1536)

Il design del gioco deve tenere conto di queste differenze per garantire una presentazione corretta indipendentemente dalla risoluzione dello schermo e dalle proporzioni del dispositivo.

Modalità di proiezione di Defold

Un progetto Defold ha una risoluzione di base configurabile. Questa risoluzione viene impostata nel file game.project utilizzando i campi Width e Height nella categoria Display.

Impostazioni di visualizzazione del progetto Defold
Figura 1. Le impostazioni del progetto Display

Il comportamento predefinito di Defold è eseguire il rendering alla risoluzione di base e poi scalare l'immagine risultante alla risoluzione effettiva del dispositivo di destinazione. Defold definisce questa modalità come proiezione allungata. La proiezione allungata non conserva le proporzioni originali. Per alcuni giochi, questa impostazione predefinita potrebbe essere visivamente accettabile. Lo script di rendering standard di Defold include due opzioni di proiezione aggiuntive che preservano le proporzioni di base: proiezione adatta fissa e proiezione fissa.

L'esempio seguente mostra un progetto di esempio progettato attorno a una risoluzione di base di 480 x 272, visualizzato nell'editor Defold.

In questo esempio:

  • Un oggetto tilemap viene utilizzato per disegnare una cornice attorno ai bordi della risoluzione di base.
  • Due oggetti sprite e un oggetto di testo si trovano all'interno dei limiti della risoluzione di base.
  • Ci sono quattro oggetti sprite posizionati al di fuori dei limiti della risoluzione di base, rispettivamente sopra, sotto, a sinistra e a destra.
Esempio di layout di un oggetto progetto
Figura 2. Layout dell'oggetto del progetto di esempio

Se eseguito con una risoluzione del display di 960 x 544, esattamente il doppio della risoluzione di base, il progetto viene visualizzato come segue:

Progetto di esempio con risoluzione di base 2x che utilizza la proiezione di allungamento predefinita
Figura 3. Il progetto di esempio con una risoluzione di base 2x, utilizzando la proiezione di allungamento predefinita

Proiezione allungata

I seguenti esempi mostrano i risultati del ridimensionamento della finestra con la proiezione di allungamento predefinita, in cui le proporzioni non vengono mantenute:

Esempio di progetto schiacciato orizzontalmente utilizzando la proiezione allungata
Figura 4. Il progetto di esempio schiacciato orizzontalmente durante l'utilizzo della proiezione allungata
Esempio di progetto allungato orizzontalmente utilizzando la proiezione di allungamento
Figura 5. Il progetto di esempio allungato orizzontalmente durante l'utilizzo della proiezione allungata

Proiezione con adattamento fisso

La modalità di proiezione fixed-fit mantiene le proporzioni della risoluzione di base. Poiché le proporzioni vengono mantenute, ci sarà un'area dello schermo aggiuntiva non coperta dalla risoluzione di base scalata. A seconda dell'asse principale della differenza di proporzioni, questa area aggiuntiva si trova nella parte superiore e inferiore o a sinistra e a destra della risoluzione di base. La proiezione con adattamento fisso modifica la risoluzione di base per tenere conto di questa area. Questa modifica comporta il rendering di aree aggiuntive della scena di gioco al di fuori della regione di risoluzione di base. L'immagine risultante viene quindi ridimensionata in base alla risoluzione del display.

I seguenti esempi mostrano il rendering della proiezione con adattamento fisso a una risoluzione del display con un formato diverso rispetto alla risoluzione di base di 480 x 272:

Esempio di progetto con proporzioni più ampie che utilizza la proiezione con adattamento fisso
Figura 6. Il progetto di esempio su un display con proporzioni più alte rispetto alle proporzioni di base quando si utilizza la proiezione con adattamento fisso
Esempio di progetto con proporzioni più alte che utilizza la proiezione con adattamento fisso
Figura 7. Il progetto di esempio su un display con proporzioni più ampie rispetto alle proporzioni di base quando si utilizza la proiezione con adattamento fisso

Proiezione fissa

La modalità di proiezione fissa mantiene le proporzioni della risoluzione di base e scala la risoluzione di base in base a un fattore di zoom specificato. A seconda della risoluzione del display e del fattore di zoom, potrebbe essere visualizzato un sottoinsieme o un superset dell'area di risoluzione di base.

Gli esempi seguenti mostrano la modalità di proiezione fissa utilizzando una risoluzione dello schermo di 644 x 408 con fattori di zoom 1x e 2x, rispettivamente:

Progetto di esempio a 644 x 408 con zoom 1x utilizzando la proiezione fissa
Figura 8. Il progetto di esempio con una risoluzione di visualizzazione di 644 x 408 che utilizza la proiezione fissa con un fattore di zoom 1x
Progetto di esempio a 644 x 408 con zoom 2x che utilizza la proiezione fissa
Figura 9. Il progetto di esempio con una risoluzione di visualizzazione di 644 x 408 utilizzando la proiezione fissa con un fattore di zoom 2x

Cambia modalità di proiezione

La modalità di proiezione attiva può essere cambiata in fase di runtime inviando il messaggio appropriato al renderer. Questi messaggi vengono inviati utilizzando il sistema di messaggistica standard di Defold. Tutti i messaggi della modalità di proiezione includono parametri che specificano i valori Z dei piani vicino e lontano.

-- Change to stretch projection mode
msg.post("@render:", "use_stretch_projection", { near = -1, far = 1 })

-- Change to fixed fit projection mode
msg.post("@render:", "use_fixed_fit_projection", { near = -1, far = 1 })

-- Change to fixed projection mode
msg.post("@render:", "use_fixed_projection", { near = -1, far = 1, zoom = 2 })

Script di rendering Defold

Il comportamento di rendering di Defold è controllato da un file di script speciale chiamato script di rendering. Come altri script di Defold Engine, lo script di rendering è scritto nel linguaggio di programmazione Lua. Al momento della creazione del progetto viene incluso uno script di rendering predefinito, ma puoi anche sostituirlo con uno script di rendering personalizzato.

Lo script di rendering predefinito fornisce le modalità di proiezione Allunga, Adatta e Fissa. In ogni modalità, lo script genera una matrice di proiezione ortografica 2D configurata per quella modalità per eseguire il rendering degli oggetti di gioco.

Puoi utilizzare uno script di rendering personalizzato per estendere o modificare la configurazione della matrice di proiezione. Con gli script di rendering personalizzati è possibile implementare anche funzionalità non supportate dallo script predefinito, come letterbox o pillarbox per proporzioni diverse.

Gli sviluppatori open source hanno creato pacchetti di script di rendering e fotocamera che offrono più funzionalità rispetto agli script Defold predefiniti. Due pacchetti di uso comune sono RenderCam e Defold-Orthographic.

Sistema GUI Defold

Defold include un sistema GUI basato sul concetto di file di scene GUI. I file di scena della GUI includono oggetti chiamati nodi che definiscono singoli elementi UI come immagini o testo.

I file di scena della GUI possono essere aggiunti come componente a un oggetto di gioco Defold. Le scene della GUI e i relativi nodi inclusi vengono visualizzati separatamente e funzionano in modo leggermente diverso rispetto ai normali oggetti di gioco. A causa di queste differenze, il supporto di più risoluzioni di visualizzazione con scene GUI comporta considerazioni aggiuntive relative alle coordinate del sistema GUI e ai pivot e agli ancoraggi dei nodi GUI.

Coordinate del sistema GUI

I normali oggetti di gioco Defold specificano le loro coordinate nello spazio globale. Un oggetto videocamera traduce lo spazio del mondo nello spazio dello schermo e visualizza gli oggetti di gioco che rientrano nella visuale virtuale corrente della videocamera. Il sistema GUI utilizza una propria videocamera separata. I nodi appartenenti a una scena GUI utilizzano le coordinate dello spazio dello schermo anziché quelle dello spazio globale. Quando la risoluzione del display è diversa dalla risoluzione di base del progetto utilizzata per il layout dei nodi della GUI, i nodi possono avere margini diversi rispetto ai bordi dello schermo o ai bordi di un nodo principale. Defold offre diverse opzioni per apportare modifiche al layout della GUI per tenere conto delle differenze nella risoluzione del display.

Perno e ancoraggi dei nodi della GUI

I nodi GUI possono essere ancorati ai bordi verticali, orizzontali o entrambi utilizzando le proprietà X Anchor e Y Anchor.

  • Se un nodo ha un nodo padre, l'ancoraggio è ai bordi del nodo padre.
  • Se un nodo non ha un nodo principale, l'ancoraggio è ai bordi dello schermo.

Di seguito è riportata una scena di esempio con due nodi GUI, le icone del controller negli angoli in basso a sinistra e in alto a destra. Entrambi i nodi hanno X Anchor e Y Anchor impostati su None:

Una scena di esempio con elementi GUI
Figura 10. Una scena di esempio con elementi GUI

Quando il display viene ridimensionato senza un ancoraggio, le icone del controller mantengono le loro posizioni rispetto alla risoluzione di base:

La scena di esempio ridimensionata con elementi della GUI con ancoraggi impostati su Nessuno
Figura 11. La scena di esempio ridimensionata con elementi GUI con ancoraggi impostati su None

Quando l'ancoraggio Y del nodo in basso a sinistra è impostato su Bottom e l'ancoraggio Y del nodo in alto a destra è impostato su Top, i nodi della GUI si ancoreranno ai bordi dello schermo appropriati:

La scena di esempio ridimensionata con elementi della GUI con ancoraggi impostati sui bordi
Figura 12. La scena di esempio ridimensionata con elementi GUI con ancoraggi impostati su Edges

La proprietà Pivot di un nodo GUI specifica il punto sul rettangolo dei limiti del nodo che corrisponde alla proprietà Position delle coordinate dello spazio dello schermo. Per impostazione predefinita, i nodi GUI utilizzano l'impostazione Center, che posiziona il punto Position al centro del rettangolo dei limiti. Altre possibili impostazioni di Pivot includono le quattro direzioni cardinali più le quattro diagonali. La proprietà Pivot può semplificare la specifica degli spazi dei margini se utilizzata insieme alle proprietà Ancoraggio X e Ancoraggio Y.

Nell'esempio seguente, il nodo GUI dell'icona del controller in basso a sinistra ha una posizione di 0,0 e un pivot impostato su Center.

Un nodo GUI con Pivot impostato su Center
Figura 13. Un nodo GUI con Pivot impostato su Center

La modifica di Pivot in South West comporta il seguente aggiustamento:

Un nodo GUI con Pivot impostato su Sud-ovest
Figura 14. Un nodo GUI con Pivot impostato su South West

Modalità di regolazione dei nodi della GUI

I nodi della GUI possono essere ridimensionati quando la risoluzione del display è diversa da quella del progetto di base. La proprietà Modalità di regolazione controlla il comportamento di scalabilità dei contenuti del nodo. Modalità di regolazione ha tre impostazioni: Fit, Zoom e Stretch.

Fit

L'impostazione Fit mantiene le proporzioni dei contenuti del nodo. I contenuti vengono ridimensionati in modo da corrispondere alla larghezza o all'altezza del rettangolo dei limiti ridimensionati del nodo. L'asse scelto è quello con la differenza minore. In questo modo, i contenuti si adattano al rettangolo dei limiti nelle proporzioni originali.

Zoom

L'impostazione Zoom preserva anche le proporzioni dei contenuti del nodo. Come l'impostazione Fit, Zoom scala i contenuti in modo che corrispondano alla larghezza o all'altezza del rettangolo dei limiti ridimensionati del nodo. A differenza di Fit, Zoom utilizza l'asse con la differenza maggiore rispetto alle dimensioni originali come target di corrispondenza. Ciò significa che i contenuti scalati potrebbero superare il rettangolo dei limiti.

Di seguito è riportato un esempio di due nodi GUI con impostazioni di Adjust Mode diverse. L'icona del controller in basso a sinistra ha una modalità di regolazione di Fit, mentre l'icona del controller in alto a destra ha una modalità di regolazione di Zoom.

Due nodi GUI con impostazioni della modalità di regolazione diverse
Figura 15. Due nodi GUI con impostazioni Modalità di regolazione diverse

Allunga

L'impostazione Stretch scala i contenuti del nodo in modo che corrispondano esattamente al rettangolo dei limiti ridimensionati del nodo. Le proporzioni originali non vengono conservate.

Layout GUI

Defold offre un metodo alternativo per adattare i layout della GUI a diverse risoluzioni dello schermo: i layout. I layout possono essere aggiunti a una scena GUI per eseguire l'override delle proprietà predefinite dei nodi GUI. Un layout è associato a una risoluzione dello schermo specifica. Quando sono disponibili più layout, Defold sceglierà quello che corrisponde maggiormente alla risoluzione effettiva dello schermo. La posizione, le dimensioni, la scala o la risorsa grafica predefinite utilizzate da un nodo GUI possono essere sostituite da un layout.

Risorse aggiuntive