Features
Features
Aspose.PSD FOSS for Python loads, inspects, and saves PSD and PSB documents without rendering pixel data. The feature set is organized into several areas, each covered in its own guide.
Document Loading, Inspection, and Saving
PsdImage.load() loads a document from a file path or stream;
PsdImage.save() writes it back out. PsdImage exposes the parsed
header (width, height, color_mode, compression, and more) and the
parsed image resources. See Core API for the full
reference.
Document Sections
Beyond the top-level header, PsdImage exposes read-only summaries for
the color data and image data sections. See Sections for
the full reference.
Layer Metadata
Each parsed Layer exposes its geometry, visibility, opacity, clipping,
and blend mode, plus channel, mask, and blending-range metadata. A
subset of layer properties can be changed and saved back; the layer
collection itself can be reassigned. See Layers for the
full reference.
Image Resources
PsdImage exposes a document’s image resource blocks in two forms, plus
a separate summary for indexed color palettes. See
Resources for the full reference.
Error Handling
Load and save failures are reported through PsdLoadException and
PsdSaveException, both extending the standard Exception class. See
Core Exceptions for the full reference.
Writing Documents Back Out
PsdImage.save() is the single public entry point for writing a document
to a file path or stream. See Write Descriptors
for the full reference.
Raw Byte Conversion
BigEndianBitConverter decodes big-endian integers from raw bytes you’ve
obtained yourself — for example, from an unrecognized image resource.
See Conversion for the full reference.
What’s Not Supported
This library does not render pixel data and does not convert PSD/PSB to other image formats (such as PNG or JPEG). It is a metadata-focused reader and writer for the PSD/PSB container format.
Tips and Best Practices
- Start with Core API for loading, inspecting, and saving a document.
- Use Layers once you need to read or edit individual layer metadata.
- Wrap
load()/save()calls in the exception handling described in Core Exceptions.
Common Issues
| Issue | Cause | Fix |
|---|---|---|
| Expecting rendered pixel output | This library is metadata-only | Use a different library for rendering; this one only loads, inspects, and saves PSD/PSB metadata |
FAQ
Does this library render or convert PSD files?
No. It loads, inspects, and saves PSD/PSB documents only — it does not render pixel data or convert to other image formats.
Where do I start?
Core API for the PsdImage entry point, then
Layers for layer-level metadata, and
Core Exceptions for error handling.
API Reference Summary
| Area | Covered In |
|---|---|
| Document loading, inspection, and saving | Core API |
| Document sections (header, color data, image data) | Sections |
| Layer metadata | Layers |
| Image resources | Resources |
| Load/save error handling | Core Exceptions |
| Writing documents | Write Descriptors |
| Raw byte conversion | Conversion |