Aspose.PSD for Java 23.10 - Release Notes
Contents
[
Hide
]
This page contains release notes for Aspose.PSD for Java 23.10
| Key | Summary | Category |
|---|---|---|
| PSDJAVA-538 | Support of vertical text direction | Feature |
| PSDJAVA-542 | Use Stroke settings from vstk resource in Shape Stroke rendering | Feature |
| PSDJAVA-540 | Implement rendering of internal area of Stroke shapes | Feature |
| PSDJAVA-541 | Do not repaint Shape layer if it has not been changed | Feature |
| PSDJAVA-545 | [AI Format] Add support for reading of Header from PDF-based AI Files | Feature |
| PSDJAVA-546 | Various ways to set Psd File Resolution don’t work | Bug |
| PSDJAVA-547 | FontSettings.SetFontsFolders doesn’t work or Aspose.PSD uses incorrect font | Bug |
| PSDJAVA-548 | Regression. Fix Null reference exception raise on PsdImage.Save when having Shape layer | Bug |
Public API Changes
Added APIs:
- M:com.aspose.psd.FontSettings.getGetSystemAlternativeFont
- M:com.aspose.psd.FontSettings.setGetSystemAlternativeFont(boolean)
- M:com.aspose.psd.Graphics.getPaintableImageOptions
- M:com.aspose.psd.Graphics.setPaintableImageOptions(com.aspose.psd.ImageOptionsBase)
- M:com.aspose.psd.Image.getAutoAdjustPalette
- M:com.aspose.psd.Image.getFileFormat(com.aspose.psd.system.io.Stream)
- M:com.aspose.psd.extensions.RegionExtensions.#ctor
- M:com.aspose.psd.fileformats.psd.PsdImage.setResolution(double,double)
- M:com.aspose.psd.fileformats.psd.layers.fillsettings.IFillSettings.setColor(com.aspose.psd.Color)
- M:com.aspose.psd.fileformats.psd.layers.ShapeLayer.getStroke
- M:com.aspose.psd.fileformats.psd.layers.ShapeLayer.setStroke(com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings)
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.VstkResource.getFillSettings
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.VstkResource.setFillSettings(com.aspose.psd.fileformats.psd.layers.fillsettings.IFillSettings)
- F:com.aspose.psd.fileformats.psd.layers.text.rendering.JustificationMode.Center
- T:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.getEnabled
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.getFill
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.getLineAlignment
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.getLineCap
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.getLineDashSet
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.getLineJoin
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.getSize
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.setEnabled(boolean)
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.setFill(com.aspose.psd.fileformats.psd.layers.fillsettings.IFillSettings)
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.setLineAlignment(short)
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.setLineCap(short)
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.setLineDashSet(double[])
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.setLineJoin(short)
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.IStrokeSettings.setSize(double)
- T:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.#ctor
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.getEnabled
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.getFill
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.getLineAlignment
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.setFill(com.aspose.psd.fileformats.psd.layers.fillsettings.IFillSettings)
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.setLineDashSet(double[])
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.getLineCap
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.getLineDashSet
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.getLineJoin
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.getSize
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.setEnabled(boolean)
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.setLineAlignment(short)
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.setLineCap(short)
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.setLineJoin(short)
- M:com.aspose.psd.fileformats.psd.layers.layerresources.strokeresources.StrokeSettings.setSize(double)
- T:com.aspose.psd.fileformats.psd.coreexceptions.LicenseException
- M:com.aspose.psd.fileformats.psd.coreexceptions.LicenseException.#ctor(java.lang.String)
- M:com.aspose.psd.fileformats.psd.coreexceptions.LicenseException.#ctor(java.lang.String,java.lang.Throwable)
Removed APIs:
- M:com.aspose.psd.Image.isAutoAdjustPalette
- M:com.aspose.psd.ImageOptionsBase.memberwiseClone
- M:com.aspose.psd.imageoptions.BmpOptions.memberwiseClone
- M:com.aspose.psd.imageoptions.CmxRasterizationOptions.memberwiseClone
- M:com.aspose.psd.imageoptions.GifOptions.memberwiseClone
- M:com.aspose.psd.imageoptions.Jpeg2000Options.memberwiseClone
- M:com.aspose.psd.imageoptions.JpegOptions.memberwiseClone
- M:com.aspose.psd.imageoptions.PdfOptions.memberwiseClone
- M:com.aspose.psd.imageoptions.PngOptions.memberwiseClone
- M:com.aspose.psd.imageoptions.PsdOptions.memberwiseClone
- M:com.aspose.psd.imageoptions.TiffOptions.memberwiseClone
- M:com.aspose.psd.imageoptions.VectorRasterizationOptions.memberwiseClone
- F:com.aspose.psd.fileformats.psd.layers.text.rendering.JustificationMode.Center
Usage examples:
** PSDJAVA-538. Support of vertical text direction**
String sourceFile = "src/main/resources/692_lt1.psd";
String outputFile = "src/main/resources/692_output.png";
String fontsFolder = "src/main/resources/692_Fonts";
List<String> fontFolders = new List<>(FontSettings.getFontsFolders());
fontFolders.add(fontsFolder);
FontSettings.setFontsFolders(fontFolders.toArray(new String[0]), true);
try(PsdImage psdImage = (PsdImage)Image.load(sourceFile)) {
PngOptions pngOptions = new PngOptions();
pngOptions.setColorType(PngColorType.TruecolorWithAlpha);
psdImage.save(outputFile, pngOptions);
}** PSDJAVA-542. Use Stroke settings from vstk resource in Shape Stroke rendering**
public static void main(String[] args) {
String sourceFile = "src/main/resources/StrokeShapeTest.psd";
String outputFilePsd = "src/main/resources/StrokeShapeTest.out.psd";
String outputFilePng = "src/main/resources/StrokeShapeTest.out.png";
try (PsdImage image = (PsdImage) Image.load(sourceFile)) {
Layer layer = image.getLayers()[1];
ShapeLayer shapeLayer = (ShapeLayer) image.getLayers()[1];
ColorFillSettings fillSettings = (ColorFillSettings) shapeLayer.getFill();
fillSettings.setColor(Color.getGreenYellow());
shapeLayer.update();
ShapeLayer shapeLayer2 = (ShapeLayer) image.getLayers()[3];
GradientFillSettings gradientSettings = (GradientFillSettings) shapeLayer2.getFill();
gradientSettings.setDither(true);
gradientSettings.setReverse(true);
gradientSettings.setAlignWithLayer(false);
gradientSettings.setAngle(20);
gradientSettings.setScale(50);
gradientSettings.getColorPoints()[0].setLocation(100);
gradientSettings.getColorPoints()[1].setLocation(4000);
gradientSettings.getTransparencyPoints()[0].setLocation(200);
gradientSettings.getTransparencyPoints()[1].setLocation(3800);
gradientSettings.getTransparencyPoints()[0].setOpacity(90);
gradientSettings.getTransparencyPoints()[1].setOpacity(10);
shapeLayer2.update();
ShapeLayer shapeLayer3 = (ShapeLayer) image.getLayers()[5];
StrokeSettings strokeSettings = (StrokeSettings) shapeLayer3.getStroke();
strokeSettings.setSize(15);
ColorFillSettings strokeFillSettings = (ColorFillSettings) strokeSettings.getFill();
strokeFillSettings.setColor(Color.getGreenYellow());
shapeLayer3.update();
image.save(outputFilePsd);
image.save(outputFilePng, new PngOptions());
}
// Check changed data.
try (PsdImage image = (PsdImage) Image.load(outputFilePsd)) {
ShapeLayer shapeLayer = (ShapeLayer) image.getLayers()[1];
ColorFillSettings fillSettings = (ColorFillSettings) shapeLayer.getFill();
assertAreEqual(Color.getGreenYellow(), fillSettings.getColor());
ShapeLayer shapeLayer2 = (ShapeLayer) image.getLayers()[3];
GradientFillSettings gradientSettings = (GradientFillSettings) shapeLayer2.getFill();
assertAreEqual(true, gradientSettings.getDither());
assertAreEqual(true, gradientSettings.getReverse());
assertAreEqual(false, gradientSettings.getAlignWithLayer());
assertAreEqual(20.0, gradientSettings.getAngle());
assertAreEqual(50, gradientSettings.getScale());
assertAreEqual(100, gradientSettings.getColorPoints()[0].getLocation());
assertAreEqual(4000, gradientSettings.getColorPoints()[1].getLocation());
assertAreEqual(200, gradientSettings.getTransparencyPoints()[0].getLocation());
assertAreEqual(3800, gradientSettings.getTransparencyPoints()[1].getLocation());
assertAreEqual(90.0, gradientSettings.getTransparencyPoints()[0].getOpacity());
assertAreEqual(10.0, gradientSettings.getTransparencyPoints()[1].getOpacity());
ShapeLayer shapeLayer3 = (ShapeLayer) image.getLayers()[5];
StrokeSettings strokeSettings = (StrokeSettings) shapeLayer3.getStroke();
ColorFillSettings strokeFillSettings = (ColorFillSettings) strokeSettings.getFill();
assertAreEqual(15.0, strokeSettings.getSize());
assertAreEqual(Color.getGreenYellow(), strokeFillSettings.getColor());
}
}
static void assertAreEqual(Object expected, Object actual) {
assertAreEqual(expected, actual, "Objects are not equal.");
}
static void assertAreEqual(Object expected, Object actual, String message) {
if (!expected.equals(actual)) {
throw new IllegalArgumentException(message);
}
}** PSDJAVA-540. Implement rendering of internal area of Stroke shapes**
public static void main(String[] args) {
String sourceFile = "src/main/resources/StrokeShapeTest.psd";
String outputFilePsd = "src/main/resources/StrokeShapeTest.out.psd";
String outputFilePng = "src/main/resources/StrokeShapeTest.out.png";
try (PsdImage image = (PsdImage) Image.load(sourceFile)) {
Layer layer = image.getLayers()[1];
ShapeLayer shapeLayer = (ShapeLayer) image.getLayers()[1];
ColorFillSettings fillSettings = (ColorFillSettings) shapeLayer.getFill();
fillSettings.setColor(Color.getGreenYellow());
shapeLayer.update();
ShapeLayer shapeLayer2 = (ShapeLayer) image.getLayers()[3];
GradientFillSettings gradientSettings = (GradientFillSettings) shapeLayer2.getFill();
gradientSettings.setDither(true);
gradientSettings.setReverse(true);
gradientSettings.setAlignWithLayer(false);
gradientSettings.setAngle(20);
gradientSettings.setScale(50);
gradientSettings.getColorPoints()[0].setLocation(100);
gradientSettings.getColorPoints()[1].setLocation(4000);
gradientSettings.getTransparencyPoints()[0].setLocation(200);
gradientSettings.getTransparencyPoints()[1].setLocation(3800);
gradientSettings.getTransparencyPoints()[0].setOpacity(90);
gradientSettings.getTransparencyPoints()[1].setOpacity(10);
shapeLayer2.update();
ShapeLayer shapeLayer3 = (ShapeLayer) image.getLayers()[5];
StrokeSettings strokeSettings = (StrokeSettings) shapeLayer3.getStroke();
strokeSettings.setSize(15);
ColorFillSettings strokeFillSettings = (ColorFillSettings) strokeSettings.getFill();
strokeFillSettings.setColor(Color.getGreenYellow());
shapeLayer3.update();
image.save(outputFilePsd);
image.save(outputFilePng, new PngOptions());
}
// Check changed data.
try (PsdImage image = (PsdImage) Image.load(outputFilePsd)) {
ShapeLayer shapeLayer = (ShapeLayer) image.getLayers()[1];
ColorFillSettings fillSettings = (ColorFillSettings) shapeLayer.getFill();
assertAreEqual(Color.getGreenYellow(), fillSettings.getColor());
ShapeLayer shapeLayer2 = (ShapeLayer) image.getLayers()[3];
GradientFillSettings gradientSettings = (GradientFillSettings) shapeLayer2.getFill();
assertAreEqual(true, gradientSettings.getDither());
assertAreEqual(true, gradientSettings.getReverse());
assertAreEqual(false, gradientSettings.getAlignWithLayer());
assertAreEqual(20.0, gradientSettings.getAngle());
assertAreEqual(50, gradientSettings.getScale());
assertAreEqual(100, gradientSettings.getColorPoints()[0].getLocation());
assertAreEqual(4000, gradientSettings.getColorPoints()[1].getLocation());
assertAreEqual(200, gradientSettings.getTransparencyPoints()[0].getLocation());
assertAreEqual(3800, gradientSettings.getTransparencyPoints()[1].getLocation());
assertAreEqual(90.0, gradientSettings.getTransparencyPoints()[0].getOpacity());
assertAreEqual(10.0, gradientSettings.getTransparencyPoints()[1].getOpacity());
ShapeLayer shapeLayer3 = (ShapeLayer) image.getLayers()[5];
StrokeSettings strokeSettings = (StrokeSettings) shapeLayer3.getStroke();
ColorFillSettings strokeFillSettings = (ColorFillSettings) strokeSettings.getFill();
assertAreEqual(15.0, strokeSettings.getSize());
assertAreEqual(Color.getGreenYellow(), strokeFillSettings.getColor());
}
}
static void assertAreEqual(Object expected, Object actual) {
assertAreEqual(expected, actual, "Objects are not equal.");
}
static void assertAreEqual(Object expected, Object actual, String message) {
if (!expected.equals(actual)) {
throw new IllegalArgumentException(message);
}
}** PSDJAVA-541. Do not repaint Shape layer if it has not been changed**
public static void main(String[] args) {
String sourceFile = "src/main/resources/ShapeInternalSolid.psd";
String outputFile = "src/main/resources/ShapeInternalSolid.out.psd";
try (PsdImage image = (PsdImage) Image.load(sourceFile)) {
ShapeLayer shapeLayer = (ShapeLayer) image.getLayers()[1];
ColorFillSettings fillSettings = (ColorFillSettings) shapeLayer.getFill();
fillSettings.setColor(Color.getRed());
// Do not use update of Shape layer before save
image.save(outputFile);
// Check saved file rendering
}
// Check that shape layer data remains unchanged.
try (PsdImage image = (PsdImage) Image.load(outputFile)) {
ShapeLayer shapeLayer = (ShapeLayer) image.getLayers()[1];
ColorFillSettings fillSettings = (ColorFillSettings) shapeLayer.getFill();
assertAreEqual(Color.fromArgb(45, 211, 31), fillSettings.getColor());
}
}
static void assertAreEqual(Object expected, Object actual) {
assertAreEqual(expected, actual, "Objects are not equal.");
}
static void assertAreEqual(Object expected, Object actual, String message) {
if (!expected.equals(actual)) {
throw new IllegalArgumentException(message);
}
}** PSDJAVA-545. [AI Format] Add support for reading of Header from PDF-based AI Files**
public static void main(String[] args) {
String sourceFile = "src/main/resources/ai_source.ai";
try (AiImage image = (AiImage)Image.load(sourceFile)) {
assertIsNotNull(image);
assertIsNotNull(image.getHeader());
assertIsNotNull(image.getHeader().getBoundingBox());
}
}
static void assertIsNotNull(Object expected) {
if (expected == null) {
throw new RuntimeException("Object is null.");
}
}** PSDJAVA-546. Various ways to set Psd File Resolution don’t work**
public static void main(String[] args) {
String output1 = "src/main/resources/1560_1_output.psd";
String output2 = "src/main/resources/1560_2_output.psd";
String output3 = "src/main/resources/1560_3_output.psd";
try (PsdImage newPsd = new PsdImage(600, 400)) {
newPsd.setImageResources(new ResourceBlock[]{new ResolutionInfoResource()});
newPsd.setVerticalResolution(100);
newPsd.setHorizontalResolution(100);
newPsd.save(output1);
}
try (PsdImage newPsd = new PsdImage(600, 400)) {
newPsd.setResolution(200, 200);
newPsd.save(output2);
}
try (PsdImage newPsd = new PsdImage(600, 400)) {
ResolutionSetting resolutionSetting = new ResolutionSetting();
resolutionSetting.setHorizontalResolution(300);
resolutionSetting.setVerticalResolution(300);
PsdOptions psdOptions = new PsdOptions();
psdOptions.setResolutionSettings(resolutionSetting);
newPsd.save(output3, psdOptions);
}
try (PsdImage psdImage1 = (PsdImage) Image.load(output1)) {
ResolutionInfoResource resResource = (ResolutionInfoResource) psdImage1.getImageResources()[0];
isNotNull(resResource);
assertAreEqual(100, resResource.getVDpi().getInteger());
assertAreEqual(100, resResource.getHDpi().getInteger());
}
try (PsdImage psdImage2 = (PsdImage) Image.load(output2)) {
ResolutionInfoResource resResource = (ResolutionInfoResource) psdImage2.getImageResources()[0];
isNotNull(resResource);
assertAreEqual(200, resResource.getVDpi().getInteger());
assertAreEqual(200, resResource.getHDpi().getInteger());
}
try (PsdImage psdImage3 = (PsdImage) Image.load(output3)) {
ResolutionInfoResource resResource = (ResolutionInfoResource) psdImage3.getImageResources()[0];
isNotNull(resResource);
assertAreEqual(300, resResource.getVDpi().getInteger());
assertAreEqual(300, resResource.getHDpi().getInteger());
}
}
static void isNotNull(Object obj) {
if (obj == null) {
throw new NullReferenceException();
}
}
static void assertAreEqual(Object expected, Object actual) {
assertAreEqual(expected, actual, "Objects are not equal.");
}
static void assertAreEqual(Object expected, Object actual, String message) {
if (!expected.equals(actual)) {
throw new IllegalArgumentException(message);
}
}** PSDJAVA-547. FontSettings.SetFontsFolders doesn’t work or Aspose.PSD uses incorrect font**
String src = "src/main/resources/1728_Untitled-1.psd";
String fontsDir = "src/main/resources/Fonts";
String outputPng = "src/main/resources/1728_output.png";
FontSettings.setFontsFolders(new String[]{fontsDir}, true);
try (PsdImage psdImage = (PsdImage) Image.load(src)) {
for (Layer layer : psdImage.getLayers()) {
if (layer instanceof TextLayer) {
TextLayer textLayer = (TextLayer) layer;
IText textData = textLayer.getTextData();
textData.updateLayerData();
}
psdImage.save(outputPng, new PngOptions());
}
}** PSDJAVA-548. Regression. Fix Null reference exception raise on PsdImage.Save when having Shape layer**
String sourceFile = "src/main/resources/ShapeInternalSolid.psd";
try (PsdImage im = (PsdImage) PsdImage.load(sourceFile)) {
// Should load without exception
ShapeLayer shapeLayer = (ShapeLayer) im.getLayers()[1];
if (shapeLayer.getRawDataSettings() == null) {
throw new RuntimeException("RawDataSettings should not be null.");
}
}