# A biblioteca

Encontre e execute scripts que outras pessoas compartilharam, favorite os que você usa, guarde seus próprios scripts, paletas e pincéis e publique scripts.

_Os atalhos estão escritos para Windows e Linux. No Mac, use ⌘ Cmd onde está Ctrl e ⌥ Option no lugar de Alt._

Sua **biblioteca** reúne os scripts, as paletas e os pincéis que você criou, salvou ou fez fork.
Eles ficam fora de qualquer sprite, então você pode usá-los em todos. A **biblioteca de scripts** é
o lado compartilhado: scripts que as pessoas publicaram, incluindo o conjunto **Oficial** feito pelo
pxstud.io. Paletas e pincéis não são compartilhados: o editor vem com um conjunto **Integrado** de
cada, e os que você salva são só seus.

| | Seus | Compartilhados ou integrados |
| - | - | - |
| Scripts | Scripts > Abrir meu script... | Scripts > Explorar a biblioteca de scripts... |
| Paletas | A aba **Minhas paletas** da Biblioteca de paletas | A aba **Integradas** dela |
| Pincéis | A aba **Meus pincéis** da Biblioteca de pincéis | A aba **Integrados** dela |

Abra a **Biblioteca de paletas** com o botão de biblioteca no topo da paleta, e a **Biblioteca de
pincéis** com o botão **Pincéis personalizados** nas opções de ferramenta do Lápis e do
Borracha.

Seus próprios itens ficam guardados neste navegador e funcionam offline, sem ter entrado na conta.
Com o Sync, eles também ficam na sua conta e são sincronizados com seus outros dispositivos. As
paletas e os pincéis integrados fazem parte do editor, então também funcionam offline e sem conta.

## Navegar pela biblioteca de scripts

A biblioteca de scripts precisa de uma conta gratuita no pxstud.io: entre com seu endereço de
e-mail e abra o link que enviarmos. Uma conta gratuita não guarda nada na nuvem, e o resto do
editor nunca precisa de uma.

- **Pesquise** por nome ou tag. Os resultados são atualizados conforme você digita.
- As **tags** na barra lateral restringem a lista, mostrando quantos scripts usam cada uma. Escolha
  até 3; um script precisa ter todas elas. Clicar em uma tag em um cartão também filtra por ela, e
  **Limpar filtros** recomeça do zero.
- **Todos os scripts** e **Oficiais** alternam entre tudo e apenas os scripts Oficiais.

Os resultados são ordenados por quantas pessoas executaram ou fizeram fork de cada script, contando
cada pessoa uma só vez (suas próprias execuções não contam). Seus scripts favoritos vêm primeiro.

Cada cartão mostra o nome do script, o autor e a versão, um selo **Oficial** ou **Seu** (**editado**
quando o seu rascunho é mais novo que o publicado), suas tags e quantas pessoas o executaram e
fizeram fork. Um cartão lista a última versão publicada. Para usar uma mais antiga, abra
**Versões** e escolha na lista **Versão**, que mostra a data e a nota de lançamento de cada versão;
os botões do cartão passam então a agir sobre essa versão.

## Executar e fazer fork

| Botão | O que faz |
| - | - |
| **Executar** | Executa no sprite atual, pedindo antes as opções dele, se tiver (um selo **Opções** no cartão avisa). |
| **Fazer fork** | Copia para a sua biblioteca e abre no painel de scripts, onde você pode alterá-lo. A cópia mantém o crédito ao original. |
| **Ver código** | Abre o código somente leitura, ou no editor de scripts se for seu. |

## Favoritos

O coração em um cartão **favorita** um script: cinza quando não está favoritado, vermelho quando
está. Os scripts favoritados aparecem primeiro em toda pesquisa e são salvos neste navegador, então
você ainda pode listá-los, executá-los e fazer fork deles **offline**: sem conexão, a biblioteca de
scripts mostra apenas os seus favoritos e avisa isso.

Seus scripts favoritados também ficam na página da sua conta, na prateleira **Favoritos** do grupo
Scripts, na seção **Biblioteca**. Clique com o botão direito em um deles ali para **Fazer fork para
os seus** ou **Desfavoritar**.

## Paletas e pincéis integrados

