Restaura fotogramas recortados de Aseprite desde una hoja y JSON
Una hoja empaquetada de Aseprite ahorra espacio de textura al recortar los píxeles vacíos alrededor de cada pose. Si extraes esos rectángulos sin más, el personaje se desplaza de forma brusca porque cada recorte tiene un origen distinto. El JSON adjunto contiene la información necesaria para volver al lienzo original.
Exporta dos archivos desde la misma sesión de Aseprite
- Abre la animación en Aseprite y utiliza File → Export Sprite Sheet. Exporta una hoja PNG y activa la salida de datos JSON. El desempaquetador de ImageMint admite tanto el formato hash como el formato de matriz de JSON.
- Conserva la hoja y el JSON juntos. Un JSON de una exportación anterior puede apuntar a rectángulos que ya no coinciden con la hoja aunque los nombres sean parecidos.
- Si activas el recorte o la distribución empaquetada, conserva el JSON. Un divisor simple de celdas iguales no puede deducir solo de la hoja la posición original de fotogramas recortados de forma diferente.
- Carga la hoja exportada y el JSON en el desempaquetador. Examina varias poses antes de descargar el ZIP; no te fíes solo del primer fotograma.
Tres rectángulos, tres tareas diferentes
Considera un personaje dibujado en un lienzo de 64 × 64. Una pose recortada ocupa un rectángulo de 22 × 38 situado a 19 píxeles de la izquierda y 20 de la parte superior del lienzo original. El empaquetado puede colocar ese recorte en x=128, y=0 de la hoja exportada. El JSON necesita los tres datos:
| Campo JSON | Ejemplo | Qué significa |
|---|---|---|
frame | x=128, y=0, w=22, h=38 | De dónde extraer los píxeles de la hoja exportada. |
spriteSourceSize | x=19, y=20, w=22, h=38 | Dónde colocar ese recorte en el lienzo original del fotograma. |
sourceSize | w=64, h=64 | El tamaño completo del lienzo que se restaurará. |
El desempaquetador crea un fotograma transparente de 64 × 64, copia el recorte de 22 × 38 y lo dibuja en (19, 20). Repetirlo para cada pose conserva la línea de base del personaje. Las funciones de estos campos coinciden con Documentación de exportación de hojas/JSON de Aseprite; las posiciones exactas proceden de tu propio JSON.
Qué examinar en el ZIP descargado
Cada fotograma restaurado es un PNG numerado. manifest.json enumera nombres, duraciones en milisegundos, dimensiones y etiquetas. Compara reposo y ataque extremo: lienzos iguales y pies o anclaje estables. Si aún salta, el proyecto original puede tener dibujos desalineados; restaurar desplazamientos no corrige ese arte.
.aseprite archivos ni fotogramas empaquetados rotados. Admite hasta 100 fotogramas, 1024 píxeles por lado restaurado y 20 millones de píxeles en total. Si aparece un error de rotación, exporta sin rotarla y prueba de nuevo.Si solo necesitas celdas espaciadas uniformemente, el habitual Divisor de hojas de sprites es más sencillo. Usa restauración JSON si el empaquetado o recorte eliminó la cuadrícula uniforme.
Diagnostica una pareja coincidente que sigue viéndose mal
| Síntoma | Primera comprobación | Solución segura |
|---|---|---|
| meta.size no coincide | ¿Se redimensionó la hoja después de exportar? | Vuelve a exportar ambos archivos del mismo proyecto. |
| Aparece una pose incorrecta en un fotograma | ¿El JSON procede de otro empaquetado? | Sustituye la pareja aunque las dimensiones coincidan. |
| El lienzo es correcto, pero el personaje se desplaza | Compara las poses originales de Aseprite. | Corrige la alineación original; no borres los desplazamientos de recorte. |
| Error de rotación | ¿Se activó la rotación al empaquetar? | Exporta fotogramas sin rotación. |
Un nombre de archivo coincidente no es una validación, y unas dimensiones coincidentes por sí solas no demuestran que las coordenadas de recorte describan la imagen subida. Dos atlas pueden tener el mismo tamaño y distribuir las poses de manera diferente. Examina una pose distintiva, como un ataque con el arma extendida, en vez de juzgar solo un fotograma de reposo casi idéntico.
Lleva la temporización y las etiquetas a la siguiente aplicación
Un fotograma que dura 200 ms debe mantenerse más tiempo que uno de 80 ms. Los PNG restaurados contienen los píxeles, mientras que manifest.json contiene durationMs y las etiquetas de fotograma. Conserva ambos. Si pruebas los PNG en un reproductor con FPS uniformes, es normal obtener un ritmo distinto aunque la colocación sea perfecta.
Las etiquetas identifican rangos como reposo y caminata, pero conservarlas no configura estados de animación del motor. Revisa rangos y dirección en la aplicación receptora. La vista previa ayuda a alinear; no exporta automáticamente el controlador del motor.
Prueba el flujo de trabajo
Carga la hoja y su JSON correspondiente para previsualizar fotogramas alineados y descargar PNG a tamaño completo.
Restaura fotogramas de Aseprite →