Features
Funktionen
Aspose.PSD FOSS für Python lädt, inspiziert und speichert PSD- und PSB-Dokumente, ohne Pixeldaten zu rendern. Der Funktionsumfang ist in mehrere Bereiche gegliedert, die jeweils in einem eigenen Leitfaden behandelt werden.
Dokumentenladen, -inspektion und -speicherung
PsdImage.load() lädt ein Dokument von einem Dateipfad oder Stream; PsdImage.save() schreibt es wieder aus. PsdImage stellt den geparsten Header zur Verfügung (width, height, color_mode, compression, und mehr) und die geparsten Bildressourcen. Siehe Core API für die vollständige Referenz.
Dokumentabschnitte
Über den Header der obersten Ebene, PsdImage stellt schreibgeschützte Zusammenfassungen für die Farb- und Bilddatenabschnitte bereit. Siehe Sections für die vollständige Referenz.
Layer-Metadaten
Jeder geparste Layer stellt seine Geometrie, Sichtbarkeit, Opazität, Beschneidung und Mischmodus sowie Kanal-, Masken- und Mischbereich-Metadaten bereit. Ein Teil der Ebeneneigenschaften kann geändert und wieder gespeichert werden; die Ebenensammlung selbst kann neu zugewiesen werden. Siehe Layers für die vollständige Referenz.
Bildressourcen
PsdImage stellt die Bildressourcenblöcke eines Dokuments in zwei Formen bereit, plus eine separate Zusammenfassung für indizierte Farbpaletten. Siehe Resources für die vollständige Referenz.
Fehlerbehandlung
Lade- und Speicherfehler werden gemeldet über PsdLoadException and PsdSaveException, beide erweitern den Standard Exception Klasse. Siehe Core Exceptions für die vollständige Referenz.
Dokumente zurückschreiben
PsdImage.save() ist der einzige öffentliche Einstiegspunkt zum Schreiben eines Dokuments in einen Dateipfad oder Stream. Siehe Beschreibungen schreiben für die vollständige Referenz.
Rohbyte-Konvertierung
BigEndianBitConverter dekodiert big-endian-Integer aus rohen Bytes, die Sie selbst erhalten haben — zum Beispiel aus einer nicht erkannten Bildressource. Siehe Conversion für die vollständige Referenz.
Was nicht unterstützt wird
Diese Bibliothek rendert keine Pixeldaten und konvertiert PSD/PSB nicht in andere Bildformate (wie PNG oder JPEG). Sie ist ein auf Metadaten fokussierter Leser und Schreiber für das PSD/PSB-Containerformat.
Tipps und bewährte Vorgehensweisen
- Beginnen Sie mit Core API zum Laden, Untersuchen und Speichern eines Dokuments.
- Verwenden Sie Layers wenn Sie einzelne Ebenen-Metadaten lesen oder bearbeiten müssen.
- Wrap
load()/save()Aufrufe in der beschriebenen Ausnahmebehandlung in Kern-Ausnahmen.
Häufige Probleme
| Problem | Ursache | Lösung |
|---|---|---|
| Erwartete gerenderte Pixelausgabe | Diese Bibliothek ist rein Metadaten-basiert | Verwenden Sie eine andere Bibliothek zum Rendern; diese lädt, inspiziert und speichert nur PSD/PSB metadata |
FAQ
Rendert diese Bibliothek PSD-Dateien oder konvertiert sie sie?
Nein. Sie lädt, inspiziert und speichert ausschließlich PSD/PSB-Dokumente — sie rendert keine Pixeldaten und konvertiert nicht in andere Bildformate.
Wo fange ich an?
Kern API für das PsdImage Einstiegspunkt, dann Layers für Metadaten auf Layer-Ebene, und Core-Ausnahmen für die Fehlerbehandlung.
API Reference Zusammenfassung
| Area | Abgedeckt in |
|---|---|
| Dokumentenladen, Inspektion und Speicherung | Core API |
| Dokumentabschnitte (Header, Farbdaten, Bilddaten) | Sections |
| Layer-Metadaten | Layers |
| Bildressourcen | Resources |
| Fehlerbehandlung beim Laden/Speichern | Kern-Ausnahmen |
| Dokumente schreiben | Schreibdeskriptoren |
| Rohbyte-Konvertierung | Conversion |