A aba **Integradas** da Biblioteca de paletas lista paletas clássicas de consoles e outras
populares do [Lospec](https://lospec.com/palette-list), cada uma com o crédito ao autor. **Usar**
substitui a paleta do sprite, **Anexar** adiciona as cores dela, e o botão de salvar guarda uma
cópia em Minhas paletas, mantendo o crédito. **Encontre mais no Lospec** abre a lista de paletas do
Lospec; importe uma pelo nome em Minhas paletas. Veja [Cor e
paletas](https://pxstud.io/pt-br/docs/manual/guides/color.md#the-palette-library).

A aba **Integrados** da Biblioteca de pincéis tem um conjunto de formas de pincel. **Selecionar**
desenha com uma delas, e o botão de salvar guarda uma cópia em Meus pincéis.

## Pincéis personalizados

A aba **Meus pincéis** da Biblioteca de pincéis tem um pequeno editor para criar pincéis:

1. Escolha o tamanho da grade: **8×8**, **16×16**, **32×32** ou **64×64**.
2. Clique em uma célula para preenchê-la ou esvaziá-la, ou arraste sobre várias células para pintar
   várias. **Limpar** esvazia a grade.
3. Dê um nome ao pincel e escolha **Salvar em Meus pincéis**.

Clique em **Selecionar** em um pincel salvo para desenhar com ele. Um pincel personalizado sempre
desenha no seu próprio tamanho, seja qual for a opção **Tamanho**; escolha uma das formas
integradas nas opções de ferramenta para voltar. O botão de lápis renomeia um pincel (digite o
nome e depois `Enter`; `Esc` cancela), e o botão de lixeira o exclui de Meus pincéis,
depois de perguntar. Excluir uma paleta de Minhas paletas pergunta da mesma forma.

## Suas paletas e scripts

- **Paletas:** a aba Minhas paletas salva, carrega, importa e exporta paletas. Veja [Cor e
  paletas](https://pxstud.io/pt-br/docs/manual/guides/color.md#the-palette-library).
- **Scripts:** Scripts > Novo script... cria um e Scripts > Abrir meu script... lista os seus, com renomear e
  excluir. Os scripts que você abriu recentemente ficam no fim do menu Scripts. A API de scripts
  está documentada na [referência de scripts](https://pxstud.io/pt-br/docs/scripting.md).

A [página da sua conta](https://app.pxstud.io/account) (a seção **Biblioteca**) também lista tudo
o que é seu, mesmo sem ter entrado: clique com o botão direito em um item (ou pressione
`Shift+F10`) para renomear, duplicar, baixar ou excluir.

## Publicar scripts

Publicar compartilha um script na biblioteca de scripts. Todo script tem um **rascunho**, a versão
que você edita, e **versões publicadas**. Cada vez que você publica, o rascunho vira a próxima
versão numerada, e as versões publicadas nunca mudam. As edições seguintes ficam no seu rascunho
(marcado como **editado**) até você publicar de novo, então quem usa seu script não é afetado pelo
trabalho em andamento.

Cada script também tem uma **visibilidade**. Tudo começa como **Privado**. Um script
**compartilhado** aparece na biblioteca de scripts desde a sua primeira versão publicada; um
privado que você publicou não aparece. Os scripts podem ter até 3 tags (cada uma com até 24
caracteres); enquanto você digita uma, são sugeridas as tags já em uso que combinam, com quantos
scripts as usam.

No painel de scripts, o botão de salvar guarda o seu rascunho e o botão de publicar o publica. O
selo **Privado** ou **Compartilhado** ao lado do nome do script (ou o botão de configurações) abre
as **Configurações do script**, com as tags, quem pode vê-lo e o histórico de versões, onde você
pode ler uma versão mais antiga ou **restaurá-la** no seu rascunho. A página da conta e a caixa de
diálogo Abrir script usam os mesmos selos: **Privado**, **Compartilhado v2** ou **Privado v2** para
um script publicado que é privado.

Alterar as tags ou a visibilidade de um script publicado vale na biblioteca de scripts
imediatamente. Excluir um script publicado também o tira da biblioteca de scripts.

## Contas

| | Sem conta | Conta gratuita | Com Sync |
| - | - | - | - |
| Paletas e pincéis integrados | Sim | Sim | Sim |
| Sua própria biblioteca | Neste navegador | Neste navegador | Também sincronizada |
| Navegar, executar, fazer fork e favoritar scripts | Não | Sim | Sim |
| Publicar scripts | Não | Não | Sim |

Um ano de Sync vem com o app para desktop ($20 uma única vez), que você obtém na [página da sua conta](https://app.pxstud.io/account). O Sync é opcional, e só é renovado se você ativar **Renovar automaticamente**.

**Quando o Sync termina**, sua conta continua sendo uma conta gratuita, seus scripts publicados e
compartilhados continuam na biblioteca de scripts, e você ainda pode despublicá-los ou excluí-los.
Seus próprios itens continuam nos seus navegadores. A cópia na nuvem de todo o resto (scripts não
publicados ou privados, suas paletas e seus pincéis) é mantida somente leitura por 180 dias e
depois excluída do servidor.