# La biblioteca

Encuentra y ejecuta scripts que otras personas compartieron, marca con corazón los que uses, conserva tus propios scripts, paletas y pinceles, y publica scripts.

_Los atajos están escritos para Windows y Linux. En un Mac, usa ⌘ Cmd donde dice Ctrl y ⌥ Option donde dice Alt._

Tu **biblioteca** son los scripts, paletas y pinceles que creaste, guardaste o bifurcaste. Viven fuera de
cualquier sprite, así que puedes usarlos en todos. La **biblioteca de scripts** es la parte compartida:
los scripts que la gente ha publicado, incluido el conjunto **Oficial** creado por pxstud.io. Las paletas y
los pinceles no se comparten: el editor trae un conjunto **Integrado** de cada uno, y los que guardas son
solo tuyos.

| | Tuyos | Compartidos o integrados |
| - | - | - |
| Scripts | Scripts > Abrir mi script... | Scripts > Explorar la biblioteca de scripts... |
| Paletas | La pestaña **Mis paletas** de la Biblioteca de paletas | Su pestaña **Integradas** |
| Pinceles | La pestaña **Mis pinceles** de la Biblioteca de pinceles | Su pestaña **Integrados** |

Abre la **Biblioteca de paletas** con el botón de biblioteca de la parte superior de la paleta, y la **Biblioteca de
pinceles** con el botón **Pinceles personalizados** en las opciones de herramienta del Lápiz y de la
Borrador.

Tus propios elementos se guardan en este navegador y funcionan sin conexión y sin iniciar sesión. Con Sync también
se guardan en tu cuenta y se sincronizan con tus otros dispositivos. Las paletas y los pinceles integrados forman parte
del editor, así que también funcionan sin conexión y sin iniciar sesión.

## Explora la biblioteca de scripts

La biblioteca de scripts necesita una cuenta gratuita de pxstud.io: inicia sesión con tu correo electrónico y abre
el enlace que te enviamos. Una cuenta gratuita no guarda nada en la nube, y el resto del editor
nunca necesita una.

- **Busca** por nombre o etiqueta. Los resultados se actualizan mientras escribes.
- Las **etiquetas** de la barra lateral acotan la lista, con cuántos scripts usan cada una. Elige hasta 3; un script
  debe tenerlas todas. Hacer clic en una etiqueta de una tarjeta también filtra por ella, y **Quitar filtros** empieza
  de nuevo.
- **Todos los scripts** y **Oficiales** permiten elegir entre todo y solo los scripts Oficiales.

Los resultados se ordenan según cuántas personas ejecutaron o bifurcaron cada script, contando a cada persona una sola vez
(tus propias ejecuciones no cuentan). Tus scripts marcados con corazón van primero.

Cada tarjeta muestra el nombre del script, su autor y versión, una insignia **Oficial** o **Tuyo** (**editado**
cuando tu borrador es más reciente que lo publicado), sus etiquetas, y cuántas personas lo ejecutaron
y lo bifurcaron. Una tarjeta muestra la última versión publicada. Para usar una anterior, abre
**Versiones** y elígela en la lista **Versión**, que muestra la fecha y la nota de lanzamiento de cada versión;
los botones de la tarjeta actúan entonces sobre esa versión.

## Ejecutar y bifurcar

| Botón | Qué hace |
| - | - |
| **Ejecutar** | Lo ejecuta en el sprite actual, pidiendo antes sus opciones si las tiene (una insignia **Opciones** en la tarjeta lo indica). |
| **Bifurcar** | Lo copia en tu biblioteca y lo abre en el panel de scripts, donde puedes cambiarlo. La copia conserva el crédito al original. |
| **Ver código** | Abre el código en modo de solo lectura, o en el editor de scripts si es tuyo. |

## Corazones

El corazón de una tarjeta **marca con corazón** un script: gris cuando no está marcado, rojo cuando lo está. Los scripts
marcados con corazón aparecen primero en cada búsqueda y se guardan en este navegador, así que aún puedes listarlos,
ejecutarlos y bifurcarlos **sin conexión**: sin conexión, la biblioteca de scripts muestra solo tus scripts
marcados con corazón, y lo indica.

Tus scripts marcados con corazón también están en la página de tu cuenta, en el estante **Con corazón** del grupo Scripts
de su sección **Biblioteca**. Haz clic derecho en uno para **Bifurcar a los tuyos** o **Quitar corazón**.

## Paletas y pinceles integrados

