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

  • PsdHeader en 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 met PsdImage.version (een niet-gerelateerde, vaste API versienummer die altijd 6 is).
  • Controleer image.has_color_mode_data voordat je color_data_info leest — een document zonder kleurmodus-gegevens geeft nog steeds een samenvattingsobject terug, maar de velden zijn mogelijk niet betekenisvol.

Veelvoorkomende problemen

ProbleemOorzaakOplossing
header.color_mode komt niet overeen met image.color_modePsdHeader.color_mode is het ruwe gehele getalveld uit het bestand; PsdImage.color_mode is de sterk getypeerde ColorModes enum die ervan is opgebouwdGebruik 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 NoneHet kleurgegevens-type van het document is niet INDEXED_PALETTEAlleen 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/MethodeBeschrijving
PsdImage.headerSamenvatting documentkop (PsdHeader)
PsdImage.color_data_info / parsed_color_dataSamenvatting van kleurgegevenssectie (PsdColorDataInfo / ColorData)
PsdImage.image_data_info / image_data_kind / compressionSamenvatting van afbeeldingsgegevenssectie
PsdImage.resources / resource_count / has_image_resourcesSamenvatting van afbeeldingsbronnensectie

Zie ook

 Nederlands