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 декодирует целые числа в формате 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 |
