Für Aseprite-Nutzer
Aseprite-Sprite-Sheet-Entpacker
Exportiere aus Aseprite ein Sprite-Sheet-Bild und seine JSON-Daten. Dieses Werkzeug stellt jedes beschnittene Einzelbild in seiner ursprünglichen Arbeitsflächengröße wieder her.
Beispiel: sheet.png + sheet.json → Einzelbild-PNGs in voller Größe
Dieses Werkzeug ausprobieren- 1. HinzufügenAseprite-Bild + JSON
- 2. AnpassenEinzelbildpositionen wiederherstellen
- 3. SpeichernPNGs in voller Größe in einer ZIP-Datei
1. Beide aus Aseprite exportierten Dateien hinzufügen
Exportiere in Aseprite ein Sprite-Sheet mit seinen JSON-Daten. Wähle Bild und JSON aus demselben Export.
So verwendest du es
1. Bild und JSON gemeinsam exportieren
Exportiere in Aseprite ein Sprite-Sheet mit JSON-Metadaten und behalte beide Dateien dieses Exports. Dieses Werkzeug liest PNG- oder WebP-Sprite-Sheets mit JSON-Array- oder Hash-Daten, keine nativen .ase- oder .aseprite-Projekte.
2. Das zusammengehörige Dateipaar laden
Wähle A. Das Sprite-Sheet und B. Die passenden JSON-Daten und starte dann die Wiederherstellung. Der Importer prüft meta.size sowie jeden Zuschnitt und Versatz. Verwende nach einer Neuanordnung oder Größenänderung des Sprite-Sheets keine alten JSON-Daten erneut.
3. Wiederhergestellte Folge prüfen und speichern
Prüfe die Ausrichtung mit dem Einzelbildregler und der Wiedergabevorschau. Jeder Ausschnitt wird anhand der spriteSourceSize-Versätze auf seiner sourceSize-Arbeitsfläche platziert. Lade die ZIP-Datei herunter und bewahre manifest.json für Namen, Anzeigedauern und Einzelbild-Tags auf.
Drei Rechtecke erklären, warum beschnittene Sprites springen
frame bezeichnet die Pixel innerhalb des gepackten Sheets. Seine x- und y-Werte sind Atlas-Koordinaten, nicht die ursprüngliche Figurenposition. sourceSize gibt die ursprünglichen Arbeitsflächenabmessungen an. spriteSourceSize gibt die Position des Ausschnitts innerhalb dieser Arbeitsfläche an.
Eine von 64 × 64 auf 22 × 38 Pixel beschnittene Pose kann im Sprite-Sheet bei (128, 0) liegen, im ursprünglichen Einzelbild aber bei (19, 20). Bei der Wiederherstellung wird eine transparente Arbeitsfläche mit 64 × 64 Pixeln erstellt, das Rechteck mit 22 × 38 Pixeln kopiert und bei (19, 20) platziert. Eine Platzierung bei (0, 0) würde die Figur verschieben.
Die Wiederherstellung macht beabsichtigte Bewegungen innerhalb des ursprünglichen Einzelbilds nicht rückgängig und erfindet keinen neuen Drehpunkt. Tags und Anzeigedauern bleiben im Manifest erhalten, müssen aber von der Zielanwendung ausgewertet werden. Eine Wiedergabe mit gleichbleibenden FPS erhält unterschiedlich lange Haltephasen nicht automatisch.
| Einstellung oder Eingabe | Was es bedeutet |
|---|---|
| frame: 128, 0, 22, 38 | Dieses Rechteck aus dem Sheet auslesen |
| spriteSourceSize: 19, 20, 22, 38 | Setze den Zuschnitt auf (19, 20) |
| sourceSize: 64 × 64 | Eine PNG-Datei mit vollständiger Arbeitsfläche exportieren |
| duration: 100 | Retain 100 ms in manifest.json |
Vor dem Herunterladen prüfen
Gleiche Abmessungen beweisen keine gleiche Anordnung
Zwei Exporte können identische Größen, aber unterschiedliche Anordnungen haben. Prüfe erkennbare erste und letzte Posen und nutze Dateien aus demselben Export.
Innerhalb des unterstützten Exportformats bleiben
Gedrehte Einzelbilder werden nicht unterstützt. Grenzen: 2 MB JSON, 20 MB Bild, 100 Einzelbilder, 4096 px pro Sheet-Seite, 16 Millionen Sheet-Pixel, 1024 px pro Seite eines wiederhergestellten Einzelbilds und insgesamt 20 Millionen wiederhergestellte Pixel.
Fragen
Kann ich ein natives Aseprite-Projekt hinzufügen?
Nein. Exportiere zuerst ein Sprite-Sheet und JSON. Bearbeitbare Ebenen, Cels und die native Projektstruktur werden nicht geladen.
Warum werden gedreht gepackte Einzelbilder abgelehnt?
Dieser Importer verarbeitet ungedrehte Ausschnitte. Exportiere erneut ohne Drehung. rotated in der JSON-Datei auf false zu setzen würde die gespeicherten Pixel falsch interpretieren, nicht reparieren.
Warum sind die PNGs größer als die gepackten Ausschnitte?
Jedes verwendet die ursprüngliche sourceSize-Arbeitsfläche und ihre transparenten Ränder. Dadurch bleibt die Ausrichtung der Posen erhalten. Behalte den gepackten Atlas, wenn kompakte Texturspeicherung das Ziel ist.
Erhält die ZIP-Datei das Timing?
Anzeigedauern und gültige Frame-Tags stehen in manifest.json. PNG-Dateien allein enthalten kein Wiedergabe-Timing. Importiere die Metadaten in den verwendenden Editor oder die Engine oder bilde sie dort nach.
Was sollte ich nach einem Abmessungsfehler tun?
Vergleiche meta.size mit dem Bild und prüfe, ob nach dem Export die Größe geändert oder die Anordnung neu gepackt wurde. Erzeuge beide Dateien gemeinsam neu, statt Metadaten zu ändern, um die Validierung zu umgehen.
Passende Werkzeuge und Anleitungen
Beschnittene Aseprite-Einzelbilder wiederherstellen — Folge dem Versatzbeispiel und untersuche eine wandernde Grundlinie.
Sprite-Sheet-Animator — Teste wiederhergestellte Einzelbilder mit gleichbleibenden FPS, wenn unterschiedliche Anzeigedauern nicht nötig sind.
Aseprite-Exportdokumentation — Lies die Anleitung des Editors zur Erstellung eines zusammenpassenden Sheets und der zugehörigen Daten.