Aspose.PSD for Java 24.1 - Release Notes

This page contains release notes for Aspose.PSD for Java 24.1

Key	Summary	Category
PSDJAVA-576	[AI Format] Add basic handling for multipage AI images.	Feature
PSDJAVA-579	Warp Text Effect doesn’t apply to text.	Bug
PSDJAVA-580	Incorrect rendering of mask in the specific file.	Bug
PSDJAVA-581	NullReferenceException at Aspose.PSD.FontParsing.OpenType.Serialization.OpenTypeFontInfo.ctor.	Bug
PSDJAVA-582	[AI Format] Fixing the memory usage in AiExporterUtils.	Bug

Public API Changes

Added APIs:

M:com.aspose.psd.fileformats.ai.AiImage.getActivePageIndex
M:com.aspose.psd.fileformats.ai.AiImage.setActivePageIndex(int)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.getInterpolation
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.setInterpolation(short)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.IGradientFillSettings.getGradientMode
M:com.aspose.psd.fileformats.psd.layers.fillsettings.IGradientFillSettings.setGradientMode(int)
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.getColorModel
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.getGradientMode
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.getMaximumColor
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.getMinimumColor
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.getRndNumberSeed
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.getRoughness
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.getShowTransparency
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.getUseVectorColor
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.setColorModel(java.lang.String)
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.setGradientMode(java.lang.String)
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.setMaximumColor(com.aspose.psd.fileformats.psd.rawcolor.RawColor)
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.setMinimumColor(com.aspose.psd.fileformats.psd.rawcolor.RawColor)
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.setRndNumberSeed(int)
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.setRoughness(int)
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.setShowTransparency(boolean)
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource.setUseVectorColor(boolean)
M:com.aspose.psd.fileformats.psd.layers.smartobjects.SmartObjectLayer.#ctor(com.aspose.psd.system.io.Stream)
F:com.aspose.psd.fileformats.psd.resources.enums_.ColorSpace.RGB
T:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.#ctor
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.getColorModel
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.getMaximumColor
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.getMinimumColor
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.getRndNumberSeed
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.getRoughness
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.getShowTransparency
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.getUseVectorColor
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.setColorModel(short)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.setMaximumColor(com.aspose.psd.fileformats.psd.rawcolor.RawColor)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.setMinimumColor(com.aspose.psd.fileformats.psd.rawcolor.RawColor)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.setRndNumberSeed(int)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.setRoughness(int)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.setShowTransparency(boolean)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.NoiseGradientFillSettings.setUseVectorColor(boolean)
T:com.aspose.psd.fileformats.psd.layers.layerresources.GdflResourceHelper
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdflResourceHelper.#ctor
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdflResourceHelper.gradientKindToStr(int)
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdflResourceHelper.noiseColorModelToStr(short)
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdflResourceHelper.strToGradientKind(java.lang.String)
M:com.aspose.psd.fileformats.psd.layers.layerresources.GdflResourceHelper.strToNoiseColorModel(java.lang.String)
F:com.aspose.psd.fileformats.psd.layers.layerresources.GdflResourceHelper.StrGradientNoise
F:com.aspose.psd.fileformats.psd.layers.layerresources.GdflResourceHelper.StrGradientSolid
F:com.aspose.psd.fileformats.psd.layers.layerresources.GdflResourceHelper.StrModelHSB
F:com.aspose.psd.fileformats.psd.layers.layerresources.GdflResourceHelper.StrModelLAB
F:com.aspose.psd.fileformats.psd.layers.layerresources.GdflResourceHelper.StrModelRGB
T:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.#ctor
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.#ctor(com.aspose.psd.fileformats.psd.layers.layerresources.GdFlResource)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.getAlignWithLayer
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.getAngle
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.getDither
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.getFillType
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.getGradientMode
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.getGradientType
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.getHorizontalOffset
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.getReverse
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.getScale
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.getVerticalOffset
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.setAlignWithLayer(boolean)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.setAngle(double)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.setDither(boolean)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.setGradientMode(int)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.setGradientType(int)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.setHorizontalOffset(double)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.setReverse(boolean)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.setScale(int)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.BaseGradientFillSettings.setVerticalOffset(double)

Removed APIs:

M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.getAlignWithLayer
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.getAngle
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.getDither
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.getFillType
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.getGradientType
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.getHorizontalOffset
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.getReverse
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.getScale
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.getVerticalOffset
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.setAlignWithLayer(boolean)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.setAngle(double)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.setDither(boolean)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.setGradientType(int)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.setHorizontalOffset(double)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.setReverse(boolean)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.setScale(int)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.GradientFillSettings.setVerticalOffset(double)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.IFillSettings.setColor(com.aspose.psd.Color)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.IGradientFillSettings.getColor
M:com.aspose.psd.fileformats.psd.layers.fillsettings.IGradientFillSettings.getColorPoints
M:com.aspose.psd.fileformats.psd.layers.fillsettings.IGradientFillSettings.getGradientName
M:com.aspose.psd.fileformats.psd.layers.fillsettings.IGradientFillSettings.getTransparencyPoints
M:com.aspose.psd.fileformats.psd.layers.fillsettings.IGradientFillSettings.setColor(com.aspose.psd.Color)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.IGradientFillSettings.setColorPoints(com.aspose.psd.fileformats.psd.layers.IGradientColorPoint[])
M:com.aspose.psd.fileformats.psd.layers.fillsettings.IGradientFillSettings.setGradientName(java.lang.String)
M:com.aspose.psd.fileformats.psd.layers.fillsettings.IGradientFillSettings.setTransparencyPoints(com.aspose.psd.fileformats.psd.layers.fillsettings.IGradientTransparencyPoint[])
F:com.aspose.psd.fileformats.psd.resources.enums_.ColorSpace.RGB

