Add setter for background-image and List of background-images

DEVSIX-1948

Author: Eugene Bochilo

layout/src/main/java/com/itextpdf/layout/ElementPropertyContainer.java

@@ -51,6 +51,7 @@ This file is part of the iText (R) project.
 import com.itextpdf.layout.hyphenation.HyphenationConfig;
 import com.itextpdf.layout.layout.LayoutPosition;
 import com.itextpdf.layout.property.Background;
+import com.itextpdf.layout.property.BackgroundImage;
 import com.itextpdf.layout.property.BaseDirection;
 import com.itextpdf.layout.property.BorderRadius;
 import com.itextpdf.layout.property.FontKerning;
@@ -440,6 +441,28 @@ public T setBackgroundColor(Color backgroundColor, float opacity, float extraLef
         return (T) (Object) this;
     }
 
+    /**
+     * Specifies a background image for the Element.
+     *
+     * @param image {@link BackgroundImage}
+     * @return this Element.
+     */
+    public T setBackgroundImage(BackgroundImage image) {
+        setProperty(Property.BACKGROUND_IMAGE, image);
+        return (T) (Object) this;
+    }
+
+    /**
+     * Specifies a list of background images for the Element.
+     *
+     * @param imagesList List of {@link BackgroundImage}
+     * @return this Element.
+     */
+    public T setBackgroundImage(List<BackgroundImage> imagesList) {
+        setProperty(Property.BACKGROUND_IMAGE, imagesList);
+        return (T) (Object) this;
+    }
+
     /**
      * Sets a border for all four edges of this Element with customizable color, width, pattern type.
      *

layout/src/test/java/com/itextpdf/layout/BackgroundImageTest.java

@@ -51,11 +51,15 @@ This file is part of the iText (R) project.
 import com.itextpdf.kernel.colors.gradients.StrategyBasedLinearGradientBuilder;
 import com.itextpdf.kernel.colors.gradients.StrategyBasedLinearGradientBuilder.GradientStrategy;
 import com.itextpdf.kernel.geom.Rectangle;
+import com.itextpdf.kernel.pdf.PdfArray;
 import com.itextpdf.kernel.pdf.PdfDocument;
+import com.itextpdf.kernel.pdf.PdfName;
+import com.itextpdf.kernel.pdf.PdfString;
 import com.itextpdf.kernel.pdf.PdfWriter;
 import com.itextpdf.kernel.pdf.canvas.PdfCanvas;
 import com.itextpdf.kernel.pdf.xobject.PdfFormXObject;
 import com.itextpdf.kernel.pdf.xobject.PdfImageXObject;
+import com.itextpdf.kernel.pdf.xobject.PdfTransparencyGroup;
 import com.itextpdf.kernel.utils.CompareTool;
 import com.itextpdf.layout.element.Div;
 import com.itextpdf.layout.element.Paragraph;
@@ -191,7 +195,7 @@ public void backgroundImageForText() throws IOException, InterruptedException {
 
             Text textElement = new Text("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
                     "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. ");
-            textElement.setProperty(Property.BACKGROUND_IMAGE, backgroundImage);
+            textElement.setBackgroundImage(backgroundImage);
             textElement.setFontSize(50);
 
             doc.add(new Paragraph(textElement));
@@ -537,7 +541,7 @@ private void backgroundXObjectGenericTest(String filename, BackgroundImage backg
 
 
         Div div = new Div().add(new Paragraph(text + text + text));
-        div.setProperty(Property.BACKGROUND_IMAGE, backgroundImage);
+        div.setBackgroundImage(backgroundImage);
         doc.add(div);
 
         pdfDocument.close();