Refactor text renderers sequence word wrapping logic

Extract separate TextSequenceWordWrapping class.
For special scripts wrap processing apply EPS to occupied area during relayout.
LineRenderer: merge and rename moveForward mode booleans and methods.
LineRenderer: merge updateSpecialScriptLayoutResults and updateTextRendererLayoutResults to updateTextSequenceLayoutResults.
TextRenderer: set containsPossibleBreak always, not only in case of HTML_MODE rendering mode.
TextRenderer: set containsPossibleBreak in case of width overflow only if forcePartialSplitOnFirstChar.

DEVSIX-1438

Author: yulian-gaponenko

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

@@ -61,9 +61,9 @@ public class TextLayoutResult extends MinMaxWidthLayoutResult {
 
     protected boolean containsPossibleBreak = false;
 
-    protected boolean lineStartsWithWhiteSpace = false;
+    protected boolean startsWithSplitCharacterWhiteSpace = false;
 
-    protected boolean lineEndsWithSplitCharacterOrWhiteSpace = false;
+    protected boolean endsWithSplitCharacter = false;
 
     protected float leftMinWidth;
 
@@ -163,14 +163,15 @@ public TextLayoutResult setContainsPossibleBreak(boolean containsPossibleBreak)
     }
 
     /**
-     * Sets {@link #isLineStartsWithWhiteSpace()}.
+     * Sets {@link #isStartsWithSplitCharacterWhiteSpace()}.
      *
-     * @param lineStartsWithWhiteSpace indicates if TextRenderer#line starts with a whitespace.
+     * @param startsWithSplitCharacterWhiteSpace indicates if TextRenderer#line starts with a split character that is
+     *                                           also a whitespace.
      * @return {@link com.itextpdf.layout.layout.TextLayoutResult this layout result} the setting was applied on.
-     * @see #isLineStartsWithWhiteSpace
+     * @see #isStartsWithSplitCharacterWhiteSpace
      */
