PhotoCraft v0.7: PSD-Kompatibilität prüfen und einen schnellen Editor entwickeln

Eine PSD-Datei kann sich in einem Editor öffnen lassen und trotzdem anders aussehen: Unterschiede können Masken, Text, Ebeneneffekte oder die Überlagerungsreihenfolge betreffen. Eine Möglichkeit, das Ergebnis zu prüfen, besteht darin, die neu zusammengesetzte Komposition mit dem reduzierten Bild zu vergleichen, das in der PSD-Datei eingebettet ist. Das am 11. Oktober 2026 veröffentlichte PhotoCraft v0.7.0 bietet Anlass, diese technische Methode am Beispiel eines in Rust geschriebenen Open-Source-Grafikeditors zu betrachten.

Das Release listet Änderungen an Pinseln, Auswahlwerkzeugen, Masken, dem OpenRaster-Import und weiteren Bereichen des Editors auf. Für Entwickler besonders interessant ist die veröffentlichte Projektdokumentation: Sie beschreibt PSD-Importtests, den Vergleich der Kompositoren und einen Dateibestand, der für reproduzierbare Prüfungen verwendet wird.

Die PSD-Datei enthält eine Referenz zum Vergleich

Eine mehrschichtige PSD-Datei enthält die Ebenenstruktur und ein reduziertes Bild des Dokuments. PhotoCraft rendert die Ebenen und vergleicht das Ergebnis anschließend mit dieser eingebetteten Komposition. Ein solcher Test prüft, wie genau das Programm das Erscheinungsbild des Dokuments bei der Verarbeitung von Text, Korrekturen, Effekten und anderen Formatfunktionen reproduziert.

In der Architekturbeschreibung von PhotoCraft wird dieser Ansatz als „Kompositor-Orakel“ bezeichnet. Die Testdokumentation führt drei PSD-Dateibestände auf: 256 Dateien, die das Team in Photoshop erstellt hat, 170 Dateien aus den Sammlungen psd-tools und ag-psd sowie einen separaten psd-tools-Bestand mit 309 Dateien. Die Bestände werden mit festgelegten Versionen geladen und anhand von Prüfsummen verifiziert.

Für Entwickler eines Dateiformats ist es hilfreich, Tests danach zu unterscheiden, welche Frage sie beantworten. Die Analyse der Struktur zeigt, ob das Dokument gelesen werden konnte; ein Test zum Öffnen und Speichern prüft, ob die Daten erhalten blieben; der Kompositionsvergleich zeigt, wie genau das visuelle Ergebnis reproduziert wurde. Die PhotoCraft-Dokumentation nennt sowohl Tests zur Byte-Stabilität unveränderter Dateien als auch Vergleiche mit der eingebetteten PSD-Komposition.

Der CPU-Kompositor dient als Referenzimplementierung

Das Projekt beschreibt den CPU-Kompositor als Referenzpfad für den Export und für Tests; der GPU-Kompositor auf Basis von wgpu führt denselben Operationsplan für die Arbeitsfläche aus. Laut Architekturdokumentation werden die Ergebnisse mit einer Toleranz von bis zu 1/255 bei 8-Bit-Ausgabe verglichen. Die CPU-/GPU-Prüfung läuft in der CI, auch mit einem Software-Grafikadapter.

Die GPU wird für die interaktive Arbeitsfläche benötigt, doch ob der Hardwarepfad verfügbar ist, hängt vom Dokument und der Umgebung ab. Das Handbuch weist darauf hin, dass Mehrkanaldokumente und Bereiche, die das Texturlimit überschreiten, vom CPU-Kompositor verarbeitet werden; bei einem Ausfall des GPU-Geräts wechselt die Arbeitsfläche ebenfalls zur CPU. Das sind konkrete Bedingungen für den Wechsel zwischen den Pfaden und keine Behauptung, dass auf jedem Gerät dieselbe Geschwindigkeit erreicht wird.

Das allgemeine Muster lässt sich auch auf andere Rechensysteme übertragen: Neben einem optimierten Pfad eine überprüfbare Referenzimplementierung vorhalten und beide mit denselben Eingaben ausführen. Bei einer Datenbank könnte das ein einfacher Interpreter neben einer optimierten Engine sein, bei der Medienverarbeitung ein Softwarepfad neben der Hardwarebeschleunigung. Ein Vergleich macht Ergebnisabweichungen sichtbar; reproduzierbar wird er, wenn Eingaben und Kriterien für zulässige Abweichungen festgelegt sind.

So wird aus dem Ansatz eine funktionierende Teststrategie

1. Stellen Sie einen kleinen, vielfältigen Dateibestand zusammen. Nehmen Sie Dateien mit Masken, Text, Gruppen, Transparenz, Effekten und Farbmodi auf. Dokumentieren Sie Herkunft und Versionen, damit spätere Testläufe dieselben Eingaben verwenden.
2. Legen Sie Referenz und Toleranz fest. Bei PSD-Dateien lässt sich das Ergebnis mit der eingebetteten reduzierten Komposition vergleichen. Bestimmen Sie die zulässige Abweichung und prüfen Sie Abmessungen, Farbprofil und Alphakanal gesondert, sofern sie für Ihre Anwendung wichtig sind.
3. Trennen Sie Import, Speichern und Rendering. Separate Tests können die Analyse der Ebenen, das erneute Öffnen nach dem Speichern und die Übereinstimmung des Bildes mit der Referenz prüfen. So lässt sich leichter feststellen, in welchem Schritt ein Fehler aufgetreten ist.
4. Führen Sie dieselben Fälle über verschiedene Backends aus. Vergleichen Sie CPU- und GPU-Ergebnisse anhand derselben Dokumente, einschließlich Tests an Kachelgrenzen und mit Effekten. Speichern Sie Eingabe und visuelle Abweichung, damit sich eine Regression reproduzieren lässt.
5. Dokumentieren Sie die Bedingungen für Leistungsmessungen. Geben Sie Dokumentgröße, Ebenenzahl, Hardware und Cache-Zustand an. Die PhotoCraft-Dokumentation enthält Befehle für einzelne Tests und den Vergleich der Kompositoren; die dort angegebenen Messwerte beziehen sich auf konkrete Konfigurationen und Szenarien.

Der Entwicklungsleitfaden von PhotoCraft beschreibt Befehle zum Prüfen der PSD-Dateibestände, visueller Abweichungen und des Verhaltens verschiedener Kompositionspfade. Er kann als konkreter Ausgangspunkt dienen, um die Testinfrastruktur eines Editors kennenzulernen. Die Leistungswerte in der Dokumentation sollten zusammen mit den dort genannten Eingaben und Hardwarekonfigurationen betrachtet werden.

Was das Beispiel PhotoCraft zeigt

Das Release PhotoCraft v0.7.0 bündelt Änderungen am Editor selbst; die Projektdokumentation beleuchtet außerdem eine technische Praxis: PSD-Referenzdateien zur Prüfung der Komposition und eine CPU-Implementierung, mit der der GPU-Pfad verglichen wird. Für Entwickler von Editoren, Konvertern und anderen Werkzeugen für komplexe Dateien ist die zentrale Erkenntnis einfach: Lesen, Speichern und visuelles Ergebnis getrennt testen und beschleunigte Implementierungen anhand festgelegter Eingaben mit einer Referenzversion vergleichen. So werden Kompatibilität und Leistung zu überprüfbaren Eigenschaften des Programms.