Para usuários do Aseprite
Extrator de folhas de sprites do Aseprite
Exporte uma imagem de folha de sprites e seus dados JSON do Aseprite. Esta ferramenta restaura cada quadro recortado ao tamanho original da tela.
Exemplo: sheet.png + sheet.json → PNGs de quadros em tamanho completo
Experimente esta ferramenta- 1. AdicioneImagem do Aseprite + JSON
- 2. AjusteRestaurar posições dos quadros
- 3. SalvePNGs em tamanho completo em um ZIP
1. Adicione os dois arquivos exportados do Aseprite
No Aseprite, exporte uma folha de sprites com seus dados JSON. Escolha a imagem e o JSON da mesma exportação.
Como usar
1. Exporte a imagem e o JSON juntos
Exporte uma folha de sprites com metadados JSON no Aseprite e guarde os dois arquivos dessa exportação. Esta ferramenta lê folhas PNG ou WebP com dados JSON em array ou hash, não projetos nativos .ase ou .aseprite.
2. Carregue o par correspondente
Escolha A. A folha de imagens e B. Os dados JSON correspondentes e restaure. O importador verifica meta.size e cada recorte e deslocamento. Não reutilize um JSON antigo depois de empacotar ou redimensionar a folha novamente.
3. Examine e salve a sequência restaurada
Use o controle deslizante de Quadro e a prévia de reprodução para examinar o alinhamento. Cada recorte é colocado em sua tela sourceSize usando os deslocamentos de spriteSourceSize. Baixe o ZIP e guarde manifest.json para nomes, durações e tags de quadros.
Três retângulos explicam por que sprites aparados saltam
frame localiza os pixels dentro da folha empacotada. Seus x e y são coordenadas do atlas, não a posição original do personagem. sourceSize fornece as dimensões originais da tela de imagem. spriteSourceSize fornece a posição do recorte dentro dessa tela.
Uma pose de 64 × 64 aparada para 22 × 38 pode estar em (128, 0) na folha, mas em (19, 20) no quadro original. A restauração cria uma tela transparente de 64 × 64, copia esse retângulo de 22 × 38 e o posiciona em (19, 20). Desenhá-lo em (0, 0) deslocaria o personagem.
A restauração não desfaz movimentos intencionais dentro do quadro original nem inventa um novo pivô. As tags e durações são mantidas no manifesto, mas o aplicativo de destino precisa usá-las. A reprodução com FPS uniformes não preserva automaticamente uma pausa de duração diferente.
| Configuração ou entrada | O que significa |
|---|---|
| frame: 128, 0, 22, 38 | Leia este retângulo da folha |
| spriteSourceSize: 19, 20, 22, 38 | Posicione o recorte em (19, 20) |
| sourceSize: 64 × 64 | Exporte um PNG da tela completa |
| duration: 100 | Retain 100 ms in manifest.json |
Confira antes de baixar
Dimensões iguais não comprovam empacotamento correspondente
Duas exportações podem ter tamanhos idênticos, mas disposições diferentes. Examine poses reconhecíveis no início e no fim e use arquivos produzidos na mesma exportação.
Use o formato de exportação compatível
Quadros rotacionados não são aceitos. Limites: JSON de 2 MB, imagem de 20 MB, 100 quadros, lados da folha de 4096 px, 16 milhões de pixels na folha, lados dos quadros restaurados de 1024 px e 20 milhões de pixels restaurados no total.
Perguntas
Posso adicionar um projeto nativo do Aseprite?
Não. Exporte uma folha e o JSON primeiro. Camadas editáveis, cels e a estrutura nativa do projeto não são carregadas.
Por que quadros empacotados com rotação são rejeitados?
Este importador trabalha com recortes sem rotação. Exporte novamente sem rotação. Mudar rotated para false no JSON faria os pixels armazenados serem interpretados incorretamente, em vez de corrigi-los.
Por que os PNGs são maiores que os recortes empacotados?
Cada um usa a tela sourceSize original e seu preenchimento transparente. Isso preserva o alinhamento das poses. Mantenha o atlas empacotado quando o objetivo for armazenar texturas de forma compacta.
O ZIP preserva os tempos?
As durações e as tags válidas dos quadros estão em manifest.json. Arquivos PNG sozinhos não têm tempos de reprodução. Importe ou reproduza os metadados no editor ou na engine de destino.
O que devo fazer após um erro de dimensões?
Compare meta.size com a imagem e verifique se houve redimensionamento ou novo empacotamento após a exportação. Gere novamente os dois arquivos juntos, em vez de alterar os metadados para contornar a validação.
Ferramentas e tutoriais relacionados
Restaurar quadros aparados do Aseprite — Siga o exemplo de deslocamento e diagnostique uma linha de base que se move.
Animador de folhas de sprites — Teste os quadros restaurados com FPS uniformes quando durações diferentes forem desnecessárias.
Documentação de exportação do Aseprite — Leia as instruções do editor para gerar uma folha e dados correspondentes.