-    public TextLayoutResult setLineStartsWithWhiteSpace(boolean lineStartsWithWhiteSpace) {
-        this.lineStartsWithWhiteSpace = lineStartsWithWhiteSpace;
+    public TextLayoutResult setStartsWithSplitCharacterWhiteSpace(boolean startsWithSplitCharacterWhiteSpace) {
+        this.startsWithSplitCharacterWhiteSpace = startsWithSplitCharacterWhiteSpace;
         return this;
     }
 
@@ -179,19 +180,19 @@ public TextLayoutResult setLineStartsWithWhiteSpace(boolean lineStartsWithWhiteS
      *
      * @return true if TextRenderer#line starts with a whitespace.
      */
-    public boolean isLineStartsWithWhiteSpace() {
-        return lineStartsWithWhiteSpace;
+    public boolean isStartsWithSplitCharacterWhiteSpace() {
+        return startsWithSplitCharacterWhiteSpace;
     }
 
     /**
-     * Sets {@link #isLineEndsWithSplitCharacterOrWhiteSpace()}.
+     * Sets {@link #isEndsWithSplitCharacter()}.
      *
-     * @param lineEndsWithSplitCharacterOrWhiteSpace indicates if TextRenderer#line ends with a splitCharacter.
+     * @param endsWithSplitCharacter indicates if TextRenderer#line ends with a splitCharacter.
      * @return {@link com.itextpdf.layout.layout.TextLayoutResult this layout result} the setting was applied on.
-     * @see #isLineEndsWithSplitCharacterOrWhiteSpace
+     * @see #isEndsWithSplitCharacter
      */
-    public TextLayoutResult setLineEndsWithSplitCharacterOrWhiteSpace(boolean lineEndsWithSplitCharacterOrWhiteSpace) {
-        this.lineEndsWithSplitCharacterOrWhiteSpace = lineEndsWithSplitCharacterOrWhiteSpace;
+    public TextLayoutResult setEndsWithSplitCharacter(boolean endsWithSplitCharacter) {
+        this.endsWithSplitCharacter = endsWithSplitCharacter;
         return this;
     }
 
@@ -201,8 +202,8 @@ public TextLayoutResult setLineEndsWithSplitCharacterOrWhiteSpace(boolean lineEn
      * @return true if TextRenderer#line ends with a splitCharacter.
      * @see com.itextpdf.layout.splitting.ISplitCharacters
      */
-    public boolean isLineEndsWithSplitCharacterOrWhiteSpace() {
-        return lineEndsWithSplitCharacterOrWhiteSpace;
+    public boolean isEndsWithSplitCharacter() {
+        return endsWithSplitCharacter;
     }
 
     /**

layout/src/main/java/com/itextpdf/layout/renderer/AbstractRenderer.java

@@ -124,6 +124,30 @@ public abstract class AbstractRenderer implements IRenderer {
      */
     protected static final float INF = 1e6f;
 
+    /**
+     * The common ordering index of top side in arrays of four elements which define top, right, bottom,
+     * left sides values (e.g. margins, borders, paddings).
+     */
+    static final int TOP_SIDE = 0;
+
+    /**
+     * The common ordering index of right side in arrays of four elements which define top, right, bottom,
+     * left sides values (e.g. margins, borders, paddings).
+     */
+    static final int RIGHT_SIDE = 1;
+
+    /**
+     * The common ordering index of bottom side in arrays of four elements which define top, right, bottom,
+     * left sides values (e.g. margins, borders, paddings).
+     */
+    static final int BOTTOM_SIDE = 2;
+
+    /**
+     * The common ordering index of left side in arrays of four elements which define top, right, bottom,
+     * left sides values (e.g. margins, borders, paddings).
+     */
+    static final int LEFT_SIDE = 3;
+
     // TODO linkedList?
     protected List<IRenderer> childRenderers = new ArrayList<>();
     protected List<IRenderer> positionedRenderers = new ArrayList<>();
@@ -1682,23 +1706,27 @@ protected boolean allowLastYLineRecursiveExtraction() {
      * @return a {@link Rectangle border box} of the renderer
      */
     protected Rectangle applyMargins(Rectangle rect, UnitValue[] margins, boolean reverse) {
-        if (!margins[0].isPointValue()) {
+        if (!margins[TOP_SIDE].isPointValue()) {
             Logger logger = LoggerFactory.getLogger(AbstractRenderer.class);
             logger.error(MessageFormatUtil.format(LogMessageConstant.PROPERTY_IN_PERCENTS_NOT_SUPPORTED, Property.MARGIN_TOP));
         }
-        if (!margins[1].isPointValue()) {
+        if (!margins[RIGHT_SIDE].isPointValue()) {
             Logger logger = LoggerFactory.getLogger(AbstractRenderer.class);
             logger.error(MessageFormatUtil.format(LogMessageConstant.PROPERTY_IN_PERCENTS_NOT_SUPPORTED, Property.MARGIN_RIGHT));
         }
-        if (!margins[2].isPointValue()) {
+        if (!margins[BOTTOM_SIDE].isPointValue()) {
             Logger logger = LoggerFactory.getLogger(AbstractRenderer.class);
             logger.error(MessageFormatUtil.format(LogMessageConstant.PROPERTY_IN_PERCENTS_NOT_SUPPORTED, Property.MARGIN_BOTTOM));
         }
-        if (!margins[3].isPointValue()) {
+        if (!margins[LEFT_SIDE].isPointValue()) {
             Logger logger = LoggerFactory.getLogger(AbstractRenderer.class);
             logger.error(MessageFormatUtil.format(LogMessageConstant.PROPERTY_IN_PERCENTS_NOT_SUPPORTED, Property.MARGIN_LEFT));
         }
-        return rect.applyMargins(margins[0].getValue(), margins[1].getValue(), margins[2].getValue(), margins[3].getValue(), reverse);
+        return rect.applyMargins(
+                margins[TOP_SIDE].getValue(),
+                margins[RIGHT_SIDE].getValue(),
+                margins[BOTTOM_SIDE].getValue(),
+                margins[LEFT_SIDE].getValue(), reverse);
     }
 
     /**