Features
الميزات
Aspose.PSD FOSS لـ .NET يحمل، يفحص، ويحفظ مستندات PSD و PSB دون عرض بيانات البكسل. تم تنظيم مجموعة الميزات إلى ثلاث مناطق، كل واحدة مغطاة في دليلها الخاص.
تحميل المستند، الفحص، والحفظ
Image.Load() / PsdImage.Load() حمّل مستندًا من مسار ملف أو تدفق؛ PsdImage.Save() يكتبها مرةً أخرى. PsdImage يكشف عن الرأس المُحلل (Width, Height, ColorMode, Version, Compression, وأكثر) وموارد الصورة المُحللة. انظر Core API للحصول على المرجع الكامل.
بيانات تعريف الطبقة
كل مُحلل Layer يكشف عن هندسته، وضوحه، شفافيته، قصه، ووضعية المزج، بالإضافة إلى قناة، قناع، وبيانات نطاق-المزج. يمكن تغيير مجموعة فرعية من خصائص الطبقة وحفظها مرةً أخرى؛ ويمكن تصفية أو إعادة ترتيب مجموعة الطبقات نفسها. انظر Layers للمراجعة الكاملة.
معالجة الأخطاء
يتم الإبلاغ عن فشل التحميل والحفظ عبر PsdLoadException and PsdSaveException, كلاهما يوسّع المعيار Exception فئة. انظر استثناءات Core للحصول على المرجع الكامل.
ما غير مدعوم
هذه المكتبة لا تقوم بعرض بيانات البكسل ولا تحول PSD/PSB إلى صيغ صور أخرى (مثل PNG أو JPEG). إنها قارئ وكاتب يركز على البيانات الوصفية لتنسيق الحاوية PSD/PSB.
نصائح وأفضل الممارسات
- ابدأ بـ Core API لتحميل، وفحص، وحفظ مستند.
- استخدم Layers عندما تحتاج إلى قراءة أو تعديل بيانات تعريف الطبقة الفردية.
- Wrap
Load()/Save()استدعاءات في معالجة الاستثناء الموضحة في الاستثناءات الأساسية.
المشكلات الشائعة
| المشكلة | السبب | إصلاح |
|---|---|---|
| توقع إخراج بكسل مُعالج | هذه المكتبة هي للبيانات الوصفية فقط | استخدم مكتبة مختلفة للعرض؛ هذه المكتبة فقط تقوم بتحميل وفحص وحفظ بيانات PSD/PSB الوصفية |
FAQ
هل تقوم هذه المكتبة بعرض أو تحويل ملفات PSD؟
لا. إنها تقوم بتحميل وفحص وحفظ مستندات PSD/PSB فقط — ولا تعرض بيانات البكسل أو تحولها إلى صيغ صور أخرى.
من أين أبدأ؟
النواة API لـ PsdImage/Image نقطة الدخول، ثم Layers للتعريف الوصفي على مستوى الطبقة، و الاستثناءات الأساسية للتعامل مع الأخطاء.
ملخص API Reference
| Area | مغطى في |
|---|---|
| تحميل المستند، الفحص، والحفظ | Core API |
| البيانات الوصفية للطبقة | Layers |
| معالجة أخطاء التحميل/الحفظ | Core Exceptions |
