CommunityImagengithub.com

Apilado de sprites

Convierte cuatro vistas píxel ortogonales en una pila de falso 3D que gira, y renderiza un torno nítido para Canvas, Godot, Unity o Phaser.

¿Qué es Apilado de sprites?

Un proceso de sprite stacking. Una tira de cortes cenitales, suelo a la izquierda y techo a la derecha, se dibuja de abajo arriba, gira con el mismo ángulo, se aplasta según la cámara y sube un píxel por corte. Puede empezar en una tira, una hoja de cuatro vistas o un prompt. No se entrega una pila que no se haya renderizado y mirado.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/danielwh2/sprite-stacking/tree/HEAD/skills/sprite-stacking

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Apilado de sprites?

Un objeto es una tira horizontal de cortes planos de arriba a abajo, con el corte del suelo a la izquierda y el techo a la derecha. Se dibujan de abajo a arriba, cada uno rotado el mismo ángulo, aplastados verticalmente para la inclinación de la cámara y elevados 1 px por cada corte. Una hoja pequeña da todos los ángulos en píxeles nítidos.

Nunca entregues un apilado que no hayas renderizado y observado. Las rutas a continuación son relativas a la carpeta de esta habilidad.

0. Elige la ruta

¿Qué tienes?
├── Tira de cortes PNG o exportación de capas MagicaVoxel ──▶ Paso 3 (Renderizar)
├── Hoja de 4 vistas (arriba, lateral, frontal, trasera) ────────▶ Paso 1 puerta ─▶ Paso 2 (Tallar)
└── Un prompt o una idea ─────────────────────────────────────▶ Paso 1 ─▶ Paso 2 ─▶ Paso 3

En un proyecto existente, lee primero el renderizador: motor, escala de píxeles, cómo se dibujan y ordenan los sprites, qué objetos giran. Adapta el apilado a ese renderizador. Nunca añadas un segundo canvas o pipeline de renderizado.

1. Obtén una hoja de 4 vistas

La hoja: una fila 1x4 en el orden ARRIBA, LATERAL, FRONTAL, TRASERA, sobre blanco plano, con espacios claros entre las vistas. ARRIBA mira directamente hacia abajo, con el frente apuntando hacia abajo. LATERAL tiene el frente apuntando hacia la izquierda. Misma escala en las cuatro.

Elige un nivel:

  • Retro grueso: 15-20 cortes, aproximadamente 25×48 px. Siluetas audaces, rayas de 3-4 px, mostradas a 8-10x.
  • Hi-bit detallado: 26-44 cortes, 36×72 a 46×107 px. Contiene rejillas de ventilación, logotipos, llantas de radios, reflejos de vidrio, alerones elevados.
  • Exhibición / video 1080p: 36-56 cortes, 30×30 a 148×148 px, mostrados a escala entera 4-6x. Evita el escalonamiento de silueta grueso y la oscilación rotacional cuando los sprites pequeños se amplían a 7-9x en video HD. Microdetalles arquitectónicos que se leen limpiamente en 360° (contraventanas, jardineras, barandillas de balcones, musgo en tejados, hojas de nenúfar, postes de faroles, zarcillos de acantilados, cascadas) elevan los dioramas sin romper la disciplina de paleta.

Luego toma la primera fuente que aplique.

a. Tienes una herramienta de generación de imágenes. Usa este prompt. Cambia el sujeto, mantén el resto textualmente:

Hoja de modelo ortopráctico de pixel art grueso de [SUJETO] con sombreado de píxeles rico de 3 tonos con cambio de tono (sombras profundas con cambio de tono frío, medios saturados, reflejos cálidos brillantes en crestas y bordes), rayas/acentos audaces de 3-4 px y píxeles especulares nítidos en vidrio. Cuatro vistas en una fila horizontal limpia 1x4 (o cuadrícula 2x2) sobre un fondo blanco sólido o gris pálido completamente plano:
1. Vista ARRIBA mirando directamente hacia abajo, frente apuntando hacia ABAJO.
2. Vista LATERAL, frente apuntando hacia la IZQUIERDA.
3. Vista FRONTAL.
4. Vista TRASERA.
Estrictamente ortopráctico: cero perspectiva, cero inclinación, cero ángulo de 3/4. Escala idéntica en las cuatro vistas para que la longitud, anchura y altura coincidan píxel a píxel. Contorno audaz de 1 px oscuro alrededor de cada vista, grupos de colores sólidos planos, sombreado de paneles internos nítido, cero anti-aliasing, cero bordes suaves, cero sombras de suelo proyectadas, cero líneas de cuadrícula, cero texto, generoso espacio vacío entre las vistas.

