# Come è organizzato il tuo lavoro

Progetti, sprite, livelli, fotogrammi e cel, le tue librerie di palette, pennelli e script, e dove viene conservato ciascun elemento.

Tutto ciò che crei in pxstud.io si compone di pochi elementi annidati. Conoscerli aiuta con quasi
tutto il resto: cosa può annullare il comando Annulla, cosa contiene un file scaricato e cosa copia
Sync sui tuoi altri dispositivi.

## Gli elementi

```
Project
└── Sprite                     one image or animation (a .pxstudio file)
    ├── Layers                 stacked drawings; groups hold other layers
    ├── Frames                 the steps of the animation
    │   └── Cels               what one layer shows on one frame
    ├── Tags                   named ranges of frames
    ├── Slices                 named rectangles (hitboxes, 9-slices, export areas)
    ├── Palette                the sprite's colors
    └── Tilesets               the tiles of tilemap layers

Your library: palettes, brushes and scripts, used across all your sprites
```

**Progetto.** Una cartella con un nome che contiene sprite. Puoi averne quanti vuoi e passare
dall'uno all'altro dal menu **Progetto**. Un progetto contiene solo i suoi sprite.

**Sprite.** Un'immagine o un'animazione: dimensioni, modalità colore, livelli, fotogrammi e tutto il
resto di quanto segue. Ogni sprite si apre in una scheda tutta sua. Il suo nome appartiene al
progetto, non al disegno, quindi un file `.pxstudio` scaricato prende il nome dello sprite come nome
del file.

