Sections
Sections
PsdImage טעון חושף אובייקטי סיכום לקריאה בלבד עבור החלקים המבניים של מסמך PSD/PSB — הכותרת, חלק נתוני הצבע, חלק נתוני התמונה, וחלק משאבי התמונה — כל זאת באמצעות typed properties, ללא צורך בפענוח ידני ברמת הבייט.
בדיקת חלק הכותרת
PsdImage.header מחזיר PsdHeader עם השדות המבניים הגולמיים של המסמך. PsdHeader.version הוא גרסת המכולה הגולמית של 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 מדווח על אותו קידוד דרך enum CompressionMethod נפרד.
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 הוא ה-enum החזק המוגדר ColorModes שנבנה ממנו | השתמש ב-image.color_mode לערך ממוסג; השתמש ב-header.color_mode רק אם אתה צריך את המספר השלם הגולמי |
color_data_info.indexed_palette הוא None | סוג נתוני הצבע של המסמך אינו INDEXED_PALETTE | רק מסמכים עם צבע אינדקסי נושאים פלטה — בדוק קודם את color_data_info.kind |
FAQ
האם אני יכול לשנות ישירות את חלקי הכותרת, נתוני הצבע או נתוני התמונה?
לא — PsdHeader, PsdColorDataInfo, ColorData ו-PsdImageDataInfo הם כולם אובייקטים סיכום לקריאה בלבד בגרסה הפתוחה הזו.
מה ההבדל בין 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 | סיכום מקטע משאבי תמונה |