O que Empilhamento de sprites faz?
Um objeto é uma tira horizontal de fatias planas de cima para baixo, fatia do chão à esquerda, telhado à direita. Desenhe-as de baixo para cima, cada uma rotacionada pelo mesmo ângulo, achatada verticalmente para a inclinação da câmera e levantada 1 px por fatia. Uma pequena folha fornece todos os ângulos em pixels nítidos.
Nunca envie uma pilha que você não tenha renderizado e observado. Os caminhos abaixo são relativos à pasta desta habilidade.
0. Escolha o caminho
O que você tem?
├── Tira de fatia PNG ou exportação de camada MagicaVoxel ──▶ Passo 3 (Renderizar)
├── Folha de 4 vistas (topo, lateral, frontal, traseira) ────▶ Passo 1 gate ▶ Passo 2 (Esculpir)
└── Um prompt ou uma ideia ──────────────────────────▶ Passo 1 ▶ Passo 2 ▶ Passo 3
Em um projeto existente, leia primeiro o renderizador: engine, escala de pixel, como os sprites são desenhados e ordenados, quais objetos giram. Ajuste a pilha a esse renderizador. Nunca adicione um segundo canvas ou pipeline de renderização.
1. Obtenha uma folha de 4 vistas
A folha: uma linha 1x4 na ordem TOPO, LATERAL, FRONTAL, TRASEIRA, em branco sólido, com lacunas claras entre as vistas. TOPO olha diretamente para baixo, a frente apontando para baixo. LATERAL tem a frente apontando para a esquerda. Mesma escala em todas as quatro.
Escolha um nível:
- Retrô encorpado: 15-20 fatias, cerca de 25×48 px. Silhuetas ousadas, listras de 3-4 px, exibidas em 8-10x.
- Hi-bit detalhado: 26-44 fatias, 36×72 a 46×107 px. Comporta aberturas de ventilação, logotipos, aros raiados, reflexos de vidro, spoilers elevados.
- Vídeo de vitrine / 1080p: 36-56 fatias, 30×30 a 148×148 px, exibidas em escala inteira de 4-6x. Evita passos de silhueta encorpados e oscilação rotacional quando sprites minúsculos são ampliados para 7-9x em vídeo HD. Microdetalhes arquitetônicos que se leem claramente em 360° (persianas, floreiras, varandas com grades, musgo no telhado, vitórias-régias, postes de lanternas, gavinhas de penhascos, cachoeiras) elevam dioramas sem quebrar a disciplina da paleta.
Em seguida, pegue a primeira fonte que se aplicar.
a. Você tem uma ferramenta de geração de imagens. Use este prompt. Troque o assunto, mantenha o restante literalmente:
Pixel art encorpado folha de modelo ortométrica de [SUBJECT] com rico sombreamento de pixel de 3 tons com deslocamento de matiz (sombras profundas com deslocamento frio, tons médios saturados, destaques quentes e brilhantes ao longo de cristas e bordas), listras/acentos ousados de 3-4 px e pixels especulares nítidos em vidro. Quatro vistas em uma linha horizontal 1x4 (ou grade 2x2) limpa em um fundo completamente branco sólido ou cinza claro:
1. Vista TOPO olhando diretamente para baixo, frente apontando para BAIXO.
2. Vista LATERAL, frente apontando para a ESQUERDA.
3. Vista FRONTAL.
4. Vista TRASEIRA.
Estritamente ortométrica: zero perspectiva, zero inclinação, zero ângulo de 3/4. Escala idêntica em todas as quatro vistas para que comprimento, largura e altura correspondam pixel a pixel. Contorno escuro de 1px ousado ao redor de cada vista, aglomerados de cores sólidas planas, sombreamento de painel interno nítido, zero anti-aliasing, zero bordas suaves, zero sombras de chão projetadas, zero linhas de grade, zero texto, espaço vazio generoso entre as vistas.
b. O usuário tem uma folha. Use-a.
c. Nenhum dos dois. Desenhe as quatro vistas você mesmo como pixel art em um script curto Python/PIL na resolução nativa, um pixel por pixel de arte (arrays numpy ou ImageDraw). Dê a cada vista um contorno escuro de 1px, mantenha comprimento, largura e altura idênticos em todas as vistas, aumente a escala em 8x com Image.NEAREST e cole-as em uma linha em branco sólido com pelo menos 40 px entre as vistas. Esculpa-a com --slices definido para a altura nativa da vista LATERAL, incluindo seu contorno, para que as fatias caiam de volta em seus pixels.
O fatiador mantém um voxel apenas onde cada vista o cobre, então para (c):
-
Objetos redondos (vasos, coberturas, cúpulas, rodas vistas de cima) precisam de um círculo de pixels na vista TOPO. Um TOPO quadrado esculpe uma caixa. Se uma parte redonda for mais estreita que a parte mais larga (uma torre em uma base larga, um balão sobre sua cesta), esculpa com
--roundtambém, ou ela sairá quadrada. -
Aletas, folhas, asas e qualquer plano irregular precisam de seu contorno real na vista TOPO, ou esculpirão como blocos.
-
As silhuetas LATERAL e FRONTAL definem o perfil: um retângulo faz um cilindro, então arredonde-as para uma bola.
-
Detalhes de parede (janelas, portas, linhas de painel) vão nas vistas LATERAL, FRONTAL e TRASEIRA. Detalhes do telhado vão na TOPO.
-
Qualquer coisa que se destaque de uma parede (floreira, varanda, placa) esculpe uma saliência ao longo de toda aquela parede. Pinte pequenas protuberâncias planas e dê a uma chaminé uma tira plana de crista para se apoiar.
-
Sombreie com um gradiente de 3-4 tons com deslocamento de matiz: sombra profunda fria, tom médio saturado, destaque quente. Sem gradientes, sem anti-aliasing.
-
Centralize o objeto: a pilha gira em torno do meio de sua caixa delimitadora, então uma base que se estende mais de um lado faz com que ela orbite fora do eixo.
Gate: olhe a folha antes de fatiar
- Orientação: a frente do TOPO aponta para baixo. A frente do LATERAL aponta para a esquerda (se direita, passe
--side-nose right). - Proporções: comprimento do TOPO = comprimento do LATERAL, largura do TOPO = largura do FRONTAL/TRASEIRO, altura do LATERAL = altura do FRONTAL/TRASEIRO.
- Bordas duras: preenchimentos planos, contornos nítidos. Bordas suaves aerografadas ou linhas internas finas de 1px borram quando as fatias giram. Regere ou redesenhe em vez de recuperar.
- Buracos: saliências que mostram luz do dia na vista LATERAL (uma asa traseira elevada) sobrevivem. Cavidades escondidas de todas as quatro silhuetas (caçambas de caminhões, arcos ocos) preenchem. Corrija essas fatias manualmente após esculpir.
- Lições: percorra a tabela de Lições no final deste arquivo.
2. Esculpir e inspecionar
scripts/views_to_slices.py precisa de Python 3 com Pillow e NumPy. Ele remove o fundo (transparente ou plano), retira os contornos de 1px das vistas, quantiza para uma paleta compartilhada, esculpe as fatias e escreve uma folha de verificação e um visualizador independente.
python3 scripts/views_to_slices.py views.png slices.png \
--slices 36 --shade 0.2 --preview check.png --html viewer.html
| Bandeira | Padrão | Quando alterar |
|---|---|---|
--slices N | auto (36 se a vista LATERAL for mais alta que 64 px, senão nativa) | 15-20 encorpado, 32-48 hi-bit, altura nativa para folhas desenhadas, 0 mantém os pixels brutos da folha |
--order | auto | auto escolhe TOPO e LATERAL combinando proporções (comprimento do TOPO = comprimento do LATERAL, largura do TOPO = largura do FRONTAL, altura do LATERAL = altura do FRONTAL); a ordem de leitura desempata. reading força TOPO, LATERAL, FRONTAL, TRASEIRA |
--round | desligado | Torres, balões, vasos, garrafas: recorta cada fatia para a elipse que seus vãos LATERAL e FRONTAL descrevem. Deixe desligado para aletas, asas e caixas |
--side-nose | left | right se a vista LATERAL estiver voltada para a direita |
--top-nose | auto | Auto lê cabines de carro. Passe down para qualquer coisa que não seja um veículo, e up ou down se inverter um carro |
--shade | 0.2 | 0.12-0.15 para vistas ricamente sombreadas, 0.25 para planas, 0 para nenhum |
--colours | 24 | 32-48 para librés detalhadas, 0 para manter todas as cores |
--bg-tol | 28 | Aumente um pouco se o ruído JPEG deixar uma franja |
--dark-thresh | 70 | 0 para manter contornos em silhuetas muito escuras |
--normals | (nenhum) | Salve uma tira de fatia PNG de mapa normal 3D correspondente |
--emissive | (nenhum) | Salve uma tira PNG de máscara emissiva auto-detectada |
Abra check.png e olhe logo após esculpir: todas as quatro vistas extraídas, quatro ângulos de mesa giratória e a vista explodida. Faça isso antes de escrever qualquer código de integração. viewer.html abre em um navegador com Mesa giratória, Cena (Diorama Vivo: Rua Neon / Ilha Prado com adereços empilhados processuais + quedas de adereços Multi-PNG), Varredura de fatia, Explodido e modos Reproduzir (Dirija através de mundos infinitos de Rua/Prado/Grade, Vento, Estilhaçar), Hora do Dia ao vivo (Dia → Pôr do sol → Noite com brilho emissivo automático e sombras 3D projetadas), Clima (Chuva com reflexos molhados ondulados e ondulações, Neve com acumulação de neve normZ), e exportação PNG de 16 direções.
3. Renderizar: o loop e seus números
Todo renderizador executa o mesmo loop, de baixo para cima:
// sheet: tira horizontal de `count` fatias, cada uma w × h, fatia do chão em z = 0
// pos: centro de contato com o chão, arredondado para pixels inteiros
for (let z = 0; z < count; z++) {
// 1. girar a fatia em torno de seu centro (-floor(w/2), -floor(h/2)) por `turn`
// 2. escalar y por `squash` (inclinação da câmera)
// 3. levantar por -round(z * spacing)
// 4. traduzir para `pos` de pixel inteiro, desenhar com filtragem nearest
}
Não adivinhe estes:
spacing = 1.0px de tela na escala do pixel de arte.squash = 0.75para uma câmera inclinada de cima para baixo. 1.0 parece diretamente de cima; abaixo de 0.6 os telhados se achatam em lascas. Para uma câmera inclinável,squash = sin(elevação),spacing = cos(elevação).- Centros de rotação simétricos. Em rasterizadores de software/buffer de pixel, amostre em torno de
(w - 1) * 0.5, (h - 1) * 0.5com amostragem nearestMath.round(...). UsarMath.floor(... + w / 2)em fatias de tamanho par desloca o centro em 0.5 px de arte e cria oscilação rotacional visível em giros de 90°/180°/270°. - Posicionamento suave de 60 fps. Mantenha o movimento contínuo (balanço, flutuação, órbita, projeção pai-para-filho) em pixels de tela de ponto flutuante e encaixe apenas uma vez no blit final de 1 pixel de tela (
Math.round(dx), Math.round(dy)) com umascalede exibição inteira. Nunca quantize o movimento para passos de pixel de arte (Math.round(...) * scale) ou arredonde projeções filhas independentemente — ambos causam saltos bruscos de múltiplos pixels e vibração de adereço no chão. - Valide as contagens de tira no carregamento. Afirme
sheet.width % count === 0(e dimensões de fatia esperadas) ao fatiar uma tira para que a atualização da contagem de fatias de uma tira nunca fatie silenciosamente no meio do quadro. - Filtragem nearest-neighbour.
imageSmoothingEnabled = falseeimage-rendering: pixelatedna web, filtro Nearest/Point em engines. - Sombra de chão: para veículos, a pegada da união em z = 0, deslocamento +2, +3 px de arte, desenhada antes da fatia 0. Para adereços altos, projete as fatias empilhadas ao longo do vetor do sol por camada, com bordas pontilhadas Bayer 4×4, não uma forma oval genérica.
- Contorne a pilha finalizada uma vez, nunca por fatia. Contornos por fatia desenham costuras e manchas através do corpo. Renderize em um buffer de 1x pixel de arte, trace um contorno de 1px em torno de seu alfa, depois aumente a escala.
- Direção: a frente da folha aponta para baixo (+y), então
turn = atan2(vy, vx) - PI / 2. Para qualquer coisa que inverta, direcioneturnde uma direção armazenada, não da velocidade bruta. - Classifique Y de pilhas inteiras pelo ponto de chão. Nunca intercale fatias de dois objetos.
- Transforme pilhas estáticas em sprites simples no tempo de carregamento. 200 árvores × 30 fatias são 6.000 desenhos por quadro.
- Anime entradas com fatias, não com fades de opacidade. Desvanecer uma pilha no ar parece plano; cresça adereços aterrados de baixo para cima via
liftspor fatia (desabrochar de fatia com um suave assentamento de mola e anel de chão), e deslize pilhas aéreas/aquáticas (nuvens, barcos) ao longo de seu arco de viagem. Estenda a fronteira de revelação deliftsalém decountpela largura de mescla por fatia (mix(start, count + width, ...)) para que as fatias superiores atinjamspacingcompleto antes de mudarliftsde volta paranull— caso contrário, as fatias superiores aparecem em um único quadro. Nunca desfoque pilhas nítidas com cortes dedefocusem vídeo — use movimentos contínuos de câmera. - Balanço orgânico, inclinação de arfagem 3D e ondulação corporal via deslocamentos por fatia. Para adereços flexíveis ancorados (algas, grama, bandeiras), desloque cada fatia horizontalmente por
sin(t * freq - z * wave + phase) * amp * (z / (count - 1))²para quez = 0permaneça fixo enquanto as pontas balançam suavemente. Para criaturas saltitantes (golfinhos em movimento de golfinho inclinando o nariz para cima na ruptura → nivelado no ápice → nariz para baixo na reentrada) ou embarcações rolantes, aplique deslocamentos de inclinação longitudinal/lateral por fatia(xOffsets, yOffsets)proporcionais a(z - centerZ) * sin(pitchAngle)ao longo do eixo do corpo para que arfagem e rolamento sejam lidos como inclinação 3D verdadeira em vez de um levantamento vertical plano. - Verifique o eixo do nariz nativo e atenue em profundidade pilhas submersas. Confirme se o nariz de cada tira está voltado para
+x,+you-yantes de vincularturn = atan2(vy, vx)para que embarcações e criaturas viajem com o nariz primeiro. Para pilhas submersas debaixo d'água (adereços do fundo do mar, manta profunda, fase de golfinho submerso), aplique coloração de profundidade Beer-Lambert (dessaturando os vermelhos em direção ao matiz da água) e suavize ou omita o contorno externo duro; conduza o balanço vertical, arfagem e rolamento de pilhas flutuantes a partir de uma resposta de massa-mola amortecida ao campo de ondas compartilhado (não altura de onda instantânea).
Abra references/engines.md ao conectar ao web Canvas, React, Godot, Unity ou Phaser. scripts/viewer.html é a referência web completa: buffer, contorno, órbita, varredura, explodido, exportação.
4. Terminado quando
- Diretamente para baixo: em
squash = 1,turn = 0, a renderização tem a largura de uma fatia esliceHeight + count - 1px de altura. - Arfagem e 90°: 0.75 é visivelmente mais curto que 1.0; em 90° a largura é igual a
sliceHeight. - Espaçamento: 0 desenha plano (apenas a fatia superior), 2.5 separa cada camada claramente.
- Diagonais limpas: sem listras horizontais ou manchas escuras dentro do corpo em 45°.
- Direção: dirigir em círculo mantém a frente no caminho; reverter mantém a direção.
- Giros lentos: se sprites pequenos parecerem irregulares, aumente a escala de exibição inteira primeiro. Tente RotSprite apenas se bordas retas longas ainda rastejarem, e compare visualmente: ele arredonda sprites minúsculos.
- Giro completo: observe todos os ângulos, não quatro. Uma parte que aparece e desaparece é uma linha de Lições.
Lições
Quando uma pilha sai errada, corrija-a, depois corrija a causa onde ela não pode recorrer: mude o fatiador para que o erro não possa acontecer, ou faça-o avisar com a correção na mensagem, e adicione um caso a tests/check.py construído a partir do erro real que falhe antes da alteração. Apenas chamadas de julgamento que o código não pode ver se tornam uma regra. Adicione uma linha aqui; apague-a depois que o código tornar o erro impossível.
| Data | Erro | Regra | Aplicado por |
|---|---|---|---|
| 2026-11-20 | Postes, cordas e antenas de 1px piscam e desaparecem conforme a pilha gira | Desenhe partes finas com pelo menos 2px de largura | Aviso do fatiador (thin_runs), caso de verificação 5 |
| 2026-11-20 | Uma parte redonda mais estreita que sua base (torre, balão, vaso) esculpe quadrada | Esculpa com --round; ele mantém linhas com lacunas como postes quadradas | --round, caso de verificação 4 |
| 2026-11-20 | Auto --top-nose inverte qualquer coisa que não seja um veículo | Passe --top-nose down | Regra |
| 2026-11-20 | Algo saindo de uma parede esculpe uma saliência ao longo de toda a parede | Pinte pequenas protuberâncias planas; dê a uma |
…
[truncado para tradução]