# La libreria

Trova ed esegui gli script condivisi da altri, metti il cuore a quelli che usi, conserva i tuoi script, le tue palette e i tuoi pennelli e pubblica script.

_Le scorciatoie sono scritte per Windows e Linux. Su Mac, usa ⌘ Cmd dove c'è scritto Ctrl e ⌥ Option per Alt._

La tua **libreria** è l'insieme di script, palette e pennelli che hai creato, salvato o di cui hai
fatto un fork. Vivono fuori da qualsiasi sprite, quindi puoi usarli in ogni sprite. La **libreria di
script** è il lato condiviso: gli script pubblicati dalle persone, compreso l'insieme **Ufficiale**
creato da pxstud.io. Palette e pennelli non vengono condivisi: l'editor include un insieme di
elementi **Integrati** per ciascuno, e quelli che salvi sono solo tuoi.

| | I tuoi | Condivisi o integrati |
| - | - | - |
| Script | Script > Apri il mio script... | Script > Sfoglia la libreria degli script... |
| Palette | La scheda **Le mie palette** della Libreria palette | La sua scheda **Integrate** |
| Pennelli | La scheda **I miei pennelli** della Libreria pennelli | La sua scheda **Integrati** |

Apri la **Libreria palette** con il pulsante della libreria in cima alla palette, e la **Libreria
pennelli** con il pulsante **Pennelli personalizzati** nelle opzioni dello strumento
Matita e dello strumento Gomma.

I tuoi elementi sono archiviati in questo browser e funzionano offline, anche senza aver effettuato
l'accesso. Con Sync sono conservati anche nel tuo account e sincronizzati sugli altri dispositivi.
Le palette e i pennelli integrati fanno parte dell'editor, quindi funzionano anche offline e senza
accesso.

## Sfogliare la libreria di script

La libreria di script richiede un account gratuito su pxstud.io: accedi con il tuo indirizzo email e
apri il link che ti inviamo. Un account gratuito non archivia nulla nel cloud, e il resto
dell'editor non ne ha mai bisogno.

- **Cerca** per nome o tag. I risultati si aggiornano mentre scrivi.
- I **Tag** nella barra laterale restringono l'elenco, con il numero di script che usa ciascuno.
  Scegline fino a 3; uno script deve averli tutti. Anche fare clic su un tag in una scheda filtra
  per quel tag, e **Azzera filtri** ricomincia da capo.
- **Tutti gli script** e **Ufficiali** scelgono tra tutto e i soli script Ufficiali.

I risultati sono ordinati in base a quante persone hanno eseguito o fatto un fork di ogni script,
contando ogni persona una sola volta (le tue esecuzioni non contano). Gli script a cui hai messo il
cuore vengono per primi.

Ogni scheda mostra il nome dello script, il suo autore e la versione, un badge **Ufficiale** o **Tuo**
(**modificato** quando la tua bozza è più recente di ciò che è pubblicato), i suoi tag e quante
persone lo hanno eseguito e ne hanno fatto un fork. Una scheda elenca l'ultima versione
pubblicata. Per usarne una più vecchia, apri **Versioni** e sceglila dall'elenco **Versione**, che
mostra la data e la nota di rilascio di ogni versione; i pulsanti della scheda agiscono poi su
quella versione.

## Eseguire e fare un fork

| Pulsante | Cosa fa |
| - | - |
| **Esegui** | Lo esegue sullo sprite attuale, chiedendo prima le sue opzioni se ne ha (lo dice un badge **Opzioni** sulla scheda). |
| **Fai un fork** | Lo copia nella tua libreria e lo apre nel pannello degli script, dove puoi modificarlo. La copia mantiene il riconoscimento all'originale. |
| **Visualizza codice** | Apre il codice in sola lettura, oppure nell'editor di script se è tuo. |

## Cuori

Il cuore su una scheda **mette il cuore** a uno script: grigio quando non c'è, rosso quando c'è. Gli
script con il cuore vengono elencati per primi in ogni ricerca e sono salvati in questo browser,
quindi puoi comunque elencarli, eseguirli e farne un fork **offline**: senza connessione la
libreria di script mostra solo gli script a cui hai messo il cuore, e lo dice.

I tuoi script con il cuore sono anche nella pagina del tuo account, nello scaffale **Con il cuore**
del gruppo Script nella sezione **Libreria**. Fai clic con il tasto destro su uno di essi per
**Fai un fork nei tuoi** o **Togli il cuore**.

## Palette e pennelli integrati

