Sections

Sections

Ένα φορτωμένο PsdImage εκθέτει αντικείμενα σύνοψης μόνο για ανάγνωση για τις δομικές ενότητες ενός εγγράφου PSD/PSB — την κεφαλίδα, την ενότητα δεδομένων χρώματος, την ενότητα δεδομένων εικόνας και την ενότητα πόρων εικόνας — όλα μέσω τυποποιημένων ιδιοτήτων, χωρίς να απαιτείται χειροκίνητη ανάλυση σε επίπεδο byte.


Επιθεώρηση του τμήματος κεφαλίδας

PsdImage.header επιστρέφει ένα PsdHeader με τα ακατέργαστα δομικά πεδία του εγγράφου. PsdHeader.version είναι η ακατέργαστη έκδοση του container PSD (1 για PSD, 2 για PSB) — αυτή είναι διαφορετική ιδιότητα από το ασύνδετο PsdImage.version, το οποίο είναι ένας σταθερός αριθμός έκδοσης API, όχι μια τιμή μορφής αρχείου.

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

Επιθεώρηση του τμήματος δεδομένων χρώματος

PsdImage.color_data_info επιστρέφει μια PsdColorDataInfo σύνοψη; kind είναι μια τιμή PsdColorDataKind (NONE, INDEXED_PALETTE, RGB_PAYLOAD, CMYK_PAYLOAD ή 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}")

Επιθεώρηση του τμήματος δεδομένων εικόνας

PsdImage.image_data_info επιστρέφει μια PsdImageDataInfo σύνοψη που περιγράφει πώς κωδικοποιούνται τα συνενωμένα δεδομένα εικονοστοιχείων· image.compression αναφέρει την ίδια κωδικοποίηση μέσω ενός ξεχωριστού 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}")

Επιθεώρηση της Ενότητας Πόρων Εικόνας

PsdImage.resources, resource_count, και has_image_resources επιφάνεια τα περιεχόμενα της ενότητας πόρων εικόνας. Δείτε Resources για τους πλήρεις πόρους API.

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

Συμβουλές και Καλές Πρακτικές

  • PsdHeader και οι σχετικές περιλήψεις ενότητας (PsdColorDataInfo, ColorData, PsdImageDataInfo) είναι όλες μόνο για ανάγνωση σε αυτήν την έκδοση FOSS — δεν υπάρχουν δημόσιοι setters σε καμία από τις ιδιότητές τους.
  • Μην συγχέετε το PsdHeader.version (την πραγματική έκδοση του δοχείου PSD/PSB) με το PsdImage.version (έναν ασύνδετο, σταθερό αριθμό έκδοσης API που είναι πάντα 6).
  • Ελέγξτε το image.has_color_mode_data πριν διαβάσετε το color_data_info — ένα έγγραφο χωρίς δεδομένα λειτουργίας χρώματος εξακολουθεί να επιστρέφει ένα αντικείμενο σύνοψης, αλλά τα πεδία του ενδέχεται να μην είναι ουσιώδη.

Κοινά Προβλήματα

ΠρόβλημαΑιτίαΔιόρθωση
header.color_mode δεν ταιριάζει με image.color_modePsdHeader.color_mode είναι το ακατέργαστο πεδίο ακέραιου από το αρχείο· PsdImage.color_mode είναι η ισχυρά τυποποιημένη ColorModes enum που δημιουργείται από αυτόΧρησιμοποιήστε το image.color_mode για μια τυποποιημένη τιμή· χρησιμοποιήστε το header.color_mode μόνο αν χρειάζεστε την ακατέργαστη ακέραια τιμή
color_data_info.indexed_palette είναι NoneΟ τύπος δεδομένων χρώματος του εγγράφου δεν είναι INDEXED_PALETTEΜόνο έγγραφα χρώματος ευρετηρίου περιέχουν παλέτα — ελέγξτε πρώτα το color_data_info.kind

FAQ

Μπορώ να τροποποιήσω απευθείας τις ενότητες κεφαλίδας, δεδομένων χρώματος ή δεδομένων εικόνας;

Όχι — PsdHeader, PsdColorDataInfo, ColorData και PsdImageDataInfo είναι όλα αντικείμενα σύνοψης μόνο για ανάγνωση σε αυτήν την έκδοση FOSS.

Ποια είναι η διαφορά μεταξύ image.compression και image.image_data_info.kind;

Περιγράφουν την ίδια υποκείμενη κωδικοποίηση μέσω δύο ξεχωριστών enum: image.compression επιστρέφει μια τιμή CompressionMethod, ενώ image.image_data_info.kind επιστρέφει μια τιμή ImageDataKind.


API Reference Περίληψη

Κλάση/ΜέθοδοςΠεριγραφή
PsdImage.headerΣύνοψη κεφαλίδας εγγράφου (PsdHeader)
PsdImage.color_data_info / parsed_color_dataΣύνοψη ενότητας δεδομένων χρώματος (PsdColorDataInfo / ColorData)
PsdImage.image_data_info / image_data_kind / compressionΣύνοψη ενότητας δεδομένων εικόνας
PsdImage.resources / resource_count / has_image_resourcesΣύνοψη ενότητας πόρων εικόνας

Δείτε επίσης

 Ελληνικά