Limit calculated dimensions by available value

Update tests
Remove obsolete method + javadocs
remove obsolete old method
rename Dimensions classes for code clarity
javadocs
Add two more edge-case tests
javadocs, review remarks and test rename
Remove unnecessary java class
Refactor method
Add tests for running elements variable content width

DEVSIX-2388
DEVSIX-1050

Autoported commit.
Original commit hash: [c4f57240]

Author: rnadvodny

itext.tests/itext.html2pdf.tests/itext/html2pdf/css/PageRuleTest.cs

@@ -464,6 +464,20 @@ public virtual void MarginBoxRunningElements02() {
             RunTest("marginBoxRunningElements02");
         }
 
+        /// <exception cref="System.IO.IOException"/>
+        /// <exception cref="System.Exception"/>
+        [NUnit.Framework.Test]
+        public virtual void MarginBoxRunningElements03() {
+            RunTest("marginBoxRunningElements03");
+        }
+
+        /// <exception cref="System.IO.IOException"/>
+        /// <exception cref="System.Exception"/>
+        [NUnit.Framework.Test]
+        public virtual void MarginBoxRunningElements04() {
+            RunTest("marginBoxRunningElements04");
+        }
+
         /// <exception cref="System.IO.IOException"/>
         /// <exception cref="System.Exception"/>
         [NUnit.Framework.Test]

itext.tests/itext.html2pdf.tests/itext/html2pdf/css/media/page/PageMarginBoxIntegrationTests.cs renamed to itext.tests/itext.html2pdf.tests/itext/html2pdf/css/media/page/PageMarginBoxIntegrationTest.cs

