Para usuarios de Aseprite
Desempaquetador de hojas de sprites de Aseprite
Exporta una imagen de hoja de sprites y sus datos JSON desde Aseprite. Esta herramienta restaura cada fotograma recortado al tamaño de su lienzo original.
Ejemplo: sheet.png + sheet.json → PNG de fotogramas a tamaño completo
Prueba esta herramienta- 1. AñadirImagen de Aseprite + JSON
- 2. AjustaRestaura posiciones de fotogramas
- 3. GuardaPNG a tamaño completo en un ZIP
1. Añade ambos archivos exportados desde Aseprite
En Aseprite, exporta una hoja de sprites con sus datos JSON. Elige la imagen y el JSON de la misma exportación.
Cómo utilizarlo
1. Exporta la imagen y el JSON juntos
Exporta una hoja de sprites con metadatos JSON en Aseprite y conserva ambos archivos de esa exportación. Esta herramienta lee hojas PNG o WebP con JSON en formato de matriz o hash, no proyectos nativos .ase o .aseprite.
2. Carga la pareja correspondiente
Elige A. La hoja de imágenes y B. Los datos JSON correspondientes y después restaura. El importador comprueba meta.size y cada recorte y desplazamiento. No reutilices un JSON antiguo después de volver a empaquetar o redimensionar la hoja.
3. Examina y guarda la secuencia restaurada
Usa el control Fotograma y la reproducción para revisar la alineación. Cada recorte se sitúa en su lienzo sourceSize con los desplazamientos spriteSourceSize. Descarga el ZIP y conserva manifest.json para nombres, duraciones y etiquetas.
Tres rectángulos explican por qué saltan los sprites recortados
frame localiza píxeles en la hoja: x e y son coordenadas del atlas, no posiciones originales. sourceSize indica el lienzo original y spriteSourceSize la posición del recorte dentro.
Una pose de 64 × 64 recortada a 22 × 38 puede estar en (128, 0) dentro de la hoja, pero en (19, 20) dentro del fotograma original. La restauración crea un lienzo transparente de 64 × 64, copia ese rectángulo de 22 × 38 y lo coloca en (19, 20). Dibujarlo en (0, 0) desplazaría al personaje.
La restauración no deshace movimientos intencionados dentro del fotograma ni inventa pivotes. El manifiesto conserva etiquetas y duraciones, pero la aplicación receptora debe utilizarlas. Reproducir con FPS uniformes no conserva automáticamente pausas desiguales.
| Ajuste o entrada | Qué significa |
|---|---|
| frame: 128, 0, 22, 38 | Lee este rectángulo de la hoja |
| spriteSourceSize: 19, 20, 22, 38 | Coloca el recorte en (19, 20) |
| sourceSize: 64 × 64 | Exporta un PNG del lienzo completo |
| duration: 100 | Retain 100 ms in manifest.json |
Comprueba antes de descargar
Coincidir en dimensiones no demuestra coincidir en empaquetado
Dos exportaciones pueden tener las mismas dimensiones y distintas distribuciones. Examina poses reconocibles al principio y al final y usa archivos producidos en la misma exportación.
Mantente dentro del formato de exportación compatible
No se admiten fotogramas rotados. Límites: JSON de 2 MB, imagen de 20 MB, 100 fotogramas, lados de hoja de 4096 px, 16 millones de píxeles por hoja, lados de fotograma restaurado de 1024 px y 20 millones de píxeles restaurados en total.
Preguntas
¿Puedo subir un proyecto nativo de Aseprite?
No. Exporta primero una hoja y JSON. No se cargan capas editables, cels ni la estructura nativa del proyecto.
¿Por qué se rechazan fotogramas empaquetados con rotación?
Este importador procesa recortes sin rotar. Vuelve a exportar sin rotación. Cambiar rotated a false en el JSON interpretaría mal los píxeles almacenados en vez de corregirlos.
¿Por qué los PNG son mayores que los recortes empaquetados?
Cada uno utiliza el lienzo sourceSize original y sus márgenes transparentes. Eso conserva la alineación de las poses. Mantén el atlas empaquetado cuando busques almacenamiento compacto de texturas.
¿El ZIP conserva la temporización?
Las duraciones y las etiquetas válidas de fotograma están en manifest.json. Los PNG por sí solos no tienen temporización de reproducción. Importa o reproduce los metadatos en el editor o motor de destino.
¿Qué debo hacer tras un error de dimensiones?
Compara meta.size con la imagen y comprueba si se redimensionó o volvió a empaquetar después de exportar. Regenera ambos archivos juntos en vez de modificar los metadatos para eludir la validación.
Herramientas y tutoriales relacionados
Restaura fotogramas recortados de Aseprite — Sigue el ejemplo de desplazamiento y diagnostica una línea de base que se mueve.
Animador de hojas de sprites — Prueba los fotogramas restaurados a FPS uniformes si no necesitas duraciones distintas.
Documentación de exportación de Aseprite — Lee las instrucciones del editor para generar una hoja y datos correspondientes.