b. El usuario tiene una hoja. Úsala.

c. Ninguno. Dibuja las cuatro vistas tú mismo como pixel art en un script corto de Python/PIL en resolución nativa, un píxel por píxel de arte (arrays de numpy o ImageDraw). Dale a cada vista un contorno oscuro de 1 px, mantén la longitud, anchura y altura idénticas en las cuatro vistas, escala 8x con Image.NEAREST, y pégalas en una fila sobre blanco plano con al menos 40 px entre vistas. Tállalo con --slices establecido en la altura nativa de la vista LATERAL incluyendo su contorno, para que los cortes aterricen de nuevo en tus píxeles.

El tallador mantiene un vóxel solo donde cada vista lo cubre, así que para (c):

  • Los objetos redondos (macetas, toldos, cúpulas, ruedas vistas desde arriba) necesitan un círculo de píxeles en la vista ARRIBA. Un ARRIBA cuadrado talla una caja. Si una parte redonda es más estrecha que la parte más ancha (una torre sobre una base ancha, un globo sobre su cesta), talla con --round también, o sale cuadrado.

  • Las aletas, hojas, alas y cualquier plano irregular necesitan su contorno real en la vista ARRIBA, o se tallan como bloques.

  • Las siluetas LATERAL y FRONTAL establecen el perfil: un rectángulo hace un cilindro, así que redondéalas para una bola.

  • Los detalles de la pared (ventanas, puertas, líneas de paneles) van en LATERAL, FRONTAL y TRASERA. Los detalles del techo van en ARRIBA.

  • Cualquier cosa que sobresalga de una pared (jardinera, porche, letrero) talla un borde a lo largo de toda esa pared. Pinta las protuberancias pequeñas planas, y dale a una chimenea una tira plana de cresta para apoyarse.

  • Sombrea con una rampa de 3-4 tonos con cambio de tono: sombra profunda fría, medio saturado, reflejo cálido. Sin degradados, sin anti-aliasing.

  • Centra el objeto: el apilado gira alrededor del centro de su cuadro delimitador, por lo que una base que se extiende más de un lado hace que orbite fuera del eje.

Puerta: mira la hoja antes de tallar

  1. Orientación: ARRIBA el frente apunta hacia abajo. LATERAL el frente apunta hacia la izquierda (si es a la derecha, pasa --side-nose right).
  2. Proporciones: La longitud de ARRIBA = la longitud de LATERAL, la anchura de ARRIBA = la anchura de FRONTAL/TRASERA, la altura de LATERAL = la altura de FRONTAL/TRASERA.
  3. Bordes duros: rellenos planos, contornos nítidos. Los bordes suaves aerografiados o las líneas internas finas de 1 px se manchan una vez que los cortes rotan. Regenera o redibuja en lugar de intentar salvar.
  4. Agujeros: los voladizos que muestran luz del día en la vista LATERAL (un alerón trasero elevado) sobreviven. Las cavidades ocultas de las cuatro siluetas (camas de camiones, arcos huecos) se rellenan. Arregla esos cortes a mano después de tallar.
  5. Lecciones: repasa la tabla de Lecciones al final de este archivo.

2. Tallar e inspeccionar

scripts/views_to_slices.py necesita Python 3 con Pillow y NumPy. Elimina el fondo (transparente o plano), elimina los contornos de 1 px de las vistas, cuantiza a una paleta compartida, talla los cortes y escribe una hoja de verificación y un visor independiente.

python3 scripts/views_to_slices.py views.png slices.png \
  --slices 36 --shade 0.2 --preview check.png --html viewer.html
BanderaValor predeterminadoCuándo cambiarlo
--slices Nauto (36 si la vista LATERAL es más alta que 64 px, si no nativa)15-20 grueso, 32-48 hi-bit, altura nativa para hojas dibujadas, 0 mantiene los píxeles brutos de la hoja
--orderautoauto elige ARRIBA y LATERAL emparejando proporciones (longitud de ARRIBA = longitud de LATERAL, anchura de ARRIBA = anchura de FRONTAL, altura de LATERAL = altura de FRONTAL); el orden de lectura gana empates. reading fuerza ARRIBA, LATERAL, FRONTAL, TRASERA
--rounddesactivadoTorres, globos, macetas, botellas: recorta cada corte a la elipse que describen sus extensiones LATERAL y FRONTAL. Déjalo desactivado para aletas, alas y cajas
--side-noseleftright si la vista LATERAL mira hacia la derecha
--top-noseautoAuto lee las cabinas de los coches. Pasa down para cualquier cosa que no sea un vehículo, y up o down si invierte un coche
--shade0.20.12-0.15 para vistas ricamente sombreadas, 0.25 para planas, 0 para ninguna
--colours2432-48 para libreas detalladas, 0 para mantener todos los colores
--bg-tol28Aumenta un poco si el ruido JPEG deja un borde
--dark-thresh700 para mantener los contornos en siluetas muy oscuras
--normals(ninguno)Guarda un PNG de tira de mapa de normales 3D coincidente
--emissive(ninguno)Guarda un PNG de máscara emisiva detectada automáticamente