La scheda **Integrate** della Libreria palette elenca palette di console classiche e palette
popolari di [Lospec](https://lospec.com/palette-list), ciascuna con il nome del suo autore.
**Usa** sostituisce la palette dello sprite, **Aggiungi in coda** ne aggiunge i colori e il
pulsante di salvataggio salva una copia in Le mie palette, mantenendo il riconoscimento. **Trovane
altre su Lospec** apre l'elenco delle palette di Lospec; importane una per nome in Le mie palette.
Vedi [Colore e palette](https://pxstud.io/it/docs/manual/guides/color.md#the-palette-library).

La scheda **Integrati** della Libreria pennelli ha un insieme di forme di pennello. **Seleziona**
permette di disegnare con una, e il pulsante di salvataggio ne salva una copia in I miei pennelli.

## Pennelli personalizzati

La scheda **I miei pennelli** della Libreria pennelli ha un piccolo editor per creare pennelli:

1. Scegli le dimensioni della griglia: **8×8**, **16×16**, **32×32** o **64×64**.
2. Fai clic su una cella per riempirla o svuotarla, oppure trascina sulle celle per dipingerne
   diverse. **Cancella** svuota la griglia.
3. Dai un nome al pennello e scegli **Salva in I miei pennelli**.

Fai clic su **Seleziona** su un pennello salvato per disegnare con esso. Un pennello personalizzato
disegna sempre alla sua dimensione, qualunque cosa dica l'opzione **Dimensione**; scegli una delle
forme integrate nelle opzioni dello strumento per tornare indietro. Il pulsante con la matita
rinomina un pennello (scrivi il nome, poi `Enter`; `Esc` annulla) e il pulsante del
cestino lo elimina da I miei pennelli, dopo aver chiesto conferma. Eliminare una palette da Le mie
palette chiede conferma allo stesso modo.

## Le tue palette e i tuoi script

- **Palette:** la scheda Le mie palette salva, carica, importa ed esporta palette. Vedi [Colore e
  palette](https://pxstud.io/it/docs/manual/guides/color.md#the-palette-library).
- **Script:** Script > Nuovo script... ne avvia uno e Script > Apri il mio script... elenca i tuoi, con rinomina ed
  eliminazione. Gli script aperti di recente sono in fondo al menu Script. L'API di scripting è
  documentata nel [riferimento per lo scripting](https://pxstud.io/it/docs/scripting.md).

La [pagina del tuo account](https://app.pxstud.io/account) (la sua sezione **Libreria**) elenca
anche tutto ciò che è tuo, anche senza accesso: fai clic con il tasto destro su un elemento (oppure
premi `Shift+F10`) per rinominarlo, duplicarlo, scaricarlo o eliminarlo.

## Pubblicare script

Pubblicare condivide uno script nella libreria di script. Ogni script ha una **bozza**, la versione
che modifichi, e delle **versioni pubblicate**. Ogni volta che pubblichi, la bozza diventa la
versione numerata successiva, e le versioni pubblicate non cambiano mai. Le modifiche successive
restano nella tua bozza (contrassegnata come **modificato**) finché non pubblichi di nuovo, quindi
chi usa il tuo script non è toccato dal lavoro in corso.

Ogni script ha anche una **visibilità**. Tutto parte come **Privato**. Uno script **condiviso** è
elencato nella libreria di script fin dalla sua prima versione pubblicata; uno privato che hai
pubblicato non è elencato. Gli script possono avere fino a 3 tag (ciascuno di al massimo 24
caratteri); mentre ne scrivi uno, vengono suggeriti i tag già in uso che corrispondono, con il
numero di script che li usano.

Nel pannello degli script, il pulsante di salvataggio salva la tua bozza e il pulsante di
pubblicazione la pubblica. Il badge **Privato** o **Condiviso** accanto al nome dello script (oppure
il pulsante delle impostazioni) apre **Impostazioni dello script**, con i suoi tag, chi può vederlo
e la sua cronologia delle versioni, dove puoi leggere una versione più vecchia o **ripristinarla**
nella tua bozza. La pagina dell'account e la finestra Apri script usano gli stessi badge:
**Privato**, **Condiviso v2** o **Privato v2** per uno script pubblicato che è privato.

Cambiare i tag o la visibilità di uno script pubblicato ha effetto subito nella libreria di script.
Eliminare uno script pubblicato lo toglie anche dalla libreria di script.

## Account

| | Senza account | Account gratuito | Con Sync |
| - | - | - | - |
| Palette e pennelli integrati | Sì | Sì | Sì |
| La tua libreria | In questo browser | In questo browser | Anche sincronizzata |
| Sfogliare, eseguire, fare un fork e mettere il cuore agli script | No | Sì | Sì |
| Pubblicare script | No | No | Sì |

Un anno di Sync è incluso nell'app desktop (20 $ una tantum), che ottieni dalla [pagina del tuo account](https://app.pxstud.io/account). Sync è opzionale, e si rinnova solo se attivi **Rinnovo automatico**.

**Quando Sync termina**, il tuo account resta un account gratuito, i tuoi script pubblicati e
condivisi restano nella libreria di script e puoi comunque rimuoverne la pubblicazione o eliminarli.
I tuoi elementi restano nei tuoi browser. La copia nel cloud di tutto il resto (script non
pubblicati o privati, le tue palette e i tuoi pennelli) viene conservata in sola lettura per 180
giorni, poi eliminata dal server.