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 клас. Див. Core Exceptions для повного довідника.
Запис документів назад
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 |
