CommunityBildgithub.com

Sprite-Stapelung

Vier orthogonale Pixelansichten in einen drehbaren Pseudo-3D-Stapel schneiden und einen scharfen Drehteller für Canvas, Godot, Unity oder Phaser rendern.

Was ist Sprite-Stapelung?

Eine Sprite-Stacking-Pipeline. Ein Streifen von Draufsichten, Boden links und Dach rechts, wird von unten nach oben gezeichnet, gemeinsam gedreht, für die Kameraneigung gestaucht und pro Scheibe um ein Pixel gehoben. Start ist ein Streifen, ein Vier-Ansichten-Blatt oder ein Prompt. Ein Stapel, den man nicht gerendert und angeschaut hat, gilt nicht als fertig.

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

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Sprite-Stapelung?

Ein Objekt ist ein horizontaler Streifen von flachen Draufsicht-Scheiben, der Bodenscheibe links, dem Dach rechts. Zeichne sie von unten nach oben, jede um denselben Winkel gedreht, vertikal für die Kamera-Neigung gestaucht und um 1 px pro Scheibe angehoben. Ein kleines Blatt liefert jeden Winkel in gestochen scharfen Pixeln.

Versende nie einen Stack, den du nicht gerendert und betrachtet hast. Pfade unten sind relativ zum Ordner dieser Fähigkeit.

0. Wähle den Pfad

Was hast du?
├── Scheibenstreifen-PNG oder MagicaVoxel-Ebenenexport ──▶ Schritt 3 (Rendern)
├── 4-Ansichten-Blatt (Draufsicht, Seite, Vorderseite, Rückseite) ───▶ Schritt 1 Tor ─▶ Schritt 2 (Schnitzen)
└── Eine Eingabeaufforderung oder eine Idee ──────────────────────────▶ Schritt 1 ─▶ Schritt 2 ─▶ Schritt 3

Lies in einem bestehenden Projekt zuerst den Renderer: Engine, Pixel-Skalierung, wie Sprites gezeichnet und sortiert werden, welche Objekte sich drehen. Passe den Stack in diesen Renderer ein. Füge niemals eine zweite Leinwand oder einen zweiten Rendering-Pipeline hinzu.

1. Erstelle ein 4-Ansichten-Blatt

Das Blatt: eine 1x4 Reihe in der Reihenfolge DRAUFSICHT, SEITE, VORDERSEITE, RÜCKSEITE, auf flachem Weiß, mit deutlichen Abständen zwischen den Ansichten. Die Draufsicht blickt gerade nach unten, die Vorderseite zeigt nach unten. Die Seite hat die Vorderseite nach links zeigend. Gleicher Maßstab in allen vier.

Wähle eine Stufe:

  • Klobig Retro: 15-20 Scheiben, etwa 25×48 px. Kräftige Silhouetten, 3-4 px Streifen, dargestellt bei 8-10x.
  • Detailreich Hi-Bit: 26-44 Scheiben, 36×72 bis 46×107 px. Enthält Lüftungsschlitze, Logos, Speichenfelgen, Glasreflexionen, erhöhte Spoiler.
  • Showcase / 1080p Video: 36-56 Scheiben, 30×30 bis 148×148 px, dargestellt bei 4-6x ganzzahliger Skalierung. Vermeidet klobige Silhouetten-Stufung und Rotationswackeln, wenn winzige Sprites auf HD-Videos auf 7-9x vergrößert werden. Architektonische Mikro-Details, die sauber über 360° lesbar sind (Fensterläden, Blumenkästen, Balkongeländer, Dachmoos, Seerosenblätter, Laternenpfähle, Klippenranken, Wasserfälle) heben Dioramen hervor, ohne die Farbpaletten-Disziplin zu brechen.

Nimm dann die erste Quelle, die zutrifft.

a. Du hast ein Bildgenerierungswerkzeug. Verwende diese Eingabeaufforderung. Ersetze das Subjekt, behalte den Rest wörtlich bei:

Klobiges Pixel-Art-orthografisches Modellblatt von [SUBJEKT] mit reicher 3-Ton-Farbtonverschobener Pixel-Schattierung (tiefe kühle Schatten, gesättigte Mitteltöne, helle warme Spitzenlichter entlang von Graten und Kanten), kräftigen 3-4px Streifen/Akzenten und knackigen spiegelnden Pixeln auf Glas. Vier Ansichten in einer sauberen 1x4 horizontalen Reihe (oder 2x2 Raster) auf einem vollständig flachen, einfarbig weißen oder blassgrauen Hintergrund:
1. DRAUFSICHT gerade nach unten blickend, Vorderseite zeigt nach UNTEN.
2. SEITENANSICHT, Vorderseite zeigt nach LINKS.
3. VORDERANSICHT.
4. RÜCKANSICHT.
Streng orthografisch: null Perspektive, null Neigung, null 3/4-Winkel. Identischer Maßstab über alle vier Ansichten, sodass Länge, Breite und Höhe Pixel für Pixel übereinstimmen. Kräftiger 1px dunkler Umriss um jede Ansicht, solide flache Farbcluster, knackige interne Panel-Schattierung, null Anti-Aliasing, null weiche Kanten, keine auf den Boden fallenden Schlagschatten, keine Gitterlinien, kein Text, großzügiger leerer Raum zwischen den Ansichten.

b. Der Benutzer hat ein Blatt. Verwende es.

c. Weder noch. Zeichne die vier Ansichten selbst als Pixel-Art in einem kurzen Python/PIL-Skript in nativer Auflösung, ein Pixel pro Kunst-Pixel (numpy-Arrays oder ImageDraw). Gib jeder Ansicht einen 1px dunklen Umriss, halte Länge, Breite und Höhe über alle Ansichten identisch, skaliere mit Image.NEAREST um das 8-fache und füge sie in einer Reihe auf flachem Weiß mit mindestens 40 px zwischen den Ansichten zusammen. Schnitze es mit --slices gesetzt auf die native Höhe der SEITENANSICHT einschließlich ihres Umrisses, sodass die Scheiben wieder auf deinen Pixeln landen.

Der Slicer behält ein Voxel nur dort, wo jede Ansicht es abdeckt, also für (c):

  • Runde Objekte (Töpfe, Überdachungen, Kuppeln, von oben gesehene Räder) benötigen einen Pixel-Kreis in der DRAUFSICHT. Eine quadratische Draufsicht schnitzt eine Box. Wenn ein runder Teil schmaler ist als der breiteste Teil (ein Turm auf einer breiten Basis, ein Ballon über seinem Korb), schnitze ebenfalls mit --round, sonst wird es quadratisch.

  • Flossen, Blätter, Flügel und jede unregelmäßige Grundfläche benötigen ihre tatsächliche Kontur in der DRAUFSICHT, sonst schnitzen sie als Blöcke.

  • Die Silhouetten der SEITE und VORDERSEITE legen das Profil fest: Ein Rechteck ergibt einen Zylinder, also runde sie für eine Kugel.

  • Wanddetails (Fenster, Türen, Panellinien) gehören in die SEITEN-, VORDER- und RÜCKANSICHT. Dachdetails in die DRAUFSICHT.

  • Alles, was aus einer Wand herausragt (Blumenkasten, Veranda, Schild), schnitzt ein Gesims entlang dieser gesamten Wand. Male kleine Vorsprünge flach und gib einem Schornstein einen flachen Streifen First, auf dem er stehen kann.

  • Schattiere mit einer 3-4 Ton-Farbtonverschobenen Rampe: kühler tiefer Schatten, gesättigte Mitte, warmer Glanzlicht. Keine Verläufe, kein Anti-Aliasing.

  • Zentriere das Objekt: Der Stack dreht sich um die Mitte seines Begrenzungsrahmens, sodass eine Basis, die auf einer Seite weiter reicht, ihn dazu bringt, außerhalb der Achse zu kreisen.

Tor: Betrachte das Blatt vor dem Schnitzen

  1. Ausrichtung: DRAUFSICHT Vorderseite zeigt nach unten. SEITENANSICHT Vorderseite zeigt nach links (falls rechts, übergib --side-nose right).
  2. Proportionen: DRAUFSICHT-Länge = SEITENANSICHT-Länge, DRAUFSICHT-Breite = VORDER/RÜCKANSICHT-Breite, SEITENANSICHT-Höhe = VORDER/RÜCKANSICHT-Höhe.
  3. Harte Kanten: flache Füllungen, klare Umrisse. Weiche luftgepinselte Kanten oder dünne 1px interne Linien verschmieren, sobald sich Scheiben drehen. Neu erstellen oder neu zeichnen, anstatt zu retten.
  4. Löcher: Überhänge, die in der SEITENANSICHT Tageslicht zeigen (ein erhöhter Heckflügel), überleben. Von allen vier Silhouetten verborgene Hohlräume (LKW-Ladeflächen, hohle Bögen) füllen sich. Behebe diese Scheiben nach dem Schnitzen von Hand.
  5. Lektionen: Gehe die Lektionen-Tabelle am Ende dieser Datei durch.

