Sections

Sections

En laddad PsdImage exponerar skrivskyddade sammanfattningsobjekt för de strukturella sektionerna i ett PSD/PSB-dokument — rubriken, färgdatasektionen, bilddatasektionen och bildresursersektionen — allt via typade egenskaper, utan att kräva någon manuell byte-nivå-parsning.


Inspektera rubriksektionen

PsdImage.header returnerar en PsdHeader med dokumentets råa strukturella fält. PsdHeader.version är den råa PSD-behållarversionen (1 för PSD, 2 för PSB) — detta är en annan egenskap än den orelaterade PsdImage.version, som är ett fast API versionsnummer, inte ett filformatvärde.

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}")

Inspektera färgdatasektionen

PsdImage.color_data_info returnerar en PsdColorDataInfo-sammanfattning; kind är ett PsdColorDataKind-värde (NONE, INDEXED_PALETTE, RGB_PAYLOAD, CMYK_PAYLOAD eller 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}")

Inspektera bilddatasektionen

PsdImage.image_data_info returnerar en PsdImageDataInfo sammanfattning som beskriver hur de sammanslagna pixeldata är kodade; image.compression rapporterar samma kodning via en separat 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}")

Inspektera bildresursavsnittet

PsdImage.resources, resource_count, och has_image_resources visa bildresursavsnittets innehåll. Se Resources för de fullständiga resurserna API.

print(f"Resource count: {image.resource_count}")

Tips och bästa praxis

  • PsdHeader och dess relaterade avsnittssammanfattningar (PsdColorDataInfo, ColorData, PsdImageDataInfo) är alla skrivskyddade i detta FOSS-bygge — det finns inga offentliga set-metoder för någon av deras egenskaper.
  • Förväxla inte PsdHeader.version (den verkliga PSD/PSB container-versionen) med PsdImage.version (ett orelaterat, fast API versionsnummer som alltid är 6).
  • Kontrollera image.has_color_mode_data innan du läser color_data_info — ett dokument utan färglägesdata returnerar fortfarande ett sammanfattningsobjekt, men dess fält kanske inte är meningsfulla.

Vanliga problem

ProblemOrsakÅtgärd
header.color_mode matchar inte image.color_modePsdHeader.color_mode är det råa heltalsfältet från filen; PsdImage.color_mode är den starkt typade ColorModes enum som byggs från denAnvänd image.color_mode för ett typat värde; använd header.color_mode endast om du behöver det råa heltalet
color_data_info.indexed_palette är NoneDokumentets färgdatatyp är inte INDEXED_PALETTEEndast indexerade färgdokument har en palett — kontrollera color_data_info.kind först

FAQ

Kan jag modifiera header-, färgdata- eller bilddatasektionerna direkt?

Nej — PsdHeader, PsdColorDataInfo, ColorData och PsdImageDataInfo är alla skrivskyddade sammanfattningsobjekt i denna FOSS-version.

Vad är skillnaden mellan image.compression och image.image_data_info.kind?

De beskriver samma underliggande kodning via två separata uppräkningar: image.compression returnerar ett CompressionMethod-värde, medan image.image_data_info.kind returnerar ett ImageDataKind-värde.


API Reference Sammanfattning

Klass/MetodBeskrivning
PsdImage.headerSammanfattning av dokumenthuvud (PsdHeader)
PsdImage.color_data_info / parsed_color_dataSammanfattning av färgdatasektion (PsdColorDataInfo / ColorData)
PsdImage.image_data_info / image_data_kind / compressionSammanfattning av bilddatasektion
PsdImage.resources / resource_count / has_image_resourcesSammanfattning av bildresursersektion

Se även

 Svenska