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_modePsdHeader.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סיכום מקטע משאבי תמונה

ראה גם

 עברית