Por que converter ASEPRITE para JSON?
Motores de jogos e frameworks como Phaser, PixiJS e Unity precisam de coordenadas de quadros e metadados de animação, não apenas de uma imagem. Exportar para .json fornece a eles um atlas legível por máquina que mapeia cada quadro e tag dentro da folha de sprites acompanhante, por isso este processo combina o PNG com um arquivo de dados.
Como converter ASEPRITE para JSON
Diálogo Export Sprite Sheet EASIEST
Escolha File > Export > Export Sprite Sheet, ative a caixa de seleção JSON Data e escolha um nome para o arquivo de dados. O Aseprite gravará o PNG da folha mais o atlas .json.
CLI do Aseprite
Execute aseprite -b sprite.aseprite --sheet sheet.png --data sheet.json --format json-hash para gerar o atlas via linha de comando; use --format json-array para uma lista ordenada.
CLI do Aseprite para stdout
Use aseprite -b --data="" sprite.aseprite para imprimir o JSON diretamente no console para scripts ou integração em etapas de compilação.
Sobre estes formatos
Um arquivo .aseprite é o formato de projeto nativo do Aseprite, um editor de sprites animados e ferramenta de pixel art. Ele mantém o estado editável completo de um sprite, incluindo…
Abrir detalhes de .ASEPRITE →Um arquivo JSON é um arquivo de dados em texto simples no formato JavaScript Object Notation, usado por APIs web, configurações de aplicativos e exportações de dados. Qualquer editor de…
Abrir detalhes de .JSON →Qualidade e o que observar
- O JSON não contém os pixels - ele apenas descreve os quadros, portanto você deve manter o PNG da folha exportada junto com ele.
- A escolha do
--formaté importante:json-hashidentifica os quadros por nome,json-arrayfornece uma lista ordenada; os motores geralmente esperam um ou outro. - Metadados de tags, fatias e duração são incluídos apenas se o seu sprite realmente os definir.
Perguntas frequentes
O JSON inclui os dados da imagem?
Qual é a diferença entre json-hash e json-array?
json-hash usa o nome do arquivo como chave para cada quadro; json-array retorna uma lista ordenada. Escolha o que o carregador do seu motor de jogo espera.Posso automatizar isso sem abrir o aplicativo?
-b da CLI com --sheet e --data funciona sem interface gráfica em scripts de automação.