# La bibliothèque

Trouve et exécute les scripts que d'autres ont partagés, ajoute un cœur à ceux que tu utilises, garde tes propres scripts, palettes et pinceaux, et publie des scripts.

_Les raccourcis sont écrits pour Windows et Linux. Sur Mac, utilise ⌘ Cmd là où il est écrit Ctrl, et ⌥ Option pour Alt._

Ta **bibliothèque**, ce sont les scripts, palettes et pinceaux que tu as créés, enregistrés ou forkés.
Ils vivent en dehors de tout sprite, donc tu peux les utiliser dans chaque sprite. La **bibliothèque de
scripts** est le côté partagé : les scripts que des gens ont publiés, dont l'ensemble **Officiel**
réalisé par pxstud.io. Les palettes et les pinceaux ne sont pas partagés : l'éditeur fournit un
ensemble **Intégré** de chacun, et ceux que tu enregistres n'appartiennent qu'à toi.

| | Les tiens | Partagés ou intégrés |
| - | - | - |
| Scripts | Scripts > Ouvrir mon script... | Scripts > Parcourir la bibliothèque de scripts... |
| Palettes | L'onglet **Mes palettes** de la Bibliothèque de palettes | Son onglet **Intégrées** |
| Pinceaux | L'onglet **Mes pinceaux** de la Bibliothèque de pinceaux | Son onglet **Intégrés** |

Ouvre la **Bibliothèque de palettes** avec le bouton de bibliothèque en haut de la palette, et la
**Bibliothèque de pinceaux** avec le bouton **Pinceaux personnalisés** dans les options d'outil du
Crayon et de la Gomme.

Tes propres éléments sont stockés dans ce navigateur et fonctionnent hors ligne, déconnecté. Avec
Sync, ils sont aussi conservés dans ton compte et synchronisés sur tes autres appareils. Les palettes
et pinceaux intégrés font partie de l'éditeur, donc ils fonctionnent aussi hors ligne et déconnecté.

## Parcourir la bibliothèque de scripts

La bibliothèque de scripts demande un compte gratuit sur pxstud.io : connecte-toi avec ton adresse
e-mail et ouvre le lien que nous t'envoyons. Un compte gratuit ne stocke rien dans le cloud, et le
reste de l'éditeur n'en a jamais besoin.

- **Recherche** par nom ou par étiquette. Les résultats se mettent à jour pendant que tu tapes.
- Les **Étiquettes** de la barre latérale restreignent la liste, avec le nombre de scripts qui
  utilisent chacune. Choisis-en jusqu'à 3 ; un script doit toutes les avoir. Cliquer sur une étiquette
  d'une carte filtre aussi par elle, et **Effacer les filtres** repart de zéro.
- **Tous les scripts** et **Officiel** permettent de choisir entre tout et seulement les scripts
  Officiels.

Les résultats sont classés selon le nombre de personnes qui ont exécuté ou forké chaque script, chaque
personne n'étant comptée qu'une fois (tes propres exécutions ne comptent pas). Tes scripts avec un cœur
passent en premier.

Chaque carte affiche le nom du script, son auteur et sa version, un badge **Officiel** ou **À toi**
(**modifié** quand ton brouillon est plus récent que ce qui est publié), ses étiquettes, et combien de
personnes l'ont exécuté et forké. Une carte présente la dernière version publiée. Pour en utiliser une
plus ancienne, ouvre **Versions** et choisis-la dans la liste **Version**, qui montre la date et la note
de publication de chaque version ; les boutons de la carte agissent alors sur cette version.

## Exécuter et forker

| Bouton | Action |
| - | - |
| **Exécuter** | L'exécute sur le sprite actuel, en demandant d'abord ses options s'il en a (un badge **Options** sur la carte l'indique). |
| **Forker** | Le copie dans ta bibliothèque et l'ouvre dans le panneau de script, où tu peux le modifier. La copie conserve le crédit de l'original. |
| **Voir le code** | Ouvre le code en lecture seule, ou dans l'éditeur de scripts s'il est à toi. |

## Cœurs

Le cœur d'une carte **ajoute un cœur** à un script : gris quand il n'en a pas, rouge quand il en a un.
Les scripts avec un cœur sont listés en premier dans chaque recherche et sont enregistrés dans ce
navigateur, donc tu peux toujours les lister, les exécuter et les forker **hors ligne** : sans
connexion, la bibliothèque de scripts n'affiche que tes scripts avec un cœur, et le dit.

Tes scripts avec un cœur se trouvent aussi sur la page de ton compte, dans l'étagère **Aimés** du
groupe Scripts de sa section **Bibliothèque**. Fais un clic droit sur l'un d'eux pour **Forker dans les
tiens** ou **Retirer le cœur**.

## Palettes et pinceaux intégrés