2. Schnitzen und inspizieren

scripts/views_to_slices.py benötigt Python 3 mit Pillow und NumPy. Es entfernt den Hintergrund (transparent oder flach), entfernt die 1px Ansichtsumrisse, quantisiert auf eine gemeinsame Palette, schnitzt die Scheiben und schreibt ein Überprüfungsblatt und einen eigenständigen Betrachter.

python3 scripts/views_to_slices.py views.png slices.png \
  --slices 36 --shade 0.2 --preview check.png --html viewer.html
FlagStandardWann ändern
--slices Nauto (36, wenn die SEITENANSICHT höher als 64 px ist, sonst nativ)15-20 klobig, 32-48 Hi-Bit, native Höhe für gezeichnete Blätter, 0 behält die Rohpixel des Blatts
--orderautoauto wählt DRAUFSICHT und SEITE durch passende Proportionen (DRAUFSICHT-Länge = SEITENANSICHT-Länge, DRAUFSICHT-Breite = VORDERANSICHT-Breite, SEITENANSICHT-Höhe = VORDERANSICHT-Höhe); Lesereihenfolge gewinnt bei Gleichstand. reading erzwingt DRAUFSICHT, SEITE, VORDERSEITE, RÜCKSEITE
--roundausTürme, Ballons, Töpfe, Flaschen: schneidet jede Scheibe auf die Ellipse zu, die ihre SEITEN- und VORDERANSICHT-Spannen beschreiben. Auslassen für Flossen, Flügel und Kisten
--side-noseleftright, wenn die SEITENANSICHT nach rechts zeigt
--top-noseautoAuto liest Fahrgastkabinen. Übergib down für alles, was kein Fahrzeug ist, und up oder down, wenn es ein Auto umdreht
--shade0.20.12-0.15 für reich schattierte Ansichten, 0.25 für flache, 0 für keine
--colours2432-48 für detaillierte Lackierungen, 0 um jede Farbe zu behalten
--bg-tol28Erhöhe etwas, wenn JPEG-Rauschen einen Rand hinterlässt
--dark-thresh700 um Umrisse auf sehr dunklen Silhouetten zu behalten
--normals(keine)Speichere einen passenden 3D-Normalen-Karten-Scheibenstreifen PNG
--emissive(keine)Speichere eine automatisch erkannte Emissionsmasken-Scheibenstreifen PNG

Öffne check.png und betrachte es direkt nach dem Schnitzen: alle vier extrahierten Ansichten, vier Drehteller-Winkel und die Explosionsansicht. Tue dies, bevor du Integrationscode schreibst. viewer.html öffnet sich im Browser mit Drehteller, Szene (Lebendiges Diorama: Neonstraße / Wieseninsel mit prozedural gestapelten Requisiten + Multi-PNG Requisiten-Drops), Scheiben-Scan, Explosion und Spielen-Modi (Fahren durch unendliche Straßen-/Wiesen-/Gitterwelten, Wind, Zertrümmern), Live Tageszeit (Tag → Sonnenuntergang → Nacht mit Auto-Emissionsglühen und projizierten 3D-Schatten), Wetter (Regen mit welligen nassen Reflexionen & Kräuselungen, Schnee mit normZ Schneekappen-Akkumulation) und 16-Richtungs-PNG-Export.

3. Rendern: Die Schleife und ihre Zahlen

Jeder Renderer durchläuft die gleiche Schleife, von unten nach oben:

// sheet: horizontaler Streifen von `count` Scheiben, jede w × h, Bodenscheibe bei z = 0
// pos: Bodenkontaktzentrum, gerundet auf ganze Pixel
for (let z = 0; z < count; z++) {
  // 1. rotiere die Scheibe um ihr Zentrum (-floor(w/2), -floor(h/2)) um `turn`
  // 2. skaliere y um `squash` (Kamera-Neigung)
  // 3. hebe an um -round(z * spacing)
  // 4. verschiebe zu ganzzahligen Pixeln `pos`, zeichne mit Nearest-Filter
}

