Additional test and javadoc update

DEVSIX-1658

Author: Samuel Huylebroeck

layout/src/main/java/com/itextpdf/layout/element/Image.java

@@ -340,9 +340,10 @@ public Image setAutoScale(boolean autoScale) {
         return this;
     }
 
+    //TODO(DEVSIX-1658):Remove bugged mention
     /**
      * Sets the autoscale property for the height of the image.
-     *
+     * Is currently bugged and will not work as expected.
      * @param autoScale whether or not to let the image height resize automatically
      * @return this image
      */

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

@@ -543,6 +543,40 @@ public void imageTest20() throws IOException, InterruptedException {
         Assert.assertNull(new CompareTool().compareByContent(outFileName, cmpFileName, destinationFolder, "diff"));
     }
 
+    @Ignore("DEVSIX-1658")
+    @Test
+    public void imageTest21() throws IOException, InterruptedException {
+        String outFileName = destinationFolder + "imageTest21.pdf";
+        String cmpFileName = sourceFolder + "cmp_imageTest21.pdf";
+
+        PdfWriter writer = new PdfWriter(outFileName);
+        PdfDocument pdfDoc = new PdfDocument(writer);
+        Document doc = new Document(pdfDoc);
+
+        Image image = new Image(ImageDataFactory.create(sourceFolder + "Desert.jpg"));
+        image.setAutoScaleHeight(true);
+        float[] colWidths = {1f,1f};
+
+        Table container = new Table(UnitValue.createPercentArray(colWidths));
+        container.addCell("Text");
+        container.addCell("autoscaling image, height only");
+
+        int textIterations =50;
+        Paragraph p = new Paragraph();
+        for (int i = 0; i < textIterations; i++) {
+            p.add("Text will wrap");
+        }
+        container.addCell(p);
+
+        container.addCell(image);
+
+        doc.add(container);
+
+        doc.close();
+
+        Assert.assertNull(new CompareTool().compareByContent(outFileName, cmpFileName, destinationFolder, "diff"));
+    }
+
     /**
      * Image can be reused in layout, so flushing it on the very first draw is a bad thing.
      */