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_mode | PsdHeader.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 | Σύνοψη ενότητας πόρων εικόνας |