L'onglet **Intégrées** de la Bibliothèque de palettes liste des palettes de consoles classiques et des
palettes populaires de [Lospec](https://lospec.com/palette-list), chacune créditée à son auteur.
**Utiliser** remplace la palette du sprite, **Ajouter à la suite** ajoute ses couleurs, et le bouton
d'enregistrement en enregistre une copie dans Mes palettes, en conservant le crédit. **En trouver plus
sur Lospec** ouvre la liste de palettes de Lospec ; importes-en une par son nom dans Mes palettes. Voir
[Couleur et palettes](https://pxstud.io/fr/docs/manual/guides/color.md#the-palette-library).

L'onglet **Intégrés** de la Bibliothèque de pinceaux propose un ensemble de formes de pinceau.
**Sélectionner** dessine avec l'une d'elles, et le bouton d'enregistrement en enregistre une copie dans
Mes pinceaux.

## Pinceaux personnalisés

L'onglet **Mes pinceaux** de la Bibliothèque de pinceaux contient un petit éditeur pour créer des
pinceaux :

1. Choisis une taille de grille : **8×8**, **16×16**, **32×32** ou **64×64**.
2. Clique sur une case pour la remplir ou la vider, ou fais glisser sur plusieurs cases pour en peindre
   plusieurs. **Effacer** vide la grille.
3. Nomme le pinceau et choisis **Enregistrer dans Mes pinceaux**.

Clique sur **Sélectionner** sur un pinceau enregistré pour dessiner avec. Un pinceau personnalisé
dessine toujours à sa propre taille, quelle que soit l'option **Taille** ; choisis l'une des formes
intégrées dans les options d'outil pour revenir en arrière. Le bouton crayon renomme un pinceau (tape le
nom, puis `Enter` ; `Esc` annule), et le bouton corbeille le supprime de Mes pinceaux, après
confirmation. Supprimer une palette de Mes palettes demande confirmation de la même façon.

## Tes palettes et tes scripts

- **Palettes :** l'onglet Mes palettes enregistre, charge, importe et exporte des palettes. Voir
  [Couleur et palettes](https://pxstud.io/fr/docs/manual/guides/color.md#the-palette-library).
- **Scripts :** Scripts > Nouveau script... en démarre un et Scripts > Ouvrir mon script... liste les tiens, avec
  renommage et suppression. Les scripts que tu as ouverts récemment sont en bas du menu Scripts. L'API
  de script est documentée dans la [référence de script](https://pxstud.io/fr/docs/scripting.md).

La [page de ton compte](https://app.pxstud.io/account) (sa section **Bibliothèque**) liste aussi tout ce
qui est à toi, même déconnecté : fais un clic droit sur un élément (ou appuie sur `Shift+F10`) pour
le renommer, le dupliquer, le télécharger ou le supprimer.

## Publier des scripts

Publier partage un script dans la bibliothèque de scripts. Chaque script a un **brouillon**, la version
que tu modifies, et des **versions publiées**. Chaque fois que tu publies, le brouillon devient la
version numérotée suivante, et les versions publiées ne changent jamais. Les modifications faites
ensuite restent dans ton brouillon (marqué **modifié**) jusqu'à la prochaine publication, donc les
personnes qui utilisent ton script ne sont pas touchées par un travail en cours.

Chaque script a aussi une **visibilité**. Tout commence **Privé**. Un script **partagé** est listé dans
la bibliothèque de scripts dès sa première version publiée ; un script privé que tu as publié n'est pas
listé. Les scripts peuvent avoir jusqu'à 3 étiquettes (24 caractères chacune au maximum) ; pendant que
tu en tapes une, les étiquettes déjà utilisées qui correspondent sont suggérées, avec le nombre de
scripts qui les utilisent.

Dans le panneau de script, le bouton d'enregistrement enregistre ton brouillon et le bouton de
publication le publie. Le badge **Privé** ou **Partagé** à côté du nom du script (ou le bouton de
paramètres) ouvre les **Paramètres du script**, avec ses étiquettes, qui peut le voir, et son historique
de versions, où tu peux lire une version plus ancienne ou la **restaurer** dans ton brouillon. La page
du compte et la boîte de dialogue Ouvrir un script utilisent les mêmes badges : **Privé**, **Partagé
v2**, ou **Privé v2** pour un script publié qui est privé.

Changer les étiquettes ou la visibilité d'un script publié prend effet tout de suite dans la
bibliothèque de scripts. Supprimer un script publié le retire aussi de la bibliothèque de scripts.

## Comptes

| | Sans compte | Compte gratuit | Avec Sync |
| - | - | - | - |
| Palettes et pinceaux intégrés | Oui | Oui | Oui |
| Ta propre bibliothèque | Dans ce navigateur | Dans ce navigateur | Synchronisée aussi |
| Parcourir, exécuter, forker les scripts et leur ajouter un cœur | Non | Oui | Oui |
| Publier des scripts | Non | Non | Oui |

Un an de Sync est inclus avec l'application de bureau (20 $ une fois), que tu obtiens depuis la [page de ton compte](https://app.pxstud.io/account). Sync est optionnel, et ne se renouvelle que si tu actives **Renouvellement automatique**.

**Quand Sync prend fin**, ton compte reste un compte gratuit, tes scripts publiés et partagés restent
dans la bibliothèque de scripts, et tu peux toujours les dépublier ou les supprimer. Tes propres
éléments restent dans tes navigateurs. La copie cloud de tout le reste (scripts non publiés ou privés,
tes palettes et pinceaux) est conservée en lecture seule pendant 180 jours, puis supprimée du serveur.