v0.9.1

This release fixes a bug which made the layer fill not transfer properly on read/write as well as exposing this through a property on a Layer instance

Features:

• Add the fill property on the layer as documented here

Bugfixes

• Fix layer effects not being passed along on read/write

v0.9.0

This release primarily brings the long awaited support for editable text layers thanks to @ogkalu2!. For documentation please refer to here:

https://photoshopapi.readthedocs.io/en/latest/concepts/text-layers.html

Features:

• Add support for editable text layer. You can now read/parse/update/create text layer data.
• Add support for modifying a layers' display color via the new Layer<T>::display_color property.
• Add support for passing unparsed data on roundtripping so e.g. adjustment layers will be maintained as you read/write files.

Bugfixes

• Fix linked layers from latest photoshop release not parsing due to updated descriptor version (thanks @prodBirdy!)

CI/Build

• Add support for python 3.14 out of the box

v0.8.2

Bugfixes

• Fix bug where large files (>30.000) pixels would report EOF read error in Photoshop #196

v0.8.1

Bugfixes

• Fix bug where uncompressed 8-bit layers would load as white #164 #191
• Fix bug where smart object layer channel order was non-deterministic #190

v0.8.0

This release mainly focuses on bugfixes as well as some QOL changes. More larger changes are to follow!

We have a first time contribute with this release @oallw, thank you for contributing! 🥳

Features:

• Swap the internal compression backend to use the compressed-image API which should give some additional performance/memory savings as well as providing a way to interact with the compressed file buffers.
• python: Allow setting of icc profiles directly with numpy arrays

Bugfixes

• Fix various Unicode related issues related to file reads. This should now be much more consistent #180 #182
• python: Fix bug where unicode assignment was broken #174 from @oallw
• Fix issue where after replacing a SmartObject, the warp/transform was lost #162

CI/Build

• Fix vcpkg binary caching to speed up CI/Releases
• Bump OpenImageIO from 2.5.16.0 -> 3.0.9.1

v0.7.0 - Smart Object improvements

The v0.7.0 Release primarily fixes miscellaneous errors on smart objects as well as exposing the clipping mask property on layers

Note

This release changes the python import of psapi -> photoshopapi. If you wish to keep using psapi as alias you can import photoshopapi as psapi

Features:

• Add the clipping_mask field to all layer types, allowing you to set and restore clipping masks. #156

Bugfixes

• Fix issue with smart object layers where the quilt warp was being calculated incorrectly, causing stepped output files with an offset #156
• Fix miscellaneous read errors when attempting to read older style smart object descriptors.
• photoshopapi python package will now be properly installed into photoshopapi and photoshopapi.libs rather than polluting site-packages
• Fix python issue on windows where you weren't able to import both PhotoshopAPI and OpenImageIO due to dll issues.

CI/Build

• Change python wheel setup to use more modern scikit-build-core. Deprecate the old setup.py workflow completely replacing it with a much simpler pyproject.toml

Breaking Changes:

• The python wheels are now importable via import photoshopapi, not import psapi

v0.6.1

The v0.6.1 Release fixes some bugs related to smart object layer parsing

Warning

This release drops support for python 3.7 wheels due to CI limitations

Bugfixes:

• Fix smart object layer translating to 0,0 on write #142
• Fix incorrect padding for LinkedLayerItem sometimes causing files with more than one smart object layer to fail #149
• Add internal mini psd/psb reader for reading embedded photoshop files in smart objects rather than relying on OpenImageIO #149
• Add handling and tests for smart object layers that do not embed the customEnvelopeWarp field (which seems to happen sometimes) #149

Deprecations

• Deprecate SmartObjectWarp::valid().

v0.6.0 - Smart Objects

The v0.6.0 Release primarily targets adding support for SmartObject layers and warps. Additionally, we refactored large parts of the internal and public API.

To check out how to use SmartObjects please have a look here for an example, here for the documentation (c++) and here for the documentation (python)

Warning

This is a breaking release, please proceed with caution and read both the changelogs and documentation carefully as large parts of the API were overhauled.

Features:

• Add support for SmartObject layers SmartObjectLayer<T>, psapi.SmartObjectLayer_*bit
• add support for SmartObject warps (Exceptions being "smart" perspective warp and puppet warp)

Python

• Expose all mask parameters that were previously hidden. This includes mask_disabled, mask_relative_to_layer, mask_default_color, mask_density, mask_feather, mask_position, mask_width and mask_height

Bugfixes:

• Masks on layers now are better supported and have their width and height decoupled from the layers' width and height (except for during construction of image layers).
• Internal: Harden file section write to be less error prone using scoped section markers

C++

• Harden template requirements to only allow uint8_t, uint16_t, float for all Photoshop related templates

Python

• Add missing is_visible and is_locked arguments to constructor of layers

Breaking Changes:

• Layer coordinates are no longer expressed relative to the canvas center but rather relative to canvas top left to be more in line with photoshop
  • Example: if previously for a 64x64 canvas a centered layer was at (0, 0), now it would be at (32, 32)
• Layer opacity is now expressed as a float (but still backed by a uint8_t

C++

• Drop C++17 support
• Public facing API was changed from camelCase to snake_case to be more in line and equal to python bindings
• All previously public member variables are now private with appropriate getters and setters to allow the API to implement more logic on them in the future

Python

• All image data is no longer expressed as a property but instead as method as these are potentially quite expensive to compute
• ImageLayer_*bit.channels property is now ImageLayer_*bit.channel_indices()

Miscellaneous:

• Add Compositing Framework to prepare for eventual layer stack compositing
• Internal: Add basic 2D rendering framework
• Internal: Add Geometry Framework to allow for parsing of Quad Meshes and Bezier Surfaces
• Internal: Add Parsing of Descriptors
• Internal: Simplify endian functions to work more generically
• Refactor large parts of the internal API.
• Refactor inheritance structure of Image Based layers and extract mask logic to mixin

Dependencies:

• Add OpenImageIO as dependency (via vcpkg)
• Add fmt as dependency (via vcpkg)
• Add stduiid as dependency (via vcpkg)
• Add eigen3 as dependency (via vcpkg)
• Add json as a submodule
• Move libdeflate from submodule to vcpkg
• Add vcpkg submodule
• Bump c-blosc2 to 2.15.2

Documentation

• Link in examples directly to hosted docs for easier access

CI:

• Add Clang ubuntu build target
• Add ASAN to all tests (that support it)
• Add Clang ubuntu valgrind target

v0.5.2

Bugfixes

Python

• When calling ImageLayer.get_image_data() or ImageLayer.image_data it no longer fails if there is a mask channel with a different size than the image data itself
• ImageLayer num_channels and channels properties now consider the mask channel instead of skipping it

v0.5.1

Bugfixes

• The previous release (v0.5.0) had missing wheels in the release, we address this here. Any pip install of photoshop should target this version instead of v0.5.0