Add grid flow property

DEVSIX-8323

Author: Dmitry Radchuk

kernel/src/main/java/com/itextpdf/kernel/pdf/canvas/parser/data/ImageRenderInfo.java

@@ -165,7 +165,7 @@ public List<CanvasTag> getCanvasTagHierarchy() {
     }
 
     /**
-     * Gets the marked-content identifier associated with this {@link ImageRenderInfo} instance
+     * Gets the marked-content identifier associated with this {@link ImageRenderInfo} instance.
      *
      * @return associated marked-content identifier or -1 in case content is unmarked
      */
@@ -179,23 +179,23 @@ public int getMcid() {
     }
 
     /**
-     * Checks if the text belongs to a marked content sequence
+     * Checks if this {@link ImageRenderInfo} instance is associated with a marked content sequence
      * with a given mcid.
      *
      * @param mcid a marked content id
-     * @return true if the text is marked with this id
+     * @return {@code true} if the image is marked with this id, {@code false} otherwise
      */
     public boolean hasMcid(int mcid) {
         return hasMcid(mcid, false);
     }
 
     /**
-     * Checks if the text belongs to a marked content sequence
+     * Checks if this {@link ImageRenderInfo} instance is associated with a marked content sequence
      * with a given mcid.
      *
      * @param mcid                     a marked content id
      * @param checkTheTopmostLevelOnly indicates whether to check the topmost level of marked content stack only
-     * @return true if the text is marked with this id
+     * @return {@code true} if this {@link ImageRenderInfo} instance is marked with this id, {@code false} otherwise
      */
     public boolean hasMcid(int mcid, boolean checkTheTopmostLevelOnly) {
         if (checkTheTopmostLevelOnly) {

kernel/src/main/java/com/itextpdf/kernel/pdf/canvas/parser/data/PathRenderInfo.java

@@ -257,23 +257,23 @@ public int getMcid() {
     }
 
     /**
-     * Checks if the text belongs to a marked content sequence
+     * Checks if this {@link PathRenderInfo} instance belongs to a marked content sequence
      * with a given mcid.
      *
      * @param mcid a marked content id
-     * @return {@code true} if the text is marked with this id
+     * @return {@code true} if this {@link PathRenderInfo} instance is marked with this id, {@code false} otherwise
      */
     public boolean hasMcid(int mcid) {
         return hasMcid(mcid, false);
     }
 
     /**
-     * Checks if the text belongs to a marked content sequence
+     * Checks if this {@link PathRenderInfo} instance belongs to a marked content sequence
      * with a given mcid.
      *
      * @param mcid                     a marked content id
      * @param checkTheTopmostLevelOnly indicates whether to check the topmost level of marked content stack only
-     * @return {@code true} if the text is marked with this id
+     * @return {@code true} if this {@link PathRenderInfo} instance is marked with this id, {@code false} otherwise
      */
     public boolean hasMcid(int mcid, boolean checkTheTopmostLevelOnly) {
         if (checkTheTopmostLevelOnly) {

kernel/src/main/java/com/itextpdf/kernel/pdf/canvas/parser/data/TextRenderInfo.java

@@ -135,23 +135,23 @@ public Matrix getTextMatrix() {
     }
 
     /**
-     * Checks if the text belongs to a marked content sequence
+     * Checks if this {@link TextRenderInfo} instance belongs to a marked content sequence
      * with a given mcid.
      *
      * @param mcid a marked content id
-     * @return true if the text is marked with this id
+     * @return {@code true} if this {@link TextRenderInfo} instance is marked with this id, {@code false} otherwise
      */
     public boolean hasMcid(int mcid) {
         return hasMcid(mcid, false);
     }
 
     /**
-     * Checks if the text belongs to a marked content sequence
+     * Checks if this {@link TextRenderInfo} instance belongs to a marked content sequence
      * with a given mcid.
      *
      * @param mcid                     a marked content id
      * @param checkTheTopmostLevelOnly indicates whether to check the topmost level of marked content stack only
-     * @return true if the text is marked with this id
+     * @return {@code true} if this {@link TextRenderInfo} instance is marked with this id, {@code false} otherwise
      */
     public boolean hasMcid(int mcid, boolean checkTheTopmostLevelOnly) {
         if (checkTheTopmostLevelOnly) {

layout/src/main/java/com/itextpdf/layout/properties/GridFlow.java

@@ -0,0 +1,24 @@
+package com.itextpdf.layout.properties;
+
+/**
+ * A specialized enum containing potential property values for
+ * {@link com.itextpdf.layout.properties.Property#GRID_FLOW}.
+ */
+public enum GridFlow {
+    /**
+     * Defines row flow from left to right of a grid.
+     */
+    ROW,
+    /**
+     * Defines column flow from top to bottom of a grid.
+     */
+    COLUMN,
+    /**
+     * Same as {@code ROW} but uses dense algorithm for cell placement.
+     */
+    ROW_DENSE,
+    /**
+     * Same as {@code COLUMN} but uses dense algorithm for cell placement.
+     */
+    COLUMN_DENSE
+}

layout/src/main/java/com/itextpdf/layout/properties/Property.java

@@ -127,6 +127,7 @@ public final class Property {
     public static final int GRID_TEMPLATE_ROWS = 146;
     public static final int GRID_AUTO_ROWS = 151;
     public static final int GRID_AUTO_COLUMNS = 152;
+    public static final int GRID_FLOW = 154;
     public static final int HEIGHT = 27;
     public static final int HORIZONTAL_ALIGNMENT = 28;
     public static final int HORIZONTAL_BORDER_SPACING = 115;
@@ -233,7 +234,7 @@ public final class Property {
      * related to textual operations. Indicates whether or not this type of property is inheritable.
      */
     private static final boolean[] INHERITED_PROPERTIES;
-    private static final int MAX_INHERITED_PROPERTY_ID = 153;
+    private static final int MAX_INHERITED_PROPERTY_ID = 154;
 
     static {
         INHERITED_PROPERTIES = new boolean[MAX_INHERITED_PROPERTY_ID + 1];