@@ -3,12 +3,12 @@
 using iText.Test.Attributes;
 
 namespace iText.Html2pdf.Css.Media.Page {
-    public class PageMarginBoxIntegrationTests : ExtendedHtmlConversionITextTest {
+    public class PageMarginBoxIntegrationTest : ExtendedHtmlConversionITextTest {
         public static readonly String sourceFolder = iText.Test.TestUtil.GetParentProjectDirectory(NUnit.Framework.TestContext
-            .CurrentContext.TestDirectory) + "/resources/itext/html2pdf/css/media/page/PageMarginBoxIntegrationTests/";
+            .CurrentContext.TestDirectory) + "/resources/itext/html2pdf/css/media/page/PageMarginBoxIntegrationTest/";
 
         public static readonly String destinationFolder = NUnit.Framework.TestContext.CurrentContext.TestDirectory
-             + "/test/itext/html2pdf/css/media/page/PageMarginBoxIntegrationTests/";
+             + "/test/itext/html2pdf/css/media/page/PageMarginBoxIntegrationTest/";
 
         [NUnit.Framework.OneTimeSetUp]
         public static void BeforeClass() {
@@ -349,5 +349,26 @@ public virtual void LargeFixedAllLeftRightTest() {
         public virtual void LargeFixedAllTopBottomTest() {
             ConvertToPdfAndCompare("largeFixedAllTopBottomTest", sourceFolder, destinationFolder);
         }
+
+        /// <exception cref="System.IO.IOException"/>
+        /// <exception cref="System.Exception"/>
+        [NUnit.Framework.Test]
+        public virtual void LargeFixedSidesAutoMiddleTest() {
+            ConvertToPdfAndCompare("largeFixedSidesAutoMiddleTest", sourceFolder, destinationFolder);
+        }
+
+        /// <exception cref="System.IO.IOException"/>
+        /// <exception cref="System.Exception"/>
+        [NUnit.Framework.Test]
+        public virtual void LargeFixedSidesFixedMiddleTest() {
+            ConvertToPdfAndCompare("largeFixedSidesFixedMiddleTest", sourceFolder, destinationFolder);
+        }
+
+        /// <exception cref="System.IO.IOException"/>
+        /// <exception cref="System.Exception"/>
+        [NUnit.Framework.Test]
+        public virtual void LargeFixedSidesNoMiddleTest() {
+            ConvertToPdfAndCompare("largeFixedSidesNoMiddleTest", sourceFolder, destinationFolder);
+        }
     }
 }

itext.tests/itext.html2pdf.tests/itext/html2pdf/css/media/page/fix_dimension/PageMarginBoxFixDimensionTests.cs renamed to itext.tests/itext.html2pdf.tests/itext/html2pdf/css/media/page/fix_dimension/PageMarginBoxFixDimensionTest.cs

@@ -2,7 +2,7 @@
 using iText.Html2pdf;
 
 namespace iText.Html2pdf.Css.Media.Page.Fix_dimension {
-    public class PageMarginBoxFixDimensionTests : ExtendedHtmlConversionITextTest {
+    public class PageMarginBoxFixDimensionTest : ExtendedHtmlConversionITextTest {
         public static readonly String sourceFolder = iText.Test.TestUtil.GetParentProjectDirectory(NUnit.Framework.TestContext
             .CurrentContext.TestDirectory) + "/resources/itext/html2pdf/css/media/page/fix_dimension/";
 

itext.tests/itext.html2pdf.tests/itext/html2pdf/css/media/page/max_dimension/PageMarginBoxMaxDimensionTests.cs renamed to itext.tests/itext.html2pdf.tests/itext/html2pdf/css/media/page/max_dimension/PageMarginBoxMaxDimensionTest.cs

@@ -2,7 +2,7 @@
 using iText.Html2pdf;
 
 namespace iText.Html2pdf.Css.Media.Page.Max_dimension {
-    public class PageMarginBoxMaxDimensionTests : ExtendedHtmlConversionITextTest {
+    public class PageMarginBoxMaxDimensionTest : ExtendedHtmlConversionITextTest {
         public static readonly String sourceFolder = iText.Test.TestUtil.GetParentProjectDirectory(NUnit.Framework.TestContext
             .CurrentContext.TestDirectory) + "/resources/itext/html2pdf/css/media/page/max_dimension/";
 

itext.tests/itext.html2pdf.tests/itext/html2pdf/css/media/page/min_dimension/PageMarginBoxMinDimensionTests.cs renamed to itext.tests/itext.html2pdf.tests/itext/html2pdf/css/media/page/min_dimension/PageMarginBoxMinDimensionTest.cs

@@ -2,7 +2,7 @@
 using iText.Html2pdf;
 
 namespace iText.Html2pdf.Css.Media.Page.Min_dimension {
-    public class PageMarginBoxMinDimensionTests : ExtendedHtmlConversionITextTest {
+    public class PageMarginBoxMinDimensionTest : ExtendedHtmlConversionITextTest {
         public static readonly String sourceFolder = iText.Test.TestUtil.GetParentProjectDirectory(NUnit.Framework.TestContext
             .CurrentContext.TestDirectory) + "/resources/itext/html2pdf/css/media/page/min_dimension/";
 

itext.tests/itext.html2pdf.tests/resources/itext/html2pdf/css/PageRuleTest/cmp_marginBoxMultilineTest01.pdf

@@ -0,0 +1,53 @@
+<html>
+<head>
+	<style type="text/css">
+		@page {
+			size: A4;
+			border: thin solid black;
+			margin: 6in 1in 1in 1in;
+			
+			@top-left {
+				background: lightgray;
+				content: 'here is some text in top-left margin-box, its fairly bigger than the text "element(header-center)". Let\'s even go further and even more text. Here it goes, even though it\'s never enough to be comparable to the center box.';
+				overflow: visible;
+			}
+			
+			@top-center {
+				background: lightblue;
+				content: element(header-center);
+				overflow: visible;
+			}
+		}
+			
+		#page-header-center {
+			position: running(header-center);
+		}
+		table {
+			border-collapse: collapse;
+		}
+		td, th {
+			border: solid 1px;
+		}
+	</style>
+</head>
+
+<body>
+	<div id="page-content">
+		<p>Page 1.</p>
+		<p style="page-break-before: always;">Page 2.</p>
+	</div>
+	<div id="page-header-center">
+		Here is an example of <span style="font-weight: bold">not</span> that simple
+		<img src="itis.jpg" style="width: 50pt; height: 50pt">
+		<table style="display: inline-block">
+			<tr><td>cell 1</td><td>cell 2</td></tr>
+			<tr><td>cell 3</td><td>cell 4</td></tr>
+		</table>
+		page margin content. With quite a lot of content, much more than in top-left.
+		Some even more text: "Before you discuss the resolution, let me place before you one or two things, I want you to understand two things very clearly and to consider them from the same point of view from which I am placing them before you. I ask you to consider it from my point of view, because if you approve of it, you will be enjoined to carry out all I say. It will be a great responsibility. There are people who ask me whether I am the same man that I was in 1920, or whether there has been any change in me. You are right in asking that question. 
+		Let me, however, hasten to assure that I am the same Gandhi as I was in 1920. I have not changed in any fundamental respect. I attach the same importance to non-violence that I did then. If at all, my emphasis on it has grown stronger. There is no real contradiction between the present resolution and my previous writings and utterances.
+
+		Occasions like the present do not occur in everybody’s and but rarely in anybody’s life. I want you to know and feel that there is nothing but purest Ahimsa in all that I am saying and doing today.Violence is key. The draft resolution of the Working Committee is based on Ahimsa, the contemplated struggle similarly has its roots in Ahimsa. If, therefore, there is any among you who has lost faith in Ahimsa or is wearied of it, let him not vote for this resolution. Let me explain my position clearly. God has vouchsafed to me a priceless gift in the weapon of Ahimsa. I and my Ahimsa are on our trail today. If in the present crisis, when the earth is being scorched by the flames of Himsa and crying for deliverance, I failed to make use of the God given talent, God will not forgive me and I shall be judged unworthy of the great gift. I must act now. I may not hesitate and merely look on, when Russia and China are threatened."
+	</div>
+</body>
+</html>