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
PsdHeaderoch 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) medPsdImage.version(ett orelaterat, fast API versionsnummer som alltid är6). - Kontrollera
image.has_color_mode_datainnan du läsercolor_data_info— ett dokument utan färglägesdata returnerar fortfarande ett sammanfattningsobjekt, men dess fält kanske inte är meningsfulla.
Vanliga problem
| Problem | Orsak | Åtgärd |
|---|---|---|
header.color_mode matchar inte image.color_mode | PsdHeader.color_mode är det råa heltalsfältet från filen; PsdImage.color_mode är den starkt typade ColorModes enum som byggs från den | Anvä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 None | Dokumentets färgdatatyp är inte INDEXED_PALETTE | Endast 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/Metod | Beskrivning |
|---|---|
PsdImage.header | Sammanfattning av dokumenthuvud (PsdHeader) |
PsdImage.color_data_info / parsed_color_data | Sammanfattning av färgdatasektion (PsdColorDataInfo / ColorData) |
PsdImage.image_data_info / image_data_kind / compression | Sammanfattning av bilddatasektion |
PsdImage.resources / resource_count / has_image_resources | Sammanfattning av bildresursersektion |