Features
ویژگی‌ها
Aspose.PSD نرم‌افزار متن‌باز برای Python اسناد PSD و PSB را بارگذاری، بازرسی و ذخیره می‌کند بدون رندر کردن داده‌های پیکسل. مجموعه ویژگی‌ها به چندین حوزه تقسیم شده است که هر کدام در راهنمای خود پوشش داده شده‌اند.
بارگذاری، بازرسی و ذخیره‌سازی سند
PsdImage.load() یک سند را از مسیر فایل یا جریان بارگذاری می‌کند؛ PsdImage.save() آن را دوباره می‌نویسد. PsdImage هدر تجزیه‌شده را در دسترس قرار می‌دهد (width, height, color_mode, compression، و موارد بیشتر) و منابع تصویر تجزیه‌شده. ببینید Core API برای مرجع کامل.
بخش‌های سند
فراتر از هدر سطح بالایی، PsdImage خلاصه‌های فقط-خواندنی برای بخش‌های دادهٔ رنگ و دادهٔ تصویر را در دسترس قرار می‌دهد. ببینید Sections برای مرجع کامل.
فراداده لایه
هر تجزیه‌شده Layer ژئومتری، قابلیت نمایش، شفافیت، برش و حالت ترکیب آن را به همراه متادیتای کانال، ماسک و محدوده ترکیب نشان می‌دهد. زیرمجموعه‌ای از ویژگی‌های لایه می‌تواند تغییر داده شده و دوباره ذخیره شود؛ خود مجموعه لایه‌ها می‌تواند مجدداً اختصاص یابد. See Layers برای مرجع کامل.
منابع تصویر
PsdImage بلوک‌های منبع تصویر یک سند را در دو شکل نشان می‌دهد، به‌علاوه خلاصه‌ای جداگانه برای پالت‌های رنگ ایندکس‌شده. See 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 | پوشش داده شده در |
|---|---|
| بارگذاری، بازرسی و ذخیره‌سازی سند | Core API |
| بخش‌های سند (سرصفحه، داده‌های رنگ، داده‌های تصویر) | Sections |
| متادیتا لایه | Layers |
| منابع تصویر | Resources |
| مدیریت خطاهای بارگذاری/ذخیره | استثنائات اصلی |
| نوشتن اسناد | نوشتن توصیفگرها |
| تبدیل بایت خام | Conversion |