Rate diese nicht:

  • spacing = 1.0 Bildschirm-Px im Kunst-Pixel-Maßstab.
  • squash = 0.75 für eine schräg von oben geneigte Kamera. 1.0 blickt gerade nach unten; unter 0.6 werden Dächer zu schmalen Streifen. Für eine neigende Kamera, squash = sin(elevation), spacing = cos(elevation).
  • Symmetrische Rotationszentren. In Software/Pixel-Puffer-Rasterizern, taste um (w - 1) * 0.5, (h - 1) * 0.5 mit Math.round(...) Nearest-Abtastung ab. Die Verwendung von Math.floor(... + w / 2) bei geraden Scheiben verschiebt das Zentrum um 0,5 Kunst-Px und erzeugt sichtbares Rotationswackeln bei 90°/180°/270° Drehungen.
  • Glatte 60 fps Platzierung. Behalte kontinuierliche Bewegung (Wippen, Schweben, Kreisen, Eltern-zu-Kind-Projektion) in Fließkomma-Bildschirm-Pixeln bei und raste nur einmal beim finalen 1-Bildschirm-Pixel-Blit (Math.round(dx), Math.round(dy)) mit einer ganzzahligen Anzeige scale. Quantifiziere Bewegung niemals auf Kunst-Pixel-Schritte (Math.round(...) * scale) oder runde Kinderprojektionen unabhängig – beides verursacht harte Multi-Pixel-Sprünge und Requisite-zu-Boden-Wackeln.
  • Validiere Streifenanzahlen zur Ladezeit. Belege sheet.width % count === 0 (und erwartete Scheibenabmessungen) beim Schneiden eines Streifens, sodass das Hochstufen der Scheibenanzahl eines Streifens niemals stillschweigend innerhalb eines Rahmens schneidet.
  • Nächste-Nachbarn-Filterung. imageSmoothingEnabled = false und image-rendering: pixelated im Web, Nearest/Point-Filter in Engines.
  • Bodenschatten: für Fahrzeuge, die Vereinigung Fußabdruck bei z = 0, versetzt +2, +3 Kunst-Px, gezeichnet vor Scheibe 0. Für hohe Requisiten projiziere die gestapelten Scheiben entlang des Sonnenvektors pro Ebene, mit Bayer 4×4 geditherten Kanten, nicht mit einem generischen Oval.
  • Umrisse den fertigen Stack einmal, niemals pro Scheibe. Umrisse pro Scheibe zeichnen Nähte und Sprenkel durch den Körper. Rendere in einen 1x Kunst-Pixel-Puffer, zeichne einen 1px Umriss um sein Alpha, skaliere dann hoch.
  • Steuerkurs: die Vorderseite des Blatts zeigt nach unten (+y), also turn = atan2(vy, vx) - PI / 2. Für alles, was sich umkehrt, treibe turn von einem gespeicherten Steuerkurs an, nicht von der Rohgeschwindigkeit.
  • Y-sortiere ganze Stacks nach Bodenpunkt. Mische niemals Scheiben zweier Objekte.
  • Backe statische Stacks beim Laden in normale Sprites. 200 Bäume × 30 Scheiben sind 6.000 Zeichnungen pro Frame.
  • Animiere Eintritte mit Scheiben, nicht mit Deckkraft-Überblendungen. Das Einblenden eines Stacks in der Luft wirkt flach; wachse bodengebundene Requisiten von unten nach oben durch lifts pro Scheibe (Scheiben-Blüte mit sanfter Federberuhigung und Bodenring), und gleite luft-/wasserbasierte Stacks (Wolken, Boote) entlang ihres Bewegungsbogens ein. Erweitere die lifts-Enthüllungsgrenze über count hinaus um die pro-Scheibe-Überblendungsbreite (mix(start, count + width, ...)), sodass die oberen Scheiben den vollen spacing erreichen, bevor lifts wieder auf null gesetzt wird – sonst schnappen die oberen Scheiben in einem einzigen Frame ein. Verwische knackige Stacks niemals in Videos mit defocus-Schnitten – verwende stattdessen kontinuierliche Kamerafahrten.
  • Organisches Wiegen, 3D-Neigung & Körperwelligkeit durch Versätze pro Scheibe. Für verankerte flexible Requisiten (Seetang, Gras, Banner) versetze jede Scheibe horizontal um sin(t * freq - z * wave + phase) * amp * (z / (count - 1))², sodass z = 0 fixiert bleibt, während die Spitzen sanft schwingen. Für springende Kreaturen (delfinartige Tiere, die beim Auftauchen die Nase nach oben neigen → waagerecht am Scheitelpunkt → Nase nach unten beim Wiedereintauchen) oder rollende Schiffe wende Versätze pro Scheibe in Längs-/Querrichtung (xOffsets, yOffsets) proportional zu (z - centerZ) * sin(pitchAngle) entlang der Körperachse an, sodass Neigung und Rollen als echte 3D-Neigung gelesen werden und nicht als flache vertikale Anhebung.
  • Überprüfe die native Nasenachse & dämpfe untergetauchte Stacks in der Tiefe ab. Bestätige, ob die Nase jedes Streifens in Richtung +x, +y oder -y zeigt, bevor turn = atan2(vy, vx) gebunden wird, damit Schiffe und Kreaturen sich zuerst mit der Nase bewegen. Für Stacks, die unter Wasser getaucht sind (Meeresboden-Requisiten, tiefer Manta, getauchte Delfinphase), wende Beer-Lambert-Tiefentönung an (entsättige Rottöne in Richtung Wasserton) und weiche die harte äußere Kontur auf oder lasse sie weg; treibe das Heben, Neigen und Rollen schwimmender Stacks aus einer gedämpften Feder-Masse-Antwort auf das gemeinsame Wellenfeld an (nicht die momentane Wellenhöhe).

