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 يفكّ شفرة الأعداد الصحيحة ذات النهاية الكبيرة من بايتات خام حصلت عليها بنفسك — على سبيل المثال، من مصدر صورة غير معروف. راجع Conversion للحصول على المرجع الكامل.
ما غير المدعوم
هذه المكتبة لا تقوم بعرض بيانات البكسل ولا تحول PSD/PSB إلى صيغ صور أخرى (مثل PNG أو JPEG). إنها قارئ وكاتب يركز على البيانات الوصفية لتنسيق الحاوية PSD/PSB.
نصائح وأفضل الممارسات
- ابدأ بـ Core API لتحميل وفحص وحفظ مستند.
- استخدم Layers عند الحاجة إلى قراءة أو تعديل بيانات تعريف الطبقة الفردية.
- Wrap
load()/save()الاتصالات في معالجة الاستثناء الموضحة في استثناءات أساسية.
المشكلات الشائعة
| المشكلة | السبب | الإصلاح |
|---|---|---|
| توقع إخراج بكسل مُصوَّر | هذه المكتبة هي للبيانات الوصفية فقط | استخدم مكتبة مختلفة للتصيير؛ هذه المكتبة فقط تقوم بتحميل، فحص، وحفظ بيانات PSD/PSB الوصفية |
FAQ
هل تقوم هذه المكتبة بعرض أو تحويل ملفات PSD؟
لا. إنها تقوم بتحميل وفحص وحفظ مستندات PSD/PSB فقط — لا تعرض بيانات البكسل ولا تحوّل إلى صيغ صور أخرى.
من أين أبدأ؟
النواة API لـ PsdImage نقطة الدخول، ثم Layers لـ metadata على مستوى الطبقة، و Core Exceptions للتعامل مع الأخطاء.
API Reference ملخص
| Area | مغطى في |
|---|---|
| تحميل المستند، الفحص، والحفظ | النواة API |
| أقسام المستند (العنوان، بيانات اللون، بيانات الصورة) | Sections |
| البيانات الوصفية للطبقة | Layers |
| موارد الصورة | Resources |
| معالجة أخطاء التحميل/الحفظ | استثناءات النواة |
| كتابة المستندات | وصف الكتابة |
| تحويل البايت الخام | Conversion |