Abre check.png y míralo justo después de tallar: las cuatro vistas extraídas, cuatro ángulos de plato giratorio y la vista explosionada. Haz esto antes de escribir cualquier código de integración. viewer.html se abre en un navegador con modos Turntable, Scene (Living Diorama: Neon Street / Meadow Island con accesorios apilados procedimentales + gotas de accesorios multi-PNG), Slice scan, Exploded y Play (Conduce por mundos infinitos de Street/Meadow/Grid, Wind, Shatter), Hora del día en vivo (Day → Sunset → Night con brillo emisivo automático y sombras 3D proyectadas), Weather (Lluvia con reflejos húmedos ondulados y ondas, Nieve con acumulación de capa de nieve normZ) y exportación PNG de 16 direcciones.

3. Renderizar: el bucle y sus números

Cada renderizador ejecuta el mismo bucle, de abajo a arriba:

// hoja: tira horizontal de `count` cortes, cada uno w × h, corte del suelo en z = 0
// pos: centro de contacto con el suelo, redondeado a píxeles enteros
for (let z = 0; z < count; z++) {
  // 1. rotar el corte alrededor de su centro (-floor(w/2), -floor(h/2)) por `turn`
  // 2. escalar y por `squash` (inclinación de la cámara)
  // 3. elevar por -round(z * spacing)
  // 4. trasladar a `pos` de píxel entero, dibujar con filtrado de vecino más cercano
}

No adivines estos:

  • spacing = 1.0 px de pantalla a la escala de píxel de arte.
  • squash = 0.75 para una cámara inclinada hacia arriba desde arriba. 1.0 se ve directamente hacia abajo; por debajo de 0.6 los techos se aplanan en tiras. Para una cámara con inclinación, squash = sin(elevation), spacing = cos(elevation).
  • Centros de rotación simétricos. En rasterizadores de software/búfer de píxeles, muestrea alrededor de (w - 1) * 0.5, (h - 1) * 0.5 con muestreo de vecino más cercano Math.round(...). Usar Math.floor(... + w / 2) en cortes de tamaño par desplaza el centro en 0.5 px de arte y crea una oscilación rotacional visible en giros de 90°/180°/270°.
  • Colocación suave a 60 fps. Mantén el movimiento continuo (bamboleo, flotación, órbita, proyección de padre a hijo) en píxeles de pantalla de punto flotante y ajusta solo una vez en el blit final de 1 píxel de pantalla (Math.round(dx), Math.round(dy)) con una scale de visualización entera. Nunca cuantices el movimiento a pasos de píxel de arte (Math.round(...) * scale) o redondees las proyecciones de los hijos de forma independiente; ambos causan saltos duros de varios píxeles y vibración del accesorio al suelo.
  • Valida los recuentos de tiras en el momento de la carga. Afirma que sheet.width % count === 0 (y las dimensiones esperadas del corte) al cortar una tira para que la actualización del recuento de cortes de una tira nunca corte silenciosamente en medio del cuadro.
  • Filtrado de vecino más cercano. imageSmoothingEnabled = false y image-rendering: pixelated en la web, filtro Nearest/Point en motores.
  • Sombra de suelo: para vehículos, la huella de unión en z = 0, desplazamiento +2, +3 px de arte, dibujada antes del corte 0. Para accesorios altos, proyecta los cortes apilados a lo largo del vector solar por capa, con bordes tramados Bayer 4×4, no un óvalo genérico.
  • Contornea el apilado terminado una vez, nunca por corte. Los contornos por corte dibujan costuras y motas a través del cuerpo. Renderiza en un búfer de 1x píxel de arte, traza un contorno de 1 px alrededor de su alfa, luego escálalo.
  • Dirección: el frente de la hoja apunta hacia abajo (+y), por lo que turn = atan2(vy, vx) - PI / 2. Para cualquier cosa que se invierta, maneja turn desde una dirección almacenada, no la velocidad bruta.
  • Ordena Y los apilados completos por punto de suelo. Nunca intercales cortes de dos objetos.
  • Hornea apilados estáticos en sprites planos en el momento de la carga. 200 árboles × 30 cortes son 6,000 dibujos por cuadro.
  • Anima las entradas con cortes, no con fundidos de opacidad. Fundir un apilado en el aire se ve plano; haz crecer los accesorios con base en el suelo de abajo a arriba mediante lifts por corte (florecimiento del corte con un asentamiento de resorte suave y anillo de suelo), y desliza los apilados aéreos/acuáticos (nubes, barcos) a lo largo de su arco de viaje. Extiende la frontera de revelación de lifts más allá de count por el ancho de mezcla por corte (mix(start, count + width, ...)) para que los cortes superiores alcancen el spacing completo antes de cambiar lifts de nuevo a null; de lo contrario, los cortes superiores aparecen en un solo cuadro. Nunca difumines apilados nítidos con cortes de defocus en video; usa movimientos de cámara continuos en su lugar.
  • Balanceo orgánico, inclinación de cabeceo 3D y ondulación del cuerpo mediante desplazamientos por corte. Para accesorios flexibles anclados (algas, hierba, pancartas), desplaza cada corte horizontalmente por sin(t * freq - z * wave + phase) * amp * (z / (count - 1))² para que z = 0 permanezca fijo mientras las puntas se balancean suavemente. Para criaturas saltarinas (delfines que se elevan con el morro hacia arriba en la ruptura → nivelados en el ápice → morro hacia abajo en el reingreso) o embarcaciones rodantes, aplica desplazamientos de inclinación longitudinal/lateral por corte (xOffsets, yOffsets) proporcionales a (z - centerZ) * sin(pitchAngle) a lo largo del eje del cuerpo para que el cabeceo y el balanceo se lean como una inclinación 3D real en lugar de un levantamiento vertical plano.
  • Verifica el eje del morro nativo y atenúa en profundidad los apilados sumergidos. Confirma si el morro de cada tira mira hacia +x, +y o -y antes de vincular turn = atan2(vy, vx) para que las embarcaciones y criaturas viajen con el morro primero. Para apilados sumergidos bajo el agua (accesorios del fondo marino, manta profunda, fase de delfín sumergido), aplica un tinte de profundidad Beer-Lambert (desaturando los rojos hacia el tono del agua) y suaviza u omite el contorno exterior duro; maneja el cabeceo, balanceo y arfada de los apilados flotantes desde una respuesta de masa-resorte amortiguada al campo de olas compartido (no la altura instantánea de la ola).

