Features
תכונות
Aspose.PSD FOSS עבור Python טוען, בודק ושומר מסמכי PSD ו-PSB ללא רינדור נתוני פיקסלים. קבוצת התכונות מאורגנת למספר תחומים, שכל אחד מכוסה במדריך משלו.
טעינת מסמך, בדיקה ושמירה
PsdImage.load() טוען מסמך מנתיב קובץ או זרם; PsdImage.save() כותב אותו חזרה. PsdImage חשוף את הכותרת המעובדת (width, height, color_mode, compression, ועוד) ואת משאבי התמונה המעובדים. ראה Core API להפניה המלאה.
חלקי המסמך
מעבר לכותרת ברמת העליונה, PsdImage חשוף תקצירים לקריאה בלבד עבור סעיפי נתוני הצבע ונתוני התמונה. ראה Sections להפנייה המלאה.
מטא-נתונים של שכבה
כל אחד שנפרש Layer חושף את הגאומטריה, הנראות, השקיפות, הקליפינג ומצב המיזוג שלו, בנוסף למטא-נתונים של ערוץ, מסכה וטווח מיזוג. ניתן לשנות תת-קבוצה של מאפייני השכבה ולשמור חזרה; ניתן לשייך מחדש את אוסף השכבות עצמו. ראה Layers להפנייה המלאה.
משאבי תמונה
PsdImage חושף את בלוקי משאבי התמונה של המסמך בשתי צורות, בנוסף לסיכום נפרד של ערכות צבע אינדקסיות. ראה Resources להפנייה המלאה.
טיפול בשגיאות
תקלות בטעינה ובשמירה מדווחות דרך PsdLoadException and PsdSaveException, שניים מרחיבים את הסטנדרט Exception מחלקה. ראה חריגות ליבה לקבלת ההפנייה המלאה.
כתיבת מסמכים בחזרה
PsdImage.save() הוא נקודת הכניסה הציבורית היחידה לכתיבת מסמך לנתיב קובץ או לזרם. ראה כתוב מתארים להפנייה המלאה.
המרת בתים גולמיים
BigEndianBitConverter מפענח מספרים שלמים big-endian מבייטים גולמיים שקיבלת בעצמך — לדוגמה, ממשאב תמונה לא מזוהה. ראה Conversion להפנייה המלאה.
מה אינו נתמך
ספרייה זו אינה מציגה נתוני פיקסלים ואינה ממירה את PSD/PSB לפורמטים אחרים של תמונה (כגון PNG או JPEG). היא קורא וכותב המתמקד במטא-דאטה עבור פורמט המכולה PSD/PSB.
טיפים והמלצות מומלצות
- התחל עם Core API לטעינה, לבחינה ולשמירת מסמך.
- השתמש Layers כאשר אתה צריך לקרוא או לערוך מטא-דאטה של שכבה בודדת.
- Wrap
load()/save()קריאות בטיפול בחריגות המתואר ב חריגות ליבה.
בעיות נפוצות
| בעיה | סיבה | תיקון |
|---|---|---|
| מצפה לפלט פיקסלים מעובד | ספרייה זו היא רק מטא-דאטה | השתמש בספרייה אחרת להצגה; הספרייה הזו רק טוענת, בודקת ושומרת מטא-נתונים של PSD/PSB |
FAQ
האם הספרייה הזו מציגה או ממירה קבצי PSD?
לא. היא טוענת, בודקת ושומרת מסמכי PSD/PSB בלבד — היא אינה מציגה נתוני פיקסל ולא ממירה לפורמטים תמונה אחרים.
מאיפה אני מתחיל?
ליבת API ל PsdImage נקודת כניסה, ואז Layers למטא-נתונים ברמת שכבה, ו חריגות ליבה לטיפול בשגיאות.
סיכום API Reference
| Area | מתואר ב |
|---|---|
| טעינת מסמך, בדיקה ושמירה | ליבת API |
| קטעי מסמך (כותרת, נתוני צבע, נתוני תמונה) | Sections |
| מטא-נתוני שכבה | Layers |
| משאבי תמונה | Resources |
| טיפול בשגיאות טעינה/שמירה | חריגות ליבה |
| כתיבת מסמכים | כתיבת תיאורים |
| המרת בתים גולמיים | Conversion |
