Files
Tahgibu/README.md
T
2026-09-19 14:13:13 -03:00

65 lines
3.3 KiB
Markdown

# Tahgibu Animator
Animador 2D cuadro por cuadro, simple y sin marca de agua. Pensado para andar
liviano incluso en notebooks modestas con gráfica integrada.
## Características
- Frame por frame real, con miniaturas en la timeline.
- Timeline con scroll (rueda del mouse) para animaciones con muchos frames.
- `F7` crea un frame nuevo. `←` / `→` navegan. `Inicio`/`Fin` van al primero/último.
- `Ctrl+V` pega imágenes del portapapeles (necesita `wl-clipboard` en Wayland).
- Dos lápices:
- Lápiz suave: acumula densidad al pasar varias veces (con difuminado).
- Lápiz sólido: 100% de densidad.
- Borrador que **de verdad borra** (baja la transparencia del trazo).
- Selector de color y tamaño de pincel.
- Onion Skin (ve el frame anterior/siguiente semi-transparente).
- Fondos: botón para elegir o quitar una imagen de fondo.
- Sprites: se agregan, se pueden quitar de la lista, y se colocan con un clic
directo en el lienzo (apuntá y hacé clic; `Esc` cancela).
- Deshacer / Rehacer (`Ctrl+Z` / `Ctrl+Y`) livianos en memoria: no duplican
toda la animación en cada trazo, así no se cuelga en equipos con poca RAM.
- FPS configurable y reproducción (`Espacio`).
- Exportar a **GIF animado** o a una **secuencia de PNG**.
- Guardar / abrir / importar proyectos `.tgb` (el archivo lleva adentro todos
los frames, el fondo y los sprites, así se puede mover a otra PC sin
necesitar los archivos originales).
- Confirma antes de perder cambios sin guardar (al crear nuevo, abrir otro
proyecto o cerrar la ventana).
- Sin marca de agua, nunca.
## Qué se corrigió respecto a la versión anterior (ASM Animator)
- **El borrador no borraba nada** (dibujaba "transparente sobre transparente"
y no tenía ningún efecto visible). Ahora sí funciona.
- **No existía ningún botón para poner un fondo**, aunque el formato de
archivo y el propio programa lo mencionaban. Se agregó "Fondo: Elegir/Quitar".
- **No había Rehacer** (`redo`), solo Deshacer.
- El Deshacer copiaba **toda la animación completa** en cada trazo de lápiz.
Con varios frames esto podía consumir varios GB de RAM y trabar el equipo.
Ahora cada acción guarda solo lo mínimo necesario para revertirla.
- El lápiz suave aplicaba un difuminado sobre el lienzo completo en cada
movimiento del mouse, algo pesado en gráficas integradas. Ahora solo procesa
la zona del trazo.
- La timeline no tenía forma de desplazarse: con muchos frames, los cuadros
quedaban fuera de la pantalla y no se podían seleccionar. Ahora tiene
scroll y miniaturas reales de cada frame.
- Se podía perder trabajo sin guardar sin ningún aviso al cerrar o crear un
proyecto nuevo. Ahora se confirma antes.
- Los sprites agregados no se guardaban dentro del proyecto `.tgb`. Ahora sí.
- No había forma de sacar la animación fuera del programa. Se agregó
exportar a GIF y a secuencia de PNG.
## Instalar en CachyOS / Arch
```bash
sudo pacman -S python python-pillow wl-clipboard
./install.sh
```
Después abrí **Tahgibu Animator** desde el menú de aplicaciones (o ejecutá
directamente `python3 tahgibu_animator.py`).
## Formato de archivo
`.tgb` es el formato propio del proyecto (JSON con las imágenes en base64
adentro). También podés **abrir e importar** archivos `.asm` de la versión
anterior del programa: son totalmente compatibles.