Sections

Sections

Ein geladenes PsdImage stellt schreibgeschützte Zusammenfassungsobjekte für die strukturellen Abschnitte eines PSD/PSB-Dokuments bereit — den Header, den Farbdatenabschnitt, den Bilddatenabschnitt und den Bildressourcenabschnitt — alles über typisierte Eigenschaften, ohne dass manuelles Byte-Level-Parsing erforderlich ist.

Untersuchung des Header-Abschnitts

PsdImage.header liefert ein PsdHeader mit den rohen strukturellen Feldern des Dokuments. PsdHeader.version ist die rohe PSD-Container-Version (1 für PSD, 2 für PSB) — dies ist eine andere Eigenschaft als das nicht zusammenhängende PsdImage.version, das eine feste API-Versionsnummer ist und keinen Dateiformatwert darstellt.

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

Untersuchung des Farbdatenabschnitts

PsdImage.color_data_info liefert eine PsdColorDataInfo-Zusammenfassung; kind ist ein PsdColorDataKind-Wert (NONE, INDEXED_PALETTE, RGB_PAYLOAD, CMYK_PAYLOAD oder 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}")

Untersuchung des Bilddatenabschnitts

PsdImage.image_data_info gibt eine PsdImageDataInfo Zusammenfassung zurück, die beschreibt, wie die zusammengeführten Pixeldaten codiert sind; image.compression meldet dieselbe Codierung über ein separates 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}")

Untersuchung des Bildressourcenabschnitts

PsdImage.resources, resource_count, und has_image_resources surface die Inhalte des Bildressourcenabschnitts. Siehe Resources für die vollständigen Ressourcen API.

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

Tipps und bewährte Verfahren

• PsdHeader und seine zugehörigen Abschnittszusammenfassungen (PsdColorDataInfo, ColorData, PsdImageDataInfo) sind in diesem FOSS-Build schreibgeschützt — es gibt keine öffentlichen Setter für irgendeine ihrer Eigenschaften.
• Verwechseln Sie nicht PsdHeader.version (die reale PSD/PSB Container-Version) mit PsdImage.version (eine nicht zusammenhängende, feste API Versionsnummer, die stets 6 ist).
• Überprüfen Sie image.has_color_mode_data, bevor Sie color_data_info lesen — ein Dokument ohne Farbbereichsdaten gibt zwar immer noch ein Zusammenfassungsobjekt zurück, aber seine Felder könnten nicht aussagekräftig sein.

Häufige Probleme

FAQ

Kann ich den Header, die Farbdaten oder die Bilddatenabschnitte direkt ändern?

Nein — PsdHeader, PsdColorDataInfo, ColorData und PsdImageDataInfo sind alle schreibgeschützte Zusammenfassungsobjekte in diesem FOSS-Build.

Was ist der Unterschied zwischen image.compression und image.image_data_info.kind?

Sie beschreiben dieselbe zugrunde liegende Kodierung durch zwei separate Enums: image.compression liefert einen CompressionMethod-Wert, während image.image_data_info.kind einen ImageDataKind-Wert zurückgibt.

API Reference Zusammenfassung

Siehe auch

• Kern API
• Resources
• Aspose.PSD — Enterprise Documentation