La pestaña **Integradas** de la Biblioteca de paletas lista paletas de consolas clásicas y otras populares de
[Lospec](https://lospec.com/palette-list), cada una con el crédito de su autor. **Usar** reemplaza la paleta
del sprite, **Añadir al final** añade sus colores, y el botón de guardar guarda una copia en Mis paletas,
conservando el crédito. **Encuentra más en Lospec** abre la lista de paletas de Lospec; importa una por nombre en Mis
paletas. Consulta [Color y paletas](https://pxstud.io/es/docs/manual/guides/color.md#the-palette-library).

La pestaña **Integrados** de la Biblioteca de pinceles tiene un conjunto de formas de pincel. **Seleccionar** dibuja con una, y el botón de
guardar guarda una copia en Mis pinceles.

## Pinceles personalizados

La pestaña **Mis pinceles** de la Biblioteca de pinceles tiene un pequeño editor para crear pinceles:

1. Elige un tamaño de cuadrícula: **8×8**, **16×16**, **32×32** o **64×64**.
2. Haz clic en una celda para rellenarla o vaciarla, o arrastra sobre varias celdas para pintarlas. **Borrar** vacía la
   cuadrícula.
3. Ponle nombre al pincel y elige **Guardar en Mis pinceles**.

Haz clic en **Seleccionar** en un pincel guardado para dibujar con él. Un pincel personalizado siempre dibuja a su propio tamaño,
sea cual sea la opción **Tamaño**; elige una de las formas integradas en las opciones de herramienta para
volver. El botón del lápiz renombra un pincel (escribe el nombre y pulsa `Enter`; `Esc` cancela),
y el botón de la papelera lo elimina de Mis pinceles, tras pedir confirmación. Eliminar una paleta de Mis
paletas pide confirmación de la misma manera.

## Tus paletas y scripts

- **Paletas:** la pestaña Mis paletas guarda, carga, importa y exporta paletas. Consulta [Color y
  paletas](https://pxstud.io/es/docs/manual/guides/color.md#the-palette-library).
- **Scripts:** Scripts > Nuevo script... crea uno y Scripts > Abrir mi script... lista los tuyos, con renombrar y
  eliminar. Los scripts que abriste recientemente están al final del menú Scripts. La API de scripting está
  documentada en la [referencia de scripting](https://pxstud.io/es/docs/scripting.md).

La [página de tu cuenta](https://app.pxstud.io/account) (su sección **Biblioteca**) también lista todo lo tuyo, incluso sin iniciar sesión: haz clic derecho en un
elemento (o pulsa `Shift+F10`) para renombrarlo, duplicarlo, descargarlo o eliminarlo.

## Publicar scripts

Publicar comparte un script en la biblioteca de scripts. Cada script tiene un **borrador**, la versión que
editas, y **versiones publicadas**. Cada vez que publicas, el borrador se convierte en la siguiente versión
numerada, y las versiones publicadas nunca cambian. Las ediciones posteriores se quedan en tu borrador (marcado como
**editado**) hasta que vuelvas a publicar, así que quienes usan tu script no se ven afectados por el trabajo
en curso.

Cada script también tiene una **visibilidad**. Todo empieza como **Privado**. Un script **compartido** aparece
en la biblioteca de scripts desde su primera versión publicada; uno privado que publicaste
no aparece. Los scripts pueden tener hasta 3 etiquetas (de hasta 24 caracteres cada una); mientras escribes una,
se sugieren las etiquetas ya en uso que coinciden, con cuántos scripts las usan.

En el panel de scripts, el botón de guardar guarda tu borrador y el botón de publicar lo publica. La insignia
**Privado** o **Compartido** junto al nombre del script (o el botón de ajustes) abre los **Ajustes del
script**, con sus etiquetas, quién puede verlo y su historial de versiones, donde puedes leer una versión
anterior o **restaurarla** en tu borrador. La página de la cuenta y el cuadro de diálogo Abrir script usan
las mismas insignias: **Privado**, **Compartido v2**, o **Privado v2** para un script publicado que es privado.

Cambiar las etiquetas o la visibilidad de un script publicado surte efecto en la biblioteca de scripts al instante.
Eliminar un script publicado también lo saca de la biblioteca de scripts.

## Cuentas

| | Sin cuenta | Cuenta gratuita | Con Sync |
| - | - | - | - |
| Paletas y pinceles integrados | Sí | Sí | Sí |
| Tu propia biblioteca | En este navegador | En este navegador | También sincronizada |
| Explorar, ejecutar, bifurcar y marcar con corazón scripts | No | Sí | Sí |
| Publicar scripts | No | No | Sí |

Un año de Sync viene con la app de escritorio ($20 una sola vez), que consigues en la [página de tu cuenta](https://app.pxstud.io/account). Sync es opcional, y solo se renueva si activas **Renovación automática**.

**Cuando termina Sync**, tu cuenta sigue siendo gratuita, tus scripts publicados y compartidos permanecen en la biblioteca de scripts, y
aún puedes dejar de publicarlos o eliminarlos. Tus propios elementos se quedan en tus navegadores. La copia en la nube de
todo lo demás (scripts sin publicar o privados, tus paletas y pinceles) se conserva en modo de solo lectura durante
180 días y luego se elimina del servidor.
