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 класс. См. Основные исключения для полного справочника.
Что не поддерживается
Эта библиотека не рендерит пиксельные данные и не конвертирует PSD/PSB в другие форматы изображений (например, PNG или JPEG). Это читатель и запись, ориентированные на метаданные, для контейнерного формата PSD/PSB.
Советы и лучшие практики
- Начать с Core API для загрузки, проверки и сохранения документа.
- Используйте Layers когда необходимо читать или редактировать метаданные отдельного слоя.
- Wrap
Load()/Save()вызовы в обработке исключений, описанной в Основные исключения.
Распространённые проблемы
| Проблема | Причина | Исправление |
|---|---|---|
| Ожидается отрисованный пиксельный вывод | Эта библиотека работает только с метаданными | Используйте другую библиотеку для рендеринга; эта только загружает, проверяет и сохраняет PSD/PSB метаданные |
FAQ
Эта библиотека рендерит или конвертирует файлы PSD?
Нет. Она загружает, проверяет и сохраняет только документы PSD/PSB — не рендерит пиксельные данные и не конвертирует в другие форматы изображений.
С чего начать?
Core API для PsdImage/Image точка входа, затем Layers для метаданных на уровне слоёв, и Core Exceptions для обработки ошибок.
API Reference Сводка
| Area | Охвачено в |
|---|---|
| Загрузка, проверка и сохранение документа | Core API |
| Метаданные слоя | Layers |
| Обработка ошибок загрузки/сохранения | Исключения ядра |