Sections
Sections
Een geladen PsdImage biedt alleen-lees samenvattingsobjecten voor de structurele secties van een PSD/PSB document — de header, de kleurgegevenssectie, de beeldgegevenssectie en de beeldbronnensectie — allemaal via getypeerde eigenschappen, zonder dat handmatig byte-niveau parsing nodig is.
Inspectie van de Headersectie
PsdImage.header retourneert een PsdHeader met de ruwe structurele velden van het document. PsdHeader.version is de ruwe PSD-container versie (1 voor PSD, 2 voor PSB) — dit is een andere eigenschap dan de niet-gerelateerde PsdImage.version, die een vast API versienummer is, geen bestandsformaatwaarde.
from aspose_psd_foss.psdimage import PsdImage
image = PsdImage.load(input_path)
header = image.header
print(f"Size: {header.width}x{header.height}, channels: {header.channels}")
print(f"Bit depth: {header.bit_depth}, raw container version: {header.version}")
print(f"Is PSB: {header.is_large_document}")Inspectie van de Kleurgegevenssectie
PsdImage.color_data_info retourneert een PsdColorDataInfo samenvatting; kind is een PsdColorDataKind waarde (NONE, INDEXED_PALETTE, RGB_PAYLOAD, CMYK_PAYLOAD of RAW_PRESERVED).
if image.has_color_mode_data:
color_info = image.color_data_info
print(f"Color data kind: {color_info.kind}, raw bytes: {color_info.raw_data_length}")Inspectie van de Beeldgegevenssectie
PsdImage.image_data_info retourneert een PsdImageDataInfo samenvatting die beschrijft hoe de samengevoegde pixelgegevens gecodeerd zijn; image.compression rapporteert dezelfde codering via een aparte CompressionMethod enum.
data_info = image.image_data_info
print(f"Compression: {image.compression}, data kind: {data_info.kind}")
print(f"Uses prediction: {data_info.uses_prediction}")Inspecteren van de sectie Afbeeldingsbronnen
PsdImage.resources, resource_count, en has_image_resources toont de inhoud van de sectie met afbeeldingsbronnen. Zie Resources voor de volledige bronnen API.
print(f"Resource count: {image.resource_count}")Tips en best practices
PsdHeaderen de gerelateerde sectiesamenvattingen (PsdColorDataInfo,ColorData,PsdImageDataInfo) zijn allemaal alleen-lezen in deze FOSS-build — er zijn geen openbare setters voor een van hun eigenschappen.- Verwarr
PsdHeader.version(de echte PSD/PSB container-versie) niet metPsdImage.version(een niet-gerelateerde, vaste API versienummer die altijd6is). - Controleer
image.has_color_mode_datavoordat jecolor_data_infoleest — een document zonder kleurmodus-gegevens geeft nog steeds een samenvattingsobject terug, maar de velden zijn mogelijk niet betekenisvol.
Veelvoorkomende problemen
| Probleem | Oorzaak | Oplossing |
|---|---|---|
header.color_mode komt niet overeen met image.color_mode | PsdHeader.color_mode is het ruwe gehele getalveld uit het bestand; PsdImage.color_mode is de sterk getypeerde ColorModes enum die ervan is opgebouwd | Gebruik image.color_mode voor een getypeerde waarde; gebruik header.color_mode alleen als je de ruwe integer nodig hebt |
color_data_info.indexed_palette is None | Het kleurgegevens-type van het document is niet INDEXED_PALETTE | Alleen indexed-color documenten bevatten een palet — controleer eerst color_data_info.kind |
FAQ
Kan ik de header-, kleurgegevens- of afbeeldingsgegevenssecties direct aanpassen?
Nee — PsdHeader, PsdColorDataInfo, ColorData en PsdImageDataInfo zijn allemaal alleen-lezen samenvattingsobjecten in deze FOSS-build.
Wat is het verschil tussen image.compression en image.image_data_info.kind?
Ze beschrijven dezelfde onderliggende codering via twee afzonderlijke enumeraties: image.compression geeft een CompressionMethod-waarde terug, terwijl image.image_data_info.kind een ImageDataKind-waarde teruggeeft.
API Reference Samenvatting
| Klasse/Methode | Beschrijving |
|---|---|
PsdImage.header | Samenvatting documentkop (PsdHeader) |
PsdImage.color_data_info / parsed_color_data | Samenvatting van kleurgegevenssectie (PsdColorDataInfo / ColorData) |
PsdImage.image_data_info / image_data_kind / compression | Samenvatting van afbeeldingsgegevenssectie |
PsdImage.resources / resource_count / has_image_resources | Samenvatting van afbeeldingsbronnensectie |