FAQ

Domande e risposte

Geometria, livelli, animazione e rendering.

Nozioni di base

Come funziona il rendering delle forme?

Lo shader calcola per pixel la distanza dal contorno. Curve, angoli, tratti e bordi morbidi restano nitidi a qualsiasi scala. Geometria e aspetto restano parametri modificabili.

In cosa differisce da un Image con uno sprite arrotondato?

Un UniShape memorizza geometria e livelli modificabili. Raggi degli angoli, contorni, ombre e gradienti restano parametri, quindi un nuovo aspetto non richiede un altro sprite.

Funziona con Mask e RectMask2D?

Con entrambi. Lo shader dichiara il blocco stencil standard di uGUI — stencil id, confronto, operazione e le maschere di lettura e scrittura — e compila la variante clip-rect, quindi un UniShape viene mascherato esattamente come un Image.

Posso usarlo fuori da un Canvas, su geometria 3D?

Sì. UniShapeWorld esegue il rendering nelle scene 3D senza Canvas, con ordinamento, interazione con il puntatore e il batching condiviso nello spazio mondo di Core.

Contorni vettoriali

Posso incollare un tracciato SVG?

Sì — GameObject ▸ UI ▸ UniShape from SVG Path, oppure la stessa voce dalla palette LightSide con Alt+L. Il parser gestisce M, L, H, V, C, S, Q, T, A e Z sia in forma assoluta sia relativa, converte gli archi ellittici in curve cubiche e capovolge le coordinate per l’asse y verso l’alto di Unity. Legge solo il primo sottotracciato, quindi un contorno per forma.

Una forma può avere un foro, come una ciambella o la lettera O?

Le forme composite supportano sottrazione, intersezione ed esclusione. I livelli di taglio sottraggono dai livelli di aspetto sottostanti. Un tracciato vettoriale importato rappresenta comunque un unico contorno.

C’è un limite alla complessità di un contorno?

Ogni poligono o polilinea appiattito ha un budget di 64 vertici. L’archiviazione condivisa dei contorni cresce con il contenuto attivo e con i limiti del dispositivo. Le 18 primitive analitiche non usano righe poligonali.

Posso trasformare uno sprite esistente in una forma?

Lo strumento di ricalco converte il bordo alpha di uno sprite in un contorno modificabile. Soglia alpha e semplificazione sono configurabili; la texture sorgente deve essere leggibile.

Rendering

Quante draw call costa una forma?

Uno stack compatibile usa una sola draw call e può essere raggruppato in batch con UniText e UniLottie. Materiali diversi, texture campionate, metodi di fusione, maschere o ordine di disegno possono dividere i batch.

I componenti integrati Outline e Shadow funzionano?

UniShapes usa i propri livelli di tratto e di ombra. Ogni livello ha impostazioni modificabili di riempimento, geometria e fusione; i modificatori di mesh standard di uGUI non vengono applicati.

Posso scrivere un mio tipo di livello?

Le sottoclassi personalizzate di ShapeLayer compaiono nel selettore dei livelli e usano i meccanismi condivisi di rendering e di tracciamento delle modifiche.

Posso fornire un mio provider di contorno?

Le implementazioni serializzabili di IShapeProvider forniscono la geometria e compaiono nel selettore delle forme. I provider integrati coprono primitive, tracciati vettoriali, asset di forma, sprite e forme composite.

Prestazioni

La ricostruzione di una forma alloca memoria?

I buffer di rendering e le righe di dati GPU vengono riutilizzati. La crescita della capacità, le modifiche in fase di authoring e la creazione di asset possono allocare; la documentazione di riferimento sul rendering descrive questi confini.

Un contorno vettoriale è più costoso di una primitiva?

Le primitive analitiche hanno una formula fissa per pixel. Il rendering di poligoni e polilinee legge anche i loro vertici, quindi più vertici richiedono più lavoro allo shader. Ogni tracciato supporta fino a 64 vertici.

Questo farà esplodere il numero di varianti degli shader?

Le scelte di forme e livelli vengono fornite come dati a shader comuni. Le funzionalità di rendering, le API grafiche e le shader keyword di Unity determinano le varianti compilate.

Piattaforme

Funziona su WebGL e mobile?

Lo shader condiviso supporta le API grafiche di Shader Model 3.5, tra cui WebGL 2.0, GLES3, Vulkan, Metal e i backend grafici desktop.

Quali versioni di Unity sono supportate?

Unity 2022.3 e versioni successive. Installando UniShapes viene installato anche media.lightside.core, che contiene lo shader condiviso, i tipi di riempimento e di gradiente e gli strumenti di modifica dei punti usati dall’editor.

Mi serve anche UniText?

UniShapes dipende da LightSide Core, e il suo componente Canvas usa uGUI. UniText è richiesto solo dagli esempi che contengono testo. I sistemi Core condivisi includono riempimenti, stato delle proprietà, strumenti geometrici e infrastruttura di rendering.

Assistenza e discussioni

Discord è il canale principale per domande, assistenza e discussioni. Le segnalazioni di bug e le richieste di funzionalità vanno invece aperte sull’issue tracker pubblico.