Enhancement/v20.7

Examples/.gitignore

@@ -1 +1,3 @@
-/target/
+.idea
+/target/
+*.iml

Examples/pom.xml

@@ -17,14 +17,14 @@
         <dependency>
             <groupId>com.aspose</groupId>
             <artifactId>aspose-psd</artifactId>
-            <version>20.5</version>
+            <version>20.9</version>
             <classifier>javadoc</classifier>
         </dependency>
 
          <dependency>
             <groupId>com.aspose</groupId>
             <artifactId>aspose-psd</artifactId>
-            <version>20.5</version>
+            <version>20.9</version>
             <classifier>jdk16</classifier>
         </dependency>
     </dependencies>

Examples/src/main/java/com/aspose/psd/examples/Conversion/SettingForReplacingMissingFonts.java

@@ -27,16 +27,16 @@ public static void main(String[] args)
        String destName = dataDir + "result.png";
 
        PsdLoadOptions loadOptions = new PsdLoadOptions();
-       loadOptions.setDefaultReplacementFont("Arial");
 
         // load PSD image and replace the non found fonts.
         Image image = Image.load(sourceFile,loadOptions);
 
         PsdImage psdImage = (PsdImage)image;
 
-        PngOptions Options = new PngOptions();
-        Options.setColorType(PngColorType.TruecolorWithAlpha);
-        psdImage.save(destName, Options);
+        PngOptions pngOptions = new PngOptions();
+        pngOptions.setColorType(PngColorType.TruecolorWithAlpha);
+        pngOptions.setDefaultReplacementFont("Arial");
+        psdImage.save(destName, pngOptions);
 
 
        //ExEnd:SettingForReplacingMissingFonts

Examples/src/main/java/com/aspose/psd/examples/DrawingAndFormattingImages/FontReplacement.java

@@ -13,24 +13,24 @@
 
 /**
  *
- *  
  */
