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 | پوشش داده شده در |
|---|---|
| بارگذاری، بازرسی و ذخیره‌سازی سند | هسته API |
| متادیتا لایه | Layers |
| مدیریت خطاهای بارگذاری/ذخیره | استثنائات هسته |