Usage examples:

** PSDJAVA-576. [AI Format] Add basic handling for multipage AI images**

        String sourceFile = "src/main/resources/threePages.ai";
        String firstPageOutputPng = "src/main/resources/firstPageOutput.png";
        String secondPageOutputPng = "src/main/resources/secondPageOutput.png";
        String thirdPageOutputPng = "src/main/resources/thirdPageOutput.png";

        // Load the AI image.
        try (AiImage image = (AiImage) Image.load(sourceFile)) {
            // By default, the ActivePageIndex is 0.
            // So if you save the AI image without changing this property, the first page will be rendered and saved.
            image.save(firstPageOutputPng, new PngOptions());

            // Change the active page index to the second page.
            image.setActivePageIndex(1);

            // Save the second page of the AI image as a PNG image.
            image.save(secondPageOutputPng, new PngOptions());

            // Change the active page index to the third page.
            image.setActivePageIndex(2);

            // Save the third page of the AI image as a PNG image.
            image.save(thirdPageOutputPng, new PngOptions());
        }

** PSDJAVA-579. Warp Text Effect doesn’t apply to text**

        String sourceFile = "src/main/resources/text_warp.psd";
        String outputFile = "src/main/resources/export.png";

        PsdLoadOptions opt = new PsdLoadOptions();
        opt.setLoadEffectsResource(true);
        opt.setAllowWarpRepaint(true);

        try (PsdImage img = (PsdImage) Image.load(sourceFile, opt)) {
            PngOptions pngOptions = new PngOptions();
            pngOptions.setCompressionLevel(9);
            pngOptions.setColorType(PngColorType.TruecolorWithAlpha);

            img.save(outputFile, pngOptions);
        }

** PSDJAVA-580. Incorrect rendering of mask in the specific file**

        String sourceFile1 = "src/main/resources/mask_problem.psd";
        String sourceFile2 = "src/main/resources/puh_softLight3_1.psd";
        String outputFile1 = "src/main/resources/mask_export.png";
        String outputFile2 = "src/main/resources/puh_export.png";

        PsdLoadOptions opt = new PsdLoadOptions();
        opt.setLoadEffectsResource(true);

        try (PsdImage img = (PsdImage) Image.load(sourceFile1, opt)) {
            PngOptions pngOptions = new PngOptions();
            pngOptions.setCompressionLevel(9);
            pngOptions.setColorType(PngColorType.TruecolorWithAlpha);

            img.save(outputFile1, pngOptions);
        }

        try (PsdImage img = (PsdImage) Image.load(sourceFile2, opt)) {
            PngOptions pngOptions = new PngOptions();
            pngOptions.setCompressionLevel(9);
            pngOptions.setColorType(PngColorType.TruecolorWithAlpha);

            img.save(outputFile2, pngOptions);
        }

** PSDJAVA-581. NullReferenceException at Aspose.PSD.FontParsing.OpenType.Serialization.OpenTypeFontInfo.ctor**

        String fontsFolder = "src/main/resources/Fonts";
        FontSettings.setFontsFolders(new String[]{fontsFolder}, true);

        String inputFile = "src/main/resources/1.psd";
        String outputFile = "src/main/resources/out_1855.png";
        try (PsdImage psdImage = (PsdImage) Image.load(inputFile)) {
            psdImage.save(outputFile, new PngOptions());
        }

** PSDJAVA-582. [AI Format] Fixing the memory usage in AiExporterUtils**

        String sourceFile = "src/main/resources/threePages.ai";
        String firstPageOutputPng = "src/main/resources/firstPageOutput.png";
        String secondPageOutputPng = "src/main/resources/secondPageOutput.png";
        String thirdPageOutputPng = "src/main/resources/thirdPageOutput.png";

        final double MemoryLimit = 700;
        double memoryUsed = Double.MAX_VALUE;

        // Load the AI image.
        try (AiImage image = (AiImage) Image.load(sourceFile)) {
            // Save the first page of the AI image as a PNG image.
            image.save(firstPageOutputPng, new PngOptions());

            // Change the active page index to the second page.
            image.setActivePageIndex(1);

            // Save the second page of the AI image as a PNG image.
            image.save(secondPageOutputPng, new PngOptions());

            // Change the active page index to the third page.
            image.setActivePageIndex(2);

            // Save the third page of the AI image as a PNG image.
            image.save(thirdPageOutputPng, new PngOptions());
        }

        System.gc();

        memoryUsed = (double) (Runtime.getRuntime().totalMemory() - Runtime.getRuntime().freeMemory()) / (1024.0 * 1024.0);

        if (memoryUsed > MemoryLimit) {
            throw new RuntimeException("Usage of memory is too big. " + memoryUsed + " instead of " + String.format("%.1f", MemoryLimit));
        }