Aspose.PSD FOSS for Java — Frequently Asked Questions
View as Markdown

Aspose.PSD FOSS for Java — Frequently Asked Questions

Licensing & Open Source

What is the licensing model?

Aspose.PSD FOSS for Java is MIT licensed. You can use, modify and redistribute it under the terms of the MIT license.

Can I use it in commercial products?

Yes. The MIT license permits commercial use, modification and redistribution.

Installation & Requirements

How do I install Aspose.PSD FOSS for Java?

Add org.aspose:aspose-psd-foss:26.11.0 to your Maven build. The library is published on Maven Central and has no third-party runtime dependencies.

Which Java version does it need?

Java 11 or later. It was built for Java 11 and run on Java 11, 17 and 21. The java.desktop module (for java.awt.Color) is needed to load indexed-color documents; in a test on a runtime with only java.base, RGB, CMYK and PSB files loaded without it.

Do I need Adobe Photoshop?

No. The library reads and writes PSD and PSB files itself.

Supported Files & Features

Which files can it open?

PSD and PSB (large document) files. RGB, CMYK and indexed-color PSD files and RGB PSB files were tried. Both types load with PsdImage.load, and PsdImage does not report which of the two a file is.

What can I change in a document?

A layer’s name, visibility and opacity. The position, clipping and blend mode key also have setters; the library does not change the layer’s channel data when you change the position. Save the document with PsdImage.save and the changes are in the file when you load it again.

Does it render or convert PSD files?

No. The library has no rendering, export, conversion or pixel-decoding API. It loads, inspects and saves PSD and PSB structure.

Known Limitations

Which setters are not supported?

PsdImage.setActiveLayer, PsdImage.setImageResources, PsdImage.setGlobalLayerResources, PsdImage.setHasTransparencyData, Layer.setChannelInformation, Layer.setLayerMaskData and Layer.setLayerBlendingRangesData always throw UnsupportedOperationException.

Can I add, remove or reorder layers?

That is not a supported edit. Passing the same layer array back to PsdImage.setLayers is accepted, but it counts as a layer edit and the writer then rewrites every layer record.

Can I use non-ASCII layer names?

Layer names are saved as ASCII text of at most 255 characters. A character that is not ASCII is saved as ?, and saving an edited document rewrites the names of all layers, so do not edit documents whose layer names contain non-ASCII characters.

Errors

Which exception does a file that is not a PSD give?

PsdImage.load(InputStream) throws PsdLoadException. PsdImage.load(String) throws a RuntimeException that wraps it. PsdLoadException is not an IOException.

Does a successful load prove that a file is complete?

No. The loader does not check the merged image data at the end of the file, so a file that is cut off or damaged there still loads.

Does the library close my streams?

load(InputStream) does not close the stream you pass in. save(OutputStream) closes the stream you pass in.

See Also