**Livello.** I livelli si impilano dal basso verso l'alto, e ciascuno può essere mostrato, nascosto,
bloccato e fuso in modo indipendente ([Livelli](https://pxstud.io/it/docs/manual/guides/layers.md)). Ce ne sono di quattro tipi:

- **livelli immagine**, il tipo più comune, che contengono pixel;
- **gruppi**, che contengono altri livelli;
- **livelli di riferimento**, un'immagine su cui ricalcare, mai esportata;
- **livelli tilemap**, dipinti con i tile di un tileset.

Il livello **Sfondo** è un livello immagine con qualche regola: è opaco, sta in fondo e non si può
spostare.

**Fotogramma.** Un passo dell'animazione, con la durata della sua visualizzazione (in millisecondi).
Un'immagine fissa è uno sprite con un solo fotogramma.

**Cel.** Il punto d'incontro tra un livello e un fotogramma: ciò che quel livello mostra in quel
fotogramma. Uno sprite con 3 livelli e 4 fotogrammi ha fino a 12 cel. Un cel può essere **vuoto**
(non c'è ancora niente disegnato) e i cel di uno stesso livello possono essere **collegati**, così
più fotogrammi condividono la stessa immagine: disegnare su uno qualsiasi li modifica tutti. La
pixel art di solito ha molto spazio vuoto, quindi un cel memorizza solo la parte di tela su cui è
stato disegnato.

**Tag.** Un intervallo di fotogrammi con un nome e un colore ("walk", "jump"), con una direzione di
riproduzione (avanti, indietro, ping-pong o ping-pong inverso) e il numero di ripetizioni. Le
esportazioni possono usare solo i fotogrammi di un tag.

**Slice.** Un rettangolo con un nome sulla tela, senza pixel propri, usato per segnare hitbox,
aree di esportazione o guide per il ridimensionamento 9-slice. Uno slice può cambiare da un
fotogramma all'altro.

**Palette.** L'elenco dei colori dello sprite. Il suo significato dipende dalla **modalità colore**
dello sprite:

- **RGBA:** ogni pixel ha il proprio colore, con trasparenza. La palette è un insieme di campioni
  tra cui scegliere.
- **Scala di grigi:** sfumature di grigio, con trasparenza.
- **Indicizzata:** ogni pixel _è_ una voce della palette, quindi ricolorare una voce ricolora tutti
  i pixel che la usano. Una voce (la prima, a meno che tu non la cambi) conta come trasparente.

Una palette può anche cambiare a metà animazione, da un certo fotogramma in poi.

**Tileset.** I tile con cui dipinge un livello tilemap. Ridisegnare un tile lo aggiorna ovunque sia
stato posizionato, e più livelli tilemap possono condividere lo stesso tileset.

**La tua libreria.** Le palette, i pennelli e gli script che crei, salvi o di cui fai un fork vivono
nella tua libreria personale, fuori da qualsiasi sprite, così puoi usarli in tutti. L'editor include
anche palette e pennelli integrati. Scegliere una palette della libreria ne copia i colori nello
sprite; modificarla in seguito non cambia gli sprite che già la usano.

## Il contesto di modifica

I tuoi **colori di primo piano e di sfondo**, il **pennello** e le **opzioni di ogni strumento** non
fanno parte di nessuno sprite. Un unico insieme è condiviso da tutte le schede, quindi passando da
uno sprite all'altro mantieni pennello e colori. Si azzerano quando ricarichi la pagina. (Un
[layout salvato](https://pxstud.io/it/docs/manual/guides/workspace.md#layouts) può riportare le impostazioni dei tuoi strumenti.)

## Cosa copre Annulla

Ogni sprite ha la **sua cronologia modifiche**. Tutto ciò che modifica lo sprite si può annullare:
disegno, livelli, fotogrammi, cel, tag, slice, palette, ridimensionamento e anche la selezione.

Queste cose **non** si possono annullare:

- rinominare un progetto o uno sprite;
- le modifiche a palette, pennelli e script della tua libreria;
- i tuoi colori, il pennello e le opzioni degli strumenti;
- quale livello o fotogramma è attivo e come è disposto lo spazio di lavoro;
- i nomi che dai ai passi della cronologia.

La cronologia viene salvata insieme allo sprite, quindi c'è ancora dopo che hai chiuso la sua scheda
o ricaricato la pagina, e con Sync anche sui tuoi altri dispositivi. I passi più vecchi vengono
eliminati dopo 1.000.

## Versioni

Annulla torna indietro un passo alla volta e i suoi passi più vecchi vengono eliminati. Per
conservare per sempre uno stato di uno sprite, **dagli un nome**: Sprite > Cronologia versioni... >
**Dai un nome a questa versione...** conserva lo sprite così com'è adesso su questo dispositivo,
finché non elimini la versione. Dallo stesso elenco puoi **Confrontare** una versione con lo sprite
com'è adesso (affiancati, oppure con ogni pixel modificato evidenziato), **Ripristinarla** (un
passo che puoi annullare) o scaricarla come file `.pxstudio` (senza cronologia modifiche: una versione non ne ha).
Dare un nome a un passo nel pannello [Cronologia modifiche](https://pxstud.io/it/docs/manual/guides/document.md#undo-history)
conserva anche una versione: lo sprite com'era a quel passo.

Con Sync, anche il cloud conserva le versioni precedenti di ogni sprite: ogni salvataggio dell'ultimo
giorno, poi uno al giorno per 30 giorni, poi uno a settimana per un anno. Dai un nome a una di
queste (il pulsante con la puntina) e viene conservata per sempre su ogni dispositivo; il suo spazio
di archiviazione conta nel tuo piano finché non rimuovi il nome.

## Lo stesso sprite in due schede

Uno sprite può essere modificato in una sola scheda del browser alla volta. Aprilo in una seconda
scheda e lì sarà di sola lettura, con una nota in alto; tutto ciò che salva la prima scheda compare
anche in questa. Scegli **Modifica qui** per spostare la modifica sulla seconda scheda: la prima
salva e diventa di sola lettura. Quando la scheda in cui modifichi chiude lo sprite, un'altra scheda
che lo ha aperto subentra.

## Dove viene conservato ogni elemento

| Cosa | Dove |
| - | - |
| Progetti e sprite | In questo browser, salvati mentre lavori. Con Sync, anche nel tuo account. |
| Le tue palette, i tuoi pennelli e i tuoi script | In questo browser. Con Sync, anche nel tuo account; le versioni pubblicate degli script sono nella libreria di script. |
| Palette e pennelli integrati | Nell'editor stesso. |
| Script con il cuore | Nel tuo account, con una copia in questo browser così funzionano offline. |
| Layout, preferenze e scorciatoie | Solo in questo browser. |
| Colori, pennello e opzioni degli strumenti | Solo finché la pagina è aperta. |
| Cronologia modifiche | Insieme allo sprite: in questo browser, con Sync nel tuo account, e nei file `.pxstudio` che scarichi. |
| Versioni con nome | In questo browser. Le versioni nel cloud a cui dai un nome sono nel tuo account. |

## File che puoi scaricare

- **Un file `.pxstudio`** (File > Salva con nome...) è uno sprite: dimensioni e modalità colore, palette,
  livelli, fotogrammi, cel, tag, slice, tileset, griglia e immagini di riferimento, e la sua
  cronologia modifiche. Non include le versioni con nome, la selezione né nulla che stia fuori dallo
  sprite. Riaprilo con File > Apri..., e Annulla riprende da dove era.
- **Tutto in una volta:** nella [pagina del tuo account](https://app.pxstud.io/account), **Questo browser > Esporta tutto (.zip)**
  scarica uno zip con gli sprite di ogni progetto (come file `.pxstudio`, con la loro cronologia modifiche) e le tue palette (`.gpl`),
  i tuoi pennelli e script. Funziona offline e anche senza aver effettuato l'accesso.