-public class FontReplacement {
-    public static void main(String[] args) 
+public class FontReplacement
+{
+    public static void main(String[] args)
     {
-       //ExStart:FontReplacement
-     String dataDir = Utils.getDataDir(FontReplacement.class) + "DrawingAndFormattingImages/";
-
-     // Load an image in an instance of image and setting default replacement font.
-     PsdLoadOptions psdLoadOptions = new PsdLoadOptions(); 
-     psdLoadOptions.setDefaultReplacementFont("Arial");
+        //ExStart:FontReplacement
+        String dataDir = Utils.getDataDir(FontReplacement.class) + "DrawingAndFormattingImages/";
 
-     PsdImage psdImage = (PsdImage)Image.load(dataDir +"Cloud_AzPlat_Banner3A_SB_EN_US_160x600_chinese_font.psd", psdLoadOptions);
-
-    PngOptions pngOptions = new PngOptions();
-    psdImage.save(dataDir + "replaced_font.png", pngOptions);
-
+        // Load an image in an instance of image and setting default replacement font.
+        PsdLoadOptions psdLoadOptions = new PsdLoadOptions();
 
-     //ExEnd:FontReplacement
+        PsdImage psdImage = (PsdImage)Image.load(dataDir + "Cloud_AzPlat_Banner3A_SB_EN_US_160x600_chinese_font.psd", psdLoadOptions);
+
+        PngOptions pngOptions = new PngOptions();
+        pngOptions.setDefaultReplacementFont("Arial");
+        psdImage.save(dataDir + "replaced_font.png", pngOptions);
+
+
+        //ExEnd:FontReplacement
     }
 }

Examples/src/main/java/com/aspose/psd/examples/ModifyingAndConvertingImages/PSD/AddStrokeEffectAtRuntime.java

@@ -0,0 +1,115 @@
+package com.aspose.psd.examples.ModifyingAndConvertingImages.PSD;
+
+import com.aspose.psd.Color;
+import com.aspose.psd.Image;
+import com.aspose.psd.examples.Utils.Utils;
+import com.aspose.psd.fileformats.psd.PsdImage;
+import com.aspose.psd.fileformats.psd.layers.fillsettings.FillType;
+import com.aspose.psd.fileformats.psd.layers.fillsettings.IColorFillSettings;
+import com.aspose.psd.fileformats.psd.layers.fillsettings.IGradientFillSettings;
+import com.aspose.psd.fileformats.psd.layers.fillsettings.IPatternFillSettings;
+import com.aspose.psd.fileformats.psd.layers.layereffects.StrokeEffect;
+import com.aspose.psd.fileformats.psd.layers.layereffects.StrokePosition;
+import com.aspose.psd.imageloadoptions.PsdLoadOptions;
+import com.aspose.psd.imageoptions.PngOptions;
+
+/**
+ * This example shows how to add a stroke effect (border) to existing layers of PSD file in Java. There are three types
+ * of the stroke: color, gradient and pattern. Each of the type has three ways (positions) in which the stroke is
+ * rendered: inside, center and outside. This example demonstrates usage of all these cases.
+ */
+public class AddStrokeEffectAtRuntime
+{
+    public static void main(String[] args)
+    {
+        String dataDir = Utils.getDataDir(AddStrokeEffectAtRuntime.class) + "ModifyingAndConvertingImages/PSD/AddStrokeEffectAtRuntime/";
+        String outputDir = Utils.GetDataDir_Output();
+        //ExStart:AddStrokeEffectAtRuntime
+        String srcPsdPath = dataDir + "StrokeEffectsSource.psd";
+		String dstPngPath = outputDir + "output.png";
+
+		PsdLoadOptions psdLoadOptions = new PsdLoadOptions();
+		psdLoadOptions.setLoadEffectsResource(true);
+		PsdImage psdImage = (PsdImage)Image.load(srcPsdPath, psdLoadOptions);
+		try
+		{
+		    StrokeEffect strokeEffect;
+		    IColorFillSettings colorFillSettings;
+		    IGradientFillSettings gradientFillSettings;
+		    IPatternFillSettings patternFillSettings;
+
+		    // 1. Adds Color fill, at position Inside
+		    strokeEffect = psdImage.getLayers()[1].getBlendingOptions().addStroke(FillType.Color);
+		    strokeEffect.setSize(7);
+		    strokeEffect.setPosition(StrokePosition.Inside);
+		    colorFillSettings = (IColorFillSettings)strokeEffect.getFillSettings();
+		    colorFillSettings.setColor(Color.getGreen());
+
+		    // 2. Adds Color fill, at position Outside
+		    strokeEffect = psdImage.getLayers()[2].getBlendingOptions().addStroke(FillType.Color);
+		    strokeEffect.setSize(7);
+		    strokeEffect.setPosition(StrokePosition.Outside);
+		    colorFillSettings = (IColorFillSettings)strokeEffect.getFillSettings();
+		    colorFillSettings.setColor(Color.getGreen());
+
+		    // 3. Adds Color fill, at position Center
+		    strokeEffect = psdImage.getLayers()[3].getBlendingOptions().addStroke(FillType.Color);
+		    strokeEffect.setSize(7);
+		    strokeEffect.setPosition(StrokePosition.Center);
+		    colorFillSettings = (IColorFillSettings)strokeEffect.getFillSettings();
+		    colorFillSettings.setColor(Color.getGreen());
+
+		    // 4. Adds Gradient fill, at position Inside
+		    strokeEffect = psdImage.getLayers()[4].getBlendingOptions().addStroke(FillType.Gradient);
+		    strokeEffect.setSize(5);
+		    strokeEffect.setPosition(StrokePosition.Inside);
+		    gradientFillSettings = (IGradientFillSettings)strokeEffect.getFillSettings();
+		    gradientFillSettings.setAlignWithLayer(false);
+		    gradientFillSettings.setAngle(90);
+
+		    // 5. Adds Gradient fill, at position Outside
+		    strokeEffect = psdImage.getLayers()[5].getBlendingOptions().addStroke(FillType.Gradient);
+		    strokeEffect.setSize(5);
+		    strokeEffect.setPosition(StrokePosition.Outside);
+		    gradientFillSettings = (IGradientFillSettings)strokeEffect.getFillSettings();
+		    gradientFillSettings.setAlignWithLayer(true);
+		    gradientFillSettings.setAngle(90);
+
+		    // 6. Adds Gradient fill, at position Center
+		    strokeEffect = psdImage.getLayers()[6].getBlendingOptions().addStroke(FillType.Gradient);
+		    strokeEffect.setSize(5);
+		    strokeEffect.setPosition(StrokePosition.Center);
+		    gradientFillSettings = (IGradientFillSettings)strokeEffect.getFillSettings();
+		    gradientFillSettings.setAlignWithLayer(true);
+		    gradientFillSettings.setAngle(0);
+
+		    // 7. Adds Pattern fill, at position Inside
+		    strokeEffect = psdImage.getLayers()[7].getBlendingOptions().addStroke(FillType.Pattern);
+		    strokeEffect.setSize(5);
+		    strokeEffect.setPosition(StrokePosition.Inside);
+		    patternFillSettings = (IPatternFillSettings)strokeEffect.getFillSettings();
+		    patternFillSettings.setScale(200);
+
+		    // 8. Adds Pattern fill, at position Outside
+		    strokeEffect = psdImage.getLayers()[8].getBlendingOptions().addStroke(FillType.Pattern);
+		    strokeEffect.setSize(10);
+		    strokeEffect.setPosition(StrokePosition.Outside);
+		    patternFillSettings = (IPatternFillSettings)strokeEffect.getFillSettings();
+		    patternFillSettings.setScale(100);
+
+		    // 9. Adds Pattern fill, at position Center
+		    strokeEffect = psdImage.getLayers()[9].getBlendingOptions().addStroke(FillType.Pattern);
+		    strokeEffect.setSize(10);
+		    strokeEffect.setPosition(StrokePosition.Center);
+		    patternFillSettings = (IPatternFillSettings)strokeEffect.getFillSettings();
+		    patternFillSettings.setScale(75);
+
+		    psdImage.save(dstPngPath, new PngOptions());
+		}
+		finally
+		{
+		    psdImage.dispose();
+		}
+		//ExEnd:AddStrokeEffectAtRuntime
+    }
+}

Examples/src/main/java/com/aspose/psd/examples/ModifyingAndConvertingImages/PSD/SetDefaultReplacementFont.java

@@ -0,0 +1,52 @@
+package com.aspose.psd.examples.ModifyingAndConvertingImages.PSD;
+
+import com.aspose.psd.Image;
+import com.aspose.psd.examples.Utils.Utils;
+import com.aspose.psd.fileformats.psd.PsdImage;
+import com.aspose.psd.fileformats.tiff.enums.TiffExpectedFormat;
+import com.aspose.psd.imageoptions.JpegOptions;
+import com.aspose.psd.imageoptions.PngOptions;
+import com.aspose.psd.imageoptions.TiffOptions;
+
+/**
+ * This example demonstrates how to set a Default Replacement Font during saving the image. The program applies
+ * different default font replacements for different output files.
+ */
+public class SetDefaultReplacementFont
+{
+    public static void main(String[] args)
+    {
+		String dataDir = Utils.getResourcesDir() + "/ModifyingAndConvertingImages/PSD/SetDefaultReplacementFont/";
+		String outputDir = Utils.GetDataDir_Output();
+        //ExStart:SetDefaultReplacementFont
+        // Please, don't install Konstanting Font, because this test should replace font that is not installed
+		String srcPsdPath = dataDir + "sample_konstanting.psd";
+		String[] dstPaths = new String[]
+		        {
+		                "replacedfont0.tiff",
+		                "replacedfont1.png",
+		                "replacedfont2.jpg"
+		        };
+
+		// Load a PSD that require a font that is not installed
+		PsdImage image = (PsdImage)Image.load(srcPsdPath);
+		try
+		{
+		    // This way you can use different fonts for different outputs
+		    image.save(outputDir + dstPaths[0], new TiffOptions(TiffExpectedFormat.TiffJpegRgb));
+
+		    PngOptions pngOptions = new PngOptions();
+		    pngOptions.setDefaultReplacementFont("Verdana");
+		    image.save(outputDir + dstPaths[1], pngOptions);
+
+		    JpegOptions jpegOptions = new JpegOptions();
+		    jpegOptions.setDefaultReplacementFont("Times New Roman");
+		    image.save(outputDir + dstPaths[2], jpegOptions);
+		}
+		finally
+		{
+		    image.dispose();
+		}
+        //ExEnd:SetDefaultReplacementFont
+    }
+}

Examples/src/main/java/com/aspose/psd/examples/ModifyingAndConvertingImages/PSD/SupportBritResource.java

@@ -0,0 +1,71 @@
+package com.aspose.psd.examples.ModifyingAndConvertingImages.PSD;
+
+import com.aspose.psd.Image;
+import com.aspose.psd.examples.Utils.Utils;
+import com.aspose.psd.fileformats.psd.PsdImage;
+import com.aspose.psd.fileformats.psd.layers.Layer;
+import com.aspose.psd.fileformats.psd.layers.LayerResource;
+import com.aspose.psd.fileformats.psd.layers.adjustmentlayers.BrightnessContrastLayer;
+import com.aspose.psd.fileformats.psd.layers.layerresources.BritResource;
+import com.aspose.psd.imageoptions.PsdOptions;
+
+/**
+ * This Example demonstrates how you can programmatically change the PSD Image Brightness/Contrast Layer Resource -
+ * BritResource. This is a Low-Level Aspose.PSD API. You can use Brightness/Contrast Layer through its API, which will
+ * be much easier, but direct PhotoShop resource editing gives you more control over the PSD file content.
+ */
+public class SupportBritResource
+{
+    public static void main(String[] args)
+    {
+		String dataDir = Utils.getResourcesDir() + "/ModifyingAndConvertingImages/PSD/SupportBritResource/";
+		String outputDir = Utils.GetDataDir_Output();
+        //ExStart:SupportBritResource
+        String srcPath = dataDir + "BrightnessContrastPS6.psd";
+		String dstPath = outputDir + "BrightnessContrastPS6_output.psd";
+
+		// Load a Photoshop document containing a Brightness / Contrast adjustment layer
+		PsdImage psdImage = (PsdImage)Image.load(srcPath);
+		try
+		{
+		    // Search for BritResource
+		    for (Layer layer : psdImage.getLayers())
+		    {
+		        if (layer instanceof BrightnessContrastLayer)
+		        {
+		            for (LayerResource layerResource : layer.getResources())
+		            {
+		                if (layerResource instanceof BritResource)
+		                {
+		                    BritResource resource = (BritResource)layerResource;
+
+		                    // Verify resource properties
+		                    if (resource.getBrightness() != -40 ||
+		                            resource.getContrast() != 10 ||
+		                            resource.getLabColor() ||
+		                            resource.getMeanValueForBrightnessAndContrast() != 127)
+		                    {
+		                        throw new RuntimeException("BritResource was read wrong");
+		                    }
+
+		                    // Update resource properties
+		                    resource.setBrightness((short)25);
+		                    resource.setContrast((short)-14);
+		                    resource.setLabColor(true);
+		                    resource.setMeanValueForBrightnessAndContrast((short)200);
+
+		                    // Save a copy of the updated PSD
+		                    psdImage.save(dstPath, new PsdOptions());
+		                    break;
+		                }
+		            }
+		        }
+		    }
+		}
+		finally
+		{
+		    psdImage.dispose();
+		}
+        //ExEnd:SupportBritResource
+    }
+}