Add support for function execution

Add support for extraction of images with a separation color space

DEVSIX-3538

Author: glenn.volckaert

kernel/src/main/java/com/itextpdf/kernel/exceptions/KernelExceptionMessageConstant.java

@@ -202,10 +202,46 @@ public final class KernelExceptionMessageConstant {
     public static final String INVALID_CROSS_REFERENCE_ENTRY_IN_THIS_XREF_SUBSECTION = "Invalid cross reference entry "
             + "in this xref subsection.";
     public static final String INVALID_INDIRECT_REFERENCE = "Invalid indirect reference {0}.";
+
+    public static final String INVALID_INPUT_FOR_TYPE_2_FUNCTION =
+            "Invalid input value for PDF Type 2 Function, value should be a single number.";
+    public static final String INVALID_INPUT_FOR_TYPE_3_FUNCTION =
+            "Invalid input value for PDF Type 3 Function, value should be a single number.";
     public static final String INVALID_MEDIA_BOX_VALUE = "Tne media box object has incorrect values.";
     public static final String INVALID_PAGE_STRUCTURE = "Invalid page structure {0}.";
     public static final String INVALID_PAGE_STRUCTURE_PAGES_MUST_BE_PDF_DICTIONARY = "Invalid page structure. /Pages "
             + "must be PdfDictionary.";
+    public static final String INVALID_TYPE_2_FUNCTION_DOMAIN =
+            "Invalid PDF Type 2 Function object, \"Domain\" array shall consist of 2 numbers.";
+    public static final String INVALID_TYPE_2_FUNCTION_N =
+            "Invalid PDF Type 2 Function object, \"N\" field should be existed and must be a number.";
+    public static final String INVALID_TYPE_2_FUNCTION_N_NEGATIVE =
+            "Invalid PDF Type 2 Function object, when \"N\" is negative, values of \"Domain\" shall "
+            + "not allow zero as input value.";
+    public static final String INVALID_TYPE_2_FUNCTION_N_NOT_INTEGER =
+            "Invalid PDF Type 2 Function object, when \"N\" is not an integer, values of \"Domain\" shall "
+            + "define the input value as non-negative.";
+    public static final String INVALID_TYPE_2_FUNCTION_OUTPUT_SIZE =
+            "Invalid PDF Type 2 Function object, if present the size of \"C0\", \"C1\" and half "
+                    + "\"Range\" shall be equal.";
+    public static final String INVALID_TYPE_3_FUNCTION_BOUNDS =
+            "Invalid PDF Type 3 Function object, \"Bounds\" elements shall be in order of increasing value, and "
+            + "each value shall be within the domain defined by \"Domain\".";
+    public static final String INVALID_TYPE_3_FUNCTION_DOMAIN =
+            "Invalid PDF Type 3 Function object, \"Domain\" array shall consist of 2 numbers.";
+    public static final String INVALID_TYPE_3_FUNCTION_FUNCTIONS_OUTPUT =
+            "Invalid PDF Type 3 Function object, the output dimensionality of all functions shall be the same, "
+            + "and compatible with the value of \"Range\".";
+    public static final String INVALID_TYPE_3_FUNCTION_FUNCTIONS_INPUT =
+            "Invalid PDF Type 3 Function object, all functions shall have 1 input value.";
+    public static final String INVALID_TYPE_3_FUNCTION_NULL_BOUNDS =
+            "Invalid PDF Type 3 Function object, \"Bounds\" array should be exist and it size should corresponds "
+            + "to the size of \"Functions\" array.";
+    public static final String INVALID_TYPE_3_FUNCTION_NULL_ENCODE =
+            "Invalid PDF Type 3 Function object, \"Encode\" array should be exist and it size should be 2 times "
+            + "more than \"Functions\" array size.";
+    public static final String INVALID_TYPE_3_FUNCTION_NULL_FUNCTIONS =
+            "Invalid PDF Type 3 Function object, \"Functions\" array should be exist and can't be empty.";
     public static final String INVALID_RANGE_ARRAY = "Invalid range array.";
     public static final String INVALID_OFFSET_FOR_THIS_OBJECT = "Invalid offset for object {0}.";
     public static final String INVALID_XREF_STREAM = "Invalid xref stream.";
@@ -355,6 +391,30 @@ public final class KernelExceptionMessageConstant {
             + "boolean for this collection sort dictionary.";
     public static final String QUAD_POINT_ARRAY_LENGTH_IS_NOT_A_MULTIPLE_OF_EIGHT = "The QuadPoint Array length is "
             + "not a multiple of 8.";
+    public static final String FUNCTION_NOT_SET = "The output size depends on the functions, but no function is"
+            + " set yet.";
+    public static final String INVALID_LENGTH = "The offset + length must be lower than or equal to the length of "
+            + "the byte array.";
+    public static final String INVALID_LENGTH_FOR_WORDSIZE = "The length must be a multiple of {0}.";
+    public static final String TYPE4_EXECUTION_NOT_SUPPORTED =
+            "Type 4 functions are not yet supported for separation color image extraction.";
+    public static final String GET_IMAGEBYTES_FOR_SEPARATION_COLOR_ONLY_SUPPORTS_RGB =
+            "Only RGB alternate color spaces are currently supported for extracting separation color images";
+    public static final String INPUT_NOT_MULTIPLE_OF_DOMAIN_SIZE = "The size of the input array must be a multiple of "
+            + "the domain size";
+    public static final String INPUT_NOT_MULTIPLE_OF_RANGE_SIZE = "The size of the input array must be a multiple of "
+            + "the range size";
+
+    public static final String PDF_TYPE0_FUNCTION_NOT_NULL_PARAMETERS = "Domain, range and size must be not null";
+    public static final String PDF_TYPE0_FUNCTION_INVALID_ORDER = "Order must be equal to 1 or 3";
+    public static final String PDF_TYPE0_FUNCTION_INVALID_DOMAIN = "Invalid domain for PDF function of type 0";
+    public static final String PDF_TYPE0_FUNCTION_INVALID_RANGE = "Invalid encode array for PDF function of type 0";
+    public static final String PDF_TYPE0_FUNCTION_INVALID_SIZE = "Invalid size array for PDF function of type 0";
+    public static final String PDF_TYPE0_FUNCTION_INVALID_ENCODE = "Invalid encode array for PDF function of type 0";
+    public static final String PDF_TYPE0_FUNCTION_INVALID_DECODE = "Invalid decode array for PDF function of type 0";
+    public static final String PDF_TYPE0_FUNCTION_INVALID_SAMPLES = "Invalid samples array for PDF function of type 0";
+    public static final String PDF_TYPE0_FUNCTION_BITS_PER_SAMPLE_INVALID_VALUE =
+            "bitsPerSample value must be from {1, 2, 4, 8, 12, 16, 24, 32}";
 
     private KernelExceptionMessageConstant(){}
 }

kernel/src/main/java/com/itextpdf/kernel/pdf/colorspace/PdfSpecialCs.java

@@ -52,6 +52,8 @@ This file is part of the iText (R) project.
 import com.itextpdf.kernel.pdf.PdfNumber;
 import com.itextpdf.kernel.pdf.PdfObject;
 import com.itextpdf.kernel.pdf.PdfString;
+import com.itextpdf.kernel.pdf.function.PdfFunctionFactory;
+import com.itextpdf.kernel.pdf.function.IPdfFunction;
 import com.itextpdf.kernel.pdf.function.PdfFunction;
 
 import java.util.Arrays;
@@ -144,6 +146,15 @@ public PdfName getName() {
             return ((PdfArray)getPdfObject()).getAsName(1);
         }
 
+        /**
+         * Gets the function to calulate a separation color value to an alternative colorspace.
+         *
+         * @return a {@link IPdfFunction} to perform the calculation
+         */
+        public IPdfFunction getTintTransformation() {
+            return PdfFunctionFactory.create(((PdfArray)getPdfObject()).get(3));
+        }
+
         private static PdfArray getSeparationCsArray(PdfName name, PdfObject alternateSpace, PdfObject tintTransform) {
             PdfArray separation = new PdfArray();
             separation.add(PdfName.Separation);