Merge pull request #156 from ArtifexSoftware/pdf2csv-dev

Table detection & extraction support.

Author: jamie-lemon

Demo/Program.cs

@@ -9,12 +9,11 @@ static void Main(string[] args)
         {
             Document doc = new();
             Page page = doc.NewPage();
-            
+
             MuPDF.NET.TextWriter writer = new MuPDF.NET.TextWriter(page.Rect);
-            writer.FillTextbox(page.Rect, "text field I like you from Poland", new Font(fontName: "Kenpixel", fontFile: "kenpixel.ttf"), rtl: true);
+            writer.FillTextbox(page.Rect, "Hello World!", new Font(fontName: "helv"), rtl: true);
             writer.WriteText(page);
-
-            doc.Save("e:/res/test.pdf", pretty: 1);
+            doc.Save("test.pdf", pretty: 1);
         }
     }
 }

MuPDF.NET.Test/TableTest.cs

@@ -0,0 +1,63 @@
+using Microsoft.VisualStudio.TestPlatform.CommunicationUtilities.Resources;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace MuPDF.NET.Test
+{
+    public class TableTest
+    {
+        [Test]
+        public void BorderedTable()
+        {
+            Document doc = new Document("../../../resources/bordered-table.pdf");
+            Rect clip = new Rect(20, 100, 580, 300);
+            Page page = doc[0];
+            int cellCount = 0;
+
+            List<Table> tables = page.GetTables(clip:clip);
+            foreach (var table in tables)
+            {
+                List<List<string>> text = table.Extract();
+                foreach (var row in text)
+                {
+                    foreach (var cell in row)
+                    {
+                        cellCount++;
+                    }
+                }
+            }
+
+            doc.Close();
+
+            Assert.That(cellCount, Is.EqualTo(18));
+        }
+
+        [Test]
+        public void NonBorderedTable()
+        {
+            Document doc = new Document("../../../resources/non-bordered-table.pdf");
+            Page page = doc[0];
+            int cellCount = 0;
+
+            List<Table> tables = page.GetTables(vertical_strategy: "text", horizontal_strategy: "text");
+            foreach (var table in tables)
+            {
+                List<List<string>> text = table.Extract();
+                foreach (var row in text)
+                {
+                    foreach (var cell in row)
+                    {
+                        cellCount++;
+                    }
+                }
+            }
+
+            doc.Close();
+
+            Assert.That(cellCount, Is.EqualTo(54));
+        }
+    }
+}

MuPDF.NET.Test/resources/bordered-table.pdf

@@ -5,6 +5,7 @@
 using Microsoft.Maui;
 using mupdf;
 using static System.Net.Mime.MediaTypeNames;
+using static MuPDF.NET.Global;
 
 namespace MuPDF.NET
 {
@@ -4016,6 +4017,44 @@ public List<TextBlock> GetTextBlocks(
             return Utils.GetTextBlocks(this, clip, flags, textPage, sort);
         }
 
+        /// <summary>
+        /// Return the tables on a page
+        /// </summary>
+        /// <returns> A list of the tables. Each item contains the containing list of rows constructing with cell text</returns>
+        public List<Table> GetTables(
+            Rect clip = null,
+            string vertical_strategy = "lines",
+            string horizontal_strategy = "lines",
+            List<Edge> vertical_lines = null,
+            List<Edge> horizontal_lines = null,
+            float snap_tolerance = TableFlags.TABLE_DEFAULT_SNAP_TOLERANCE,
+            float snap_x_tolerance = 0.0f,
+            float snap_y_tolerance = 0.0f,
+            float join_tolerance = TableFlags.TABLE_DEFAULT_JOIN_TOLERANCE,
+            float join_x_tolerance = 0.0f,
+            float join_y_tolerance = 0.0f,
+            float edge_min_length = 3.0f,
+            float min_words_vertical = TableFlags.TABLE_DEFAULT_MIN_WORDS_VERTICAL,
+            float min_words_horizontal = TableFlags.TABLE_DEFAULT_MIN_WORDS_HORIZONTAL,
+            float intersection_tolerance = 3.0f,
+            float intersection_x_tolerance = 0.0f,
+            float intersection_y_tolerance = 0.0f,
+            float text_tolerance = 3.0f,
+            float text_x_tolerance = 3.0f,
+            float text_y_tolerance = 3.0f,
+            string strategy = null,  // offer abbreviation
+            List<Line> add_lines = null
+        )
+        {
+            return Utils.GetTables(this, clip,
+                vertical_strategy, horizontal_strategy, vertical_lines, horizontal_lines,
+                snap_tolerance, snap_x_tolerance, snap_y_tolerance,
+                join_tolerance, join_x_tolerance, join_y_tolerance,
+                edge_min_length, min_words_vertical, min_words_horizontal,
+                intersection_tolerance, intersection_x_tolerance, intersection_y_tolerance,
+                text_tolerance, text_x_tolerance, text_y_tolerance, strategy, add_lines);
+        }
+
         /// <summary>
         /// Run page through a device.
         /// </summary>