Sections

Sections

Un PsdImage caricato espone oggetti di riepilogo in sola lettura per le sezioni strutturali di un documento PSD/PSB — l’intestazione, la sezione dati colore, la sezione dati immagine e la sezione risorse immagine — tutto tramite proprietà tipizzate, senza richiedere alcuna analisi manuale a livello di byte.

Ispezione della sezione Intestazione

PsdImage.header restituisce un PsdHeader con i campi strutturali grezzi del documento. PsdHeader.version è la versione grezza del contenitore PSD (1 per PSD, 2 per PSB) — questa è una proprietà diversa da PsdImage.version, che è un numero di versione API fisso, non un valore di formato file.

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

Ispezione della sezione Dati colore

PsdImage.color_data_info restituisce un riepilogo PsdColorDataInfo; kind è un valore PsdColorDataKind (NONE, INDEXED_PALETTE, RGB_PAYLOAD, CMYK_PAYLOAD o 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}")

Ispezione della sezione Dati immagine

PsdImage.image_data_info restituisce un riepilogo PsdImageDataInfo che descrive come i dati pixel uniti sono codificati; image.compression riporta la stessa codifica tramite un enum CompressionMethod separato.

data_info = image.image_data_info
print(f"Compression: {image.compression}, data kind: {data_info.kind}")
print(f"Uses prediction: {data_info.uses_prediction}")

Ispezione della sezione delle risorse immagine

PsdImage.resources, resource_count, e has_image_resources visualizza il contenuto della sezione delle risorse immagine. Vedi Resources per le risorse complete API.

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

Suggerimenti e migliori pratiche

• PsdHeader e i relativi riepiloghi delle sezioni (PsdColorDataInfo, ColorData, PsdImageDataInfo) sono tutti di sola lettura in questa build FOSS — non esistono setter pubblici per nessuna delle loro proprietà.
• Non confondere PsdHeader.version (la reale versione container PSD/PSB) con PsdImage.version (un numero di versione API fisso e non correlato che è sempre 6).
• Verifica image.has_color_mode_data prima di leggere color_data_info — un documento senza dati della modalità colore restituisce comunque un oggetto riepilogo, ma i suoi campi potrebbero non essere significativi.

Problemi comuni

FAQ

Posso modificare direttamente le sezioni dell’intestazione, dei dati colore o dei dati immagine?

No — PsdHeader, PsdColorDataInfo, ColorData e PsdImageDataInfo sono tutti oggetti di riepilogo in sola lettura in questa build FOSS.

Qual è la differenza tra image.compression e image.image_data_info.kind?

Descrivono la stessa codifica di base tramite due enum separate: image.compression restituisce un valore CompressionMethod, mentre image.image_data_info.kind restituisce un valore ImageDataKind.

API Reference Riepilogo

Vedi anche

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