Features
Functies
Aspose.PSD FOSS voor Python laadt, inspecteert en slaat PSD- en PSB-documenten op zonder pixelgegevens te renderen. De functieset is georganiseerd in verschillende gebieden, elk behandeld in zijn eigen gids.
Document Laden, Inspectie en Opslaan
PsdImage.load() laadt een document van een bestandspad of stream; PsdImage.save() schrijft het terug uit. PsdImage toont de geparseerde header (width, height, color_mode, compression, en meer) en de geparseerde afbeeldingsbronnen. Zie Core API voor de volledige referentie.
Documentsecties
Voorbij de top-niveau header, PsdImage toont alleen-lezen samenvattingen voor de kleurgegevens- en afbeeldingsgegevens-secties. Zie Sections voor de volledige referentie.
Laagmetadata
Elke geparseerde Layer maakt haar geometrie, zichtbaarheid, doorzichtigheid, bijsnijden en mengmodus bekend, plus kanaal-, masker- en mengbereikmetadata. Een subset van laag-eigenschappen kan worden gewijzigd en terug opgeslagen; de laagcollectie zelf kan worden hertoegewezen. Zie Layers voor de volledige referentie.
Afbeeldingsbronnen
PsdImage maakt de afbeeldingsresource-blokken van een document in twee vormen bekend, plus een afzonderlijke samenvatting voor geïndexeerde kleurenpaletten. Zie Resources voor de volledige referentie.
Foutafhandeling
Laad- en opslagfouten worden gemeld via PsdLoadException and PsdSaveException, beide uitbreidend op de standaard Exception klasse. Zie Core Exceptions voor de volledige referentie.
Documenten Terug Schrijven
PsdImage.save() is het enige openbare toegangspunt voor het schrijven van een document naar een bestandspad of stream. Zie Schrijf beschrijvingen voor de volledige referentie.
Raw Byte Conversie
BigEndianBitConverter decodeert big-endian gehele getallen van ruwe bytes die je zelf hebt verkregen — bijvoorbeeld van een niet-erkende afbeeldingsbron. Zie Conversion voor de volledige referentie.
Wat niet wordt ondersteund
Deze bibliotheek rendert geen pixelgegevens en converteert PSD/PSB niet naar andere beeldformaten (zoals PNG of JPEG). Het is een metadata-gerichte lezer en schrijver voor het PSD/PSB containerformaat.
Tips en best practices
- Begin met Core API voor het laden, inspecteren en opslaan van een document.
- Gebruik Layers wanneer je individuele laagmetadata moet lezen of bewerken.
- Wrap
load()/save()aanroepen in de foutafhandeling zoals beschreven in Core Exceptions.
Veelvoorkomende problemen
| Probleem | Oorzaak | Herstel |
|---|---|---|
| Verwacht gerenderde pixeloutput | Deze bibliotheek is alleen metadata | Gebruik een andere bibliotheek voor rendering; deze laadt, inspecteert en slaat alleen PSD/PSB metadata op |
FAQ
Rendert of converteert deze bibliotheek PSD-bestanden?
Nee. Het laadt, inspecteert en slaat alleen PSD/PSB-documenten op — het rendert geen pixelgegevens en converteert niet naar andere afbeeldingsformaten.
Waar begin ik?
Kern API voor de PsdImage instappunt, dan Layers voor metadata op laagniveau, en Kernuitzonderingen voor foutafhandeling.
API Reference Samenvatting
| Area | Gedekt in |
|---|---|
| Document laden, inspectie en opslaan | Kern API |
| Documentsecties (header, kleurgegevens, beeldgegevens) | Sections |
| Laagmetadata | Layers |
| Afbeeldingsbronnen | Resources |
| Laden/opslaan-foutafhandeling | Kernuitzonderingen |
| Documenten schrijven | Schrijfdescriptors |
| Ruwe byte-conversie | Conversion |