Öffne references/engines.md beim Anbinden an Web Canvas, React, Godot, Unity oder Phaser. scripts/viewer.html ist die vollständige Web-Referenz: Puffer, Umriss, Orbit, Scan, Explosion, Export.

4. Fertig, wenn

  • Gerade nach unten: bei squash = 1, turn = 0, ist das Rendern eine Scheibe breit und sliceHeight + count - 1 px hoch.
  • Neigung und 90°: 0.75 ist sichtbar kürzer als 1.0; bei 90° ist die Breite gleich sliceHeight.
  • Abstand: 0 zeichnet flach (nur oberste Scheibe), 2.5 trennt jede Ebene sauber.
  • Saubere Diagonalen: keine horizontalen Streifen oder dunklen Sprenkel im Körper bei 45°.
  • Steuerkurs: Das Fahren eines Kreises hält die Vorderseite auf dem Pfad; Rückwärtsfahren behält den Steuerkurs bei.
  • Langsame Drehungen: Wenn kleine Sprites ruckelig aussehen, erhöhe zuerst die ganzzahlige Anzeige-Skalierung. Versuche es mit RotSprite nur, wenn lange gerade Kanten immer noch kriechen, und vergleiche mit dem Auge: es rundet winzige Sprites.
  • Volle Drehung: Betrachte jeden Winkel, nicht nur vier. Ein Teil, das erscheint und verschwindet, ist eine Lektionen-Zeile.

Lektionen

Wenn ein Stack falsch herauskommt, behebe ihn und behebe dann die Ursache, wo sie nicht wieder auftreten kann: Ändere den Slicer, sodass der Fehler nicht passieren kann, oder lasse ihn mit der Korrektur in der Nachricht warnen und füge einen Fall in tests/check.py hinzu, der aus dem tatsächlichen Fehler erstellt wurde und vor der Änderung fehlschlägt. Nur Ermessensentscheidungen, die der Code nicht sehen kann, werden zu einer Regel. Füge hier eine Zeile hinzu; lösche sie, sobald Code den Fehler unmöglich macht.

DatumFehlerRegelDurchgesetzt von
2026-11-201px Pfosten, Seile und Antennen blinken beim Drehen des Stacks ein und ausZeichne dünne Teile mindestens 2px breitSlicer-Warnung (thin_runs), Prüfungsfall 5
2026-11-20Ein runder Teil, der schmaler ist als seine Basis (Turm, Ballon, Topf), schnitzt quadratischSchnitze mit --round; es hält Lückenreihen wie bei Pfosten quadratisch--round, Prüfungsfall 4
2026-11-20Auto --top-nose dreht alles, was kein Fahrzeug ist, umÜbergib --top-nose downRegel
2026-11-20Etwas, das aus einer Wand herausragt, schnitzt ein Gesims entlang der gesamten WandMale kleine Vorsprünge flach; gib einem ...

…

[gekürzt für die Übersetzung]

Verwandte Skills