Abre references/engines.md al conectar con web Canvas, React, Godot, Unity o Phaser. scripts/viewer.html es la referencia web completa: búfer, contorno, órbita, escaneo, explosionado, exportación.

4. Hecho cuando

  • Directamente hacia abajo: con squash = 1, turn = 0, el renderizado tiene un corte de ancho y sliceHeight + count - 1 px de alto.
  • Cabeceo y 90°: 0.75 es visiblemente más corto que 1.0; a 90° el ancho es igual a sliceHeight.
  • Espaciado: 0 dibuja plano (solo el corte superior), 2.5 separa cada capa limpiamente.
  • Diagonales limpias: sin rayas horizontales ni motas oscuras dentro del cuerpo a 45°.
  • Dirección: conducir en círculo mantiene el frente en el camino; invertir mantiene la dirección.
  • Giros lentos: si los sprites pequeños se ven entrecortados, primero aumenta la escala de visualización entera. Prueba RotSprite solo si los bordes rectos largos aún se arrastran, y compara a simple vista: redondea los sprites pequeños.
  • Giro completo: mira todos los ángulos, no cuatro. Una parte que aparece y desaparece es una fila de Lecciones.

Lecciones

Cuando un apilado sale mal, arréglalo, luego arregla la causa donde no pueda repetirse: cambia el tallador para que el error no pueda ocurrir, o haz que advierta con la solución en el mensaje, y añade un caso a tests/check.py construido a partir del error real que falle antes del cambio. Solo los juicios que el código no puede ver se convierten en una regla. Añade una fila aquí; bórrala una vez que el código haga imposible el error.

FechaErrorReglaAplicado por
2026-11-20Postes, cuerdas y antenas de 1 px parpadean al aparecer y desaparecer mientras el apilado giraDibuja las partes delgadas de al menos 2 px de anchoAdvertencia del tallador (thin_runs), caso de verificación 5
2026-11-20Una parte redonda más estrecha que su base (torre, globo, maceta) se talla cuadradaTalla con --round; mantiene cuadradas las filas separadas como los postes--round, caso de verificación 4
2026-11-20Auto --top-nose invierte cualquier cosa que no sea un vehículoPasa --top-nose downRegla
2026-11-20Algo que sobresale de una pared talla un borde a lo largo de toda la paredPinta las protuberancias pequeñas planas; dale a una chimenea una tira plana de cresta

…

[truncado para traducción]

Skills relacionados