[Herramienta] GBA Background Studio - Conversor Avanzado de Imágenes a Assets de GBA

[CompuMax]

GBA Background Studio
Conversor Avanzado de Imágenes a Assets de GBA

​

Introducción
GBA Background Studio es una suite de desarrollo profesional diseñada para simplificar la creación de fondos, portadas e interfaces para GBA. A diferencia de otras herramientas, ofrece un flujo de trabajo "Zero-Prep": puedes importar imágenes sin indexado previo y el motor integrado se encarga de la cuantización (K-Means), gestión de transparencia y optimización de tiles de forma automática.

Características Principales

• Arquitectura Híbrida Qt: Motor inteligente que detecta automáticamente tu sistema para ofrecer la mejor interfaz disponible (PySide6 o PySide2).
• Conversión Integral "Zero-Prep": Transforma cualquier imagen (sin necesidad de indexado previo) directamente en Tileset, Paleta y Tilemap compatibles con el hardware de GBA.
• Soporte de Modos de Vídeo: Conversión nativa tanto para Modo Texto como para Modo Rotación/Escalado (Affine), con capacidad de alternar entre modos en cualquier momento.
• Control de Color Profesional (4bpp/8bpp):
  
  - En 4bpp: Gestión de múltiples paletas y uso de Tilemaps de entrada para asignar paletas específicas a cada tile.​
  - En 8bpp: Control total sobre el índice de origen y el tamaño de la paleta.​
  - Gotero Integrado: Selecciona el color transparente (Color 0) directamente desde la imagen original.​
• Preview en Tiempo Real: Valida recortes, rellenos y transformaciones antes de exportar.
• Gestión Avanzada de Mapas Grandes: Procesa imágenes de ancho superior a un BG estándar (como fondos de batalla de 512px) tal como se ven en la consola. Olvida las "artimañas" de reordenar imágenes; usa formatos naturales como 64x32 en lugar de arreglos manuales de 32x64.
• Optimización Inteligente: Optimiza el Tileset para reducir el número de Tiles únicos o "desoptimízalo" automáticamente para garantizar compatibilidad con el Modo Affine.
• Editor de Tiles y Paletas: Selección visual con herramientas para copiar, cortar, pegar, rotar y voltear (Flip/Mirror) áreas de tiles. Edición profunda de paletas que permite mover o intercambiar colores y slots de paletas completos.
• Flujo de Trabajo No Destructivo: Control total del historial con un sistema robusto de Deshacer/Rehacer (Undo/Redo) en todas las acciones.
• Multilingüe: Interfaz disponible en 18 idiomas, incluyendo Español e Inglés.
• Asistente CLI: Asistente guiado por línea de comandos para conversiones rápidas.

Capturas de Pantalla

Interfaz de conversión visual y configuración de modos.


Vista previa en tiempo real para validar tus assets.


Edición profunda de tilemaps y tilesets.


Gestión precisa de paletas.
​

Requisitos y Descarga
Gracias al nuevo núcleo híbrido, la herramienta ahora es compatible con una gama más amplia de sistemas:

• Sistemas Modernos: Windows 10/11, Linux y macOS (vía Python 3.10+ y PySide6).
• Sistemas Legacy: Soporte nativo para Windows 7, 8 y 8.1 (vía Python 3.8 y PySide2).
• Portabilidad: El instalador incluye un Updater.exe para mantener la herramienta al día sin complicaciones.

Descarga GBA Background Studio en GitHub ​

Guía Rápida

1. Importa: Abre cualquier imagen (no necesita estar indexada).​

2. Configura: Elige el modo de vídeo y la profundidad de color (4bpp/8bpp).​

3. Edita: Selecciona áreas, realiza flips o ajusta la paleta con feedback visual instantáneo.​

4. Exporta: Genera tileset (.png), tilemap (.bin) y paleta (.pal) listos para insertar en tu proyecto.​

Apoya el Proyecto
Si esta herramienta te ahorra horas de trabajo, ¡invítame a un café!


Contribuciones
Proyecto de código abierto bajo licencia GPL-3.0. ¡Reportes de errores y sugerencias son siempre bienvenidos en GitHub!

¡Únete a la comunidad en Discord!

¿Dudas técnicas o quieres mostrar tus avances? ¡Te esperamos en CompuMax Dev's!

Soporte bilingüe y comunidad de desarrollo GBA.​

Desarrollado con por CompuMax​

 

[Micael_Alighieri]

Menuda maravilla has montado, ¿cuánto tiempo llevas trabajando en ello? Y tengo mucha curiosidad, ¿podrías explicar en qué consiste el K-means?

¡Muchísimas gracias por este aportazo!

 

[Xiros]

Buenísimo lo que veo! La voy a estar probando en breves!!

Que bueno ver herramientas de este estilo publicarse!

 

[gameboy_cl]

qué lindo ver aportes nuevos en la comunidad! se ve todo muy bien, la estaré usando estos días
muchas gracias!

 

[CompuMax]

Menuda maravilla has montado, ¿cuánto tiempo llevas trabajando en ello? Y tengo mucha curiosidad, ¿podrías explicar en qué consiste el K-means?

¡Muchísimas gracias por este aportazo!

Que bueno que la herramienta esté teniendo tan buena aceptación!

Empecé la aplicación hace unos 7 meses (según los commits) aunque también debo admitir que lo pausé por mucho tiempo.
El K-means es un algoritmo de agrupamiento (clustering) cuyo objetivo es clasificar un conjunto de datos en grupos distintos basándose en la distancia entre los puntos, básicamente un algoritmo utilizado para reducir los colores de una imagen de la manera más eficiente posible.
La aplicación tiene muchas funciones que creo que debí haber mencionado en el post, aún así tengo pensando hacer una Wiki en el repositorio con sus funcionalidades. Pero en resumen puedes;
- Convertir cualquier imagen en archivos compatibles para cargar dicha imagen en los BG de la GBA, generando Tiles, Paleta y Tilemap de una vez
- Convertir tanto en el Modo Texto como en Modo Rotación/Escalado (Affin)
- Convertir en 4bpp y 8bpp
- En modo 4bpp puedes seleccionar múltiples paletas o usar un Tilemap de entrada para indicar qué tiles usarán qué paletas
- En modo 8bpp puedes indicar el índice de origen de la paleta y su tamaño
- Seleccionar el color transparente directamente en la imagen haciendo uso del gotero
- Convertir de 4bpp a 8bpp y viceversa
- Convertir de Modo Texto a Rotación/Escalado y viceversa
- Optimizar el Tileset para reducir Tiles; y Desoptimizarlo para agregar compatibilidad con el Modo Rotación/Escalado
- Importar y Exportar recursos (Tiles, Paletas y Tilemaps)
- Editar la paleta en su totalidad, desde mover o intercambiar colores, hasta mover paletas completas de slots en el Modo 4bpp
- Seleccionar áreas de Tiles, copiarlos, cortarlos, pegarlos, rotarlos, etc.
- Guardar Tilemap a partir de un área seleccionada
Y lo más importante, hay control total del historial de cambios, pudiendo deshacer/rehacer cambios en cualquier momento.
En definitiva es una herramienta bastante completa y a diferencia de las otras que existen, las imágenes de ancho superior a un BG, como las de los fondos de batalla, se pueden procesar tal como se ven en la GBA y no hay que hacer artimañas para ordenar la imagen y poder generar el Tilemap de manera correcta, es decir, puedes usar la imagen 64x32 en lugar de hacer un arreglo de 32x64... Y muchas funciones más!

 

[CompuMax]

GBA Background Studio v1.1.0 | Infrastructure & Optimization Update​

¡Hola a todos! Traigo la primera gran actualización de la herramienta. La v1.1.0 no solo corrige errores visuales, sino que establece la base técnica para que las futuras actualizaciones sean automáticas y mucho más ligeras.

Esta versión marca un hito importante, estableciendo las bases para un ciclo de desarrollo más ágil y corrigiendo detalles críticos de la interfaz y la documentación.

Novedades principales:

• Listo para Auto-Updates: El instalador ahora está optimizado para la nueva función "Buscar actualizaciones".
• Wizard Legacy Inteligente: El archivo .bat ahora verifica e instala automáticamente las dependencias de Python (Pillow, NumPy, etc.).
• Correcciones de UI: Solucionado el bug de textos en el diálogo de conversión 4bpp.
• Docs Robustas: Todas las imágenes de los manuales ahora se alojan internamente para garantizar su visibilidad.

Nota: Debido a que la v1.0.0 fue un lanzamiento OneFile, se recomienda realizar una instalación limpia con esta nueva versión para habilitar las actualizaciones automáticas en el futuro.

DESCARGAR v1.1.0

Comunidad y Soporte:
Servidor de Discord Oficial | Reportar un Error (GitHub)​

 

[zekrom007]

que genial herramienta ojala existiera una asi para portadas ya que con hexmaniac se buguean cuando se cambian

 

[CompuMax]

que genial herramienta ojala existiera una asi para portadas ya que con hexmaniac se buguean cuando se cambian

La herramienta genera sin problemas los recursos necesarios para insertar portadas de hasta 256 colores, los "bugs" que puedas notar al insertarla se deben a ajustes que debes hacer en la rom para eliminar las llamas (en caso FireRed), el efecto de brillo, los textos de PRESS START, etc.

Había un tutorial excelente:
FR | Insertar portada de 240 colores

Pero las imágenes están caídas y puede ser un poco difícil de seguir para alguien inexperto. Pero básicamente usando la herramienta te podrías saltar los primeros pasos y pasar directamente a insertar los nuevos recursos (que se harían en solo 2 pasos con GBA Graphics Editor: primero Tiles y Paleta ;y luego Tilemap) y luego al Paso 6 Removiendo efectos, brillos, y cosas "Bugeantes".

 

[ACE10]

Eres un hijo de puta @CompuMax jajaja tenías que ser tu el que diseñará está maravilla de herramienta...

Cosas buenas, bonitas y bien que apasionan de ver, muchas felicidades por tu diseño amigo

 

[MrNightology]

Enhorabuena @CompuMax por esta herramienta que, como diría la Pantoja, es MA-RA-VI-LLO-SA

Esta tarde la descargaré y probaré a trastear imágenes a ver qué me tal va (que seguro que genial )

 

[CompuMax]

GBA Background Studio v2.0.0 | The Compatibility & Stability Update​

¡Hola a todos! Tras el gran recibimiento de la versión inicial, traigo la v2.0.0, una actualización que redefine la compatibilidad de la herramienta.

El gran hito de esta versión es la transición a un estado híbrido PySide6/PySide2. Gracias a un nuevo motor de detección automática, la herramienta ahora es compatible de forma nativa con Windows 7, 8 y 8.1 utilizando Python 3.8, mientras que sigue aprovechando toda la potencia de Python 3.10+ y PySide6 en sistemas modernos. ¡Se acabó el depender exclusivamente del modo CLI para sistemas antiguos!

Novedades principales:

• Compatibilidad Universal (Hybrid Qt): Detección automática del backend Qt según tu versión de Python para soporte total en Windows 7, 8 y 8.1.
• Flujo de Selección Intuitivo: Se ha invertido la lógica de "Guardar Selección". Ahora simplemente seleccionas un área en el Tilemap y luego pulsas Guardar Selección. Es mucho más natural y rápido que el método anterior.
• Flujo de Archivos Inteligente: La app ahora recuerda el último directorio utilizado en cada sesión para todas las operaciones, agilizando el ritmo de trabajo.
• Editor de Selección Potenciado: Corregidos errores en la herramienta "Seleccionar Área", reactivación correcta de botones (Voltear, Reflejar, Intercambiar) y dimensiones en tiempo real en la barra de estado.
• Conversión con Preview Real: El diálogo de conversión ahora muestra exactamente cómo quedará tu imagen (recorte o relleno) antes de procesarla.
• Motor 4bpp Refinado: Se corrigieron errores en el manejo de la transparencia cuando el color coincidía con entradas existentes de la paleta.
• Seguridad en Exportación: Se ha añadido un diálogo de confirmación antes de sobrescribir archivos existentes.

Nota técnica: Se han corregido múltiples erratas visuales (como el famoso "Save Tilset" → "Save Tileset") y errores de desplazamiento (scroll) al aplicar rellenos en el tilemap para una experiencia mucho más fluida.

DESCARGAR v2.0.0

Comunidad y Soporte:
Servidor de Discord Oficial | Reportar un Error (GitHub)​