| Platform(s) | +Assemblies | + +
|---|---|
| +Windows Forms, WPF, ASP.NET, and ASP.NET MVC + | +
+
|
+
| +.NET Standard 2.0 + | +
+
|
+
| +.NET 8/.NET 9/.NET 10 + | +
+
|
+
| Platform(s) | -NuGet Package | - -
|---|---|
|
-Windows Forms -Console Application (Targeting .NET Framework) - |
--{{'[Syncfusion.Pdf.OCR.WinForms.nupkg](https://www.nuget.org/packages/Syncfusion.Pdf.OCR.WinForms)'| markdownify }} - | -
| -WPF - | --{{'[Syncfusion.Pdf.OCR.Wpf.nupkg](https://www.nuget.org/packages/Syncfusion.Pdf.OCR.Wpf)'| markdownify }} - | -
| -ASP.NET - | --{{'[Syncfusion.Pdf.OCR.AspNet.nupkg](https://www.nuget.org/packages/Syncfusion.Pdf.OCR.AspNet)'| markdownify }} - | -
| -ASP.NET MVC5 - | --{{'[Syncfusion.Pdf.OCR.AspNet.Mvc5.nupkg](https://www.nuget.org/packages/Syncfusion.Pdf.OCR.AspNet.Mvc5)'| markdownify }} - | -
|
-ASP.NET Core (Targeting NET Core) -Console Application (Targeting .NET Core) -Blazor - |
--{{'[Syncfusion.PDF.OCR.Net.Core](https://www.nuget.org/packages/Syncfusion.PDF.OCR.Net.Core)'| markdownify }} - | -
| Platform(s) | -Assemblies | - -
|---|---|
| -Windows Forms, WPF, ASP.NET, and ASP.NET MVC - | -
-
|
-
| -.NET Standard 2.0 - | -
-
|
-
| -.NET 8/.NET 9/.NET 10 - | -
-
|
-
| Platform(s) | +NuGet Package | + +
|---|---|
|
+Windows Forms +Console Application (Targeting .NET Framework) + |
++{{'[Syncfusion.Pdf.OCR.WinForms.nupkg](https://www.nuget.org/packages/Syncfusion.Pdf.OCR.WinForms)'| markdownify }} + | +
| +WPF + | ++{{'[Syncfusion.Pdf.OCR.Wpf.nupkg](https://www.nuget.org/packages/Syncfusion.Pdf.OCR.Wpf)'| markdownify }} + | +
| +ASP.NET + | ++{{'[Syncfusion.Pdf.OCR.AspNet.nupkg](https://www.nuget.org/packages/Syncfusion.Pdf.OCR.AspNet)'| markdownify }} + | +
| +ASP.NET MVC5 + | ++{{'[Syncfusion.Pdf.OCR.AspNet.Mvc5.nupkg](https://www.nuget.org/packages/Syncfusion.Pdf.OCR.AspNet.Mvc5)'| markdownify }} + | +
|
+ASP.NET Core (Targeting NET Core) +Console Application (Targeting .NET Core) +Blazor + |
++{{'[Syncfusion.PDF.OCR.Net.Core](https://www.nuget.org/packages/Syncfusion.PDF.OCR.Net.Core)'| markdownify }} + | +
| Exception | +Tesseract has not been initialized exception. | +
|---|---|
| Reason + | +The exception may occur if the tesseract binaries and tessdata files are unavailable on the provided path. + | +
| Solution1 | +
+Set proper tesseract binaries and tessdata folder with all files and inner folders. The tessdata folder name is case-sensitive and should not change.
+ +{% tabs %} +{% highlight C# tabtitle="C# [Cross-platform]" %} + +//TesseractBinaries - path of the folder tesseract binaries. +OCRProcessor processor = new OCRProcessor(@"TesseractBinaries/"); + +//TessData - path of the folder containing the language pack +processor.PerformOCR(lDoc, @"TessData/"); + +{% endhighlight %} +{% endtabs %} + |
+
| Solution2 | ++Ensure that your data file version is 3.02 since the OCR processor is built with the Tesseract version 3.02. + | +
| Exception | +Exception has been thrown by the target of an invocation. | +
|---|---|
| Reason + | +If the tesseract binaries are not in the required structure. + | +
| Solution | +
+To resolve this exception, ensure the tesseract binaries are in the following structure.
+ +The tessdata and tesseract binaries folder are automatically added to the bin folder of the application. The assemblies should be in the following structure. + +1.bin\Debug\net7.0\runtimes\win-x64\native\leptonica-1.80.0.dll,libSyncfusionTesseract.dll +2.bin\Debug\net7.0\runtimes\win-x86\native\leptonica-1.80.0.dll,libSyncfusionTesseract.dll + |
+
| Reason 1 + | +An exception may occur due to missing or mismatched assemblies of the Tesseract binaries and Tesseract data from the OCR processor. + | +
| Reason 2 + | +An exception may occur due to the VC++ 2015 redistributable files missing in the machine where the OCR processor takes place. + | +
| Solution | +
+Install the VC++ 2015 redistributable files in your machine to overcome an exception. So, please select both file and install it.
+ +Refer to the following screenshot: + + 
++Please find the download link Visual C++ 2015 Redistributable file, +Visual C++ 2015 Redistributable file + |
+
| Exception | +Can't be opened because the developer's identity cannot be confirmed. | +
|---|---|
| Reason + | +This error may occur during the initial loading of the OCR processor in Mac environments. + | +
| Solution | ++To resolve this issue, refer this link for more details. + + | +
| Exception | +The OCR processor doesn't process languages other than English. | +
|---|---|
| Reason + | +This issue may occur if the input image has other languages. The language and tessdata are unavailable for those languages. + | +
| Solution | +
+The essential® PDF supports all the languages the Tesseract engine supports in the OCR processor.
+The dictionary packs for the languages can be downloaded from the following online location: +https://code.google.com/p/tesseract-ocr/downloads/list + +It is also mandatory to change the corresponding language code in the OCRProcessor.Settings.Language property. +For example, to perform the optical character recognition in German, the property should be set as +"processor.Settings.Language = "deu";" + |
+
| Exception | +OCR processing works correctly in a .NET Framework WinForms application but fails to produce any output when the same logic is used in a .NET Core WinForms application. The application runs without throwing any exceptions, but no text is recognized from the PDF or image. | +
|---|---|
| Reason + | +The root cause is a platform-specific dependency mismatch. The Tesseract binaries required for .NET Framework are different from those required for .NET Core. Even if the binaries are present in the output folder, using Framework-specific binaries in a .NET Core project causes the OCR process to fail silently. + | +
| Solution | +
+Ensure your .NET Core project uses the correct Tesseract binaries built for .NET Core: +1.Install the Correct NuGet Package: +Reference the Syncfusion.PDF.OCR.Net.Core NuGet package in your .NET Core project. +2.Verify the Tesseract Binaries: +Confirm that the correct binaries are copied to your output directory: +a.Extract the Syncfusion.PDF.OCR.Net.Core NuGet package. +b.Copy the appropriate runtimes folder from the extracted package into your project's output directory (e.g., bin/Debug/net6.0-windows/). + + |
+
| Issue | +Text does not recognize properly when performing OCR on a PDF document with low-quality images | +
|---|---|
| Reason + | +The presence of low quality images in the input PDF document may be the cause of this issue. + | +
| Solution | +
+By using the best tessdata, we can improve the OCR results. For more information, please refer to the links below. + +https://github.com/tesseract-ocr/tessdata_best +{{'**Note:**'| markdownify }}For better performance, kindly use the fast tessdata which is mentioned in below link, https://github.com/tesseract-ocr/tessdata_fast + |
+
| Issue + | +Syncfusion.Pdf.PdfException: Exception has been thrown by the target of an invocation" in the Mac machine. + | +
|---|---|
| Reason + | +The problem occurs due to a mismatch in the dependency package versions on your Mac machine. + | +
| Solution + | +To resolve this problem, you should install and utilize Tesseract 5 on your Mac machine. Refer to the following steps for installing Tesseract 5 and integrating it into an OCR processing workflow.
+ +1.Execute the following command to install Tesseract 5. + +{% tabs %} +{% highlight C# %} + +brew install tesseract + +{% endhighlight %} +{% endtabs %} + +If the "brew" is not installed on your machine, you can install it using the following command. + +{% tabs %} +{% highlight C# %} + +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" + +{% endhighlight %} +{% endtabs %} + +2.Once Tesseract 5 is successfully installed, you can configure the path to the latest binaries by copying the location of the Tesseract folder and setting it as the Tesseract binaries path when setting up the OCR processor. Refer to the example code below: + +{% tabs %} +{% highlight C# %} + +//Initialize the OCR processor by providing the path of tesseract binaries. +using (OCRProcessor processor = new OCRProcessor("/opt/homebrew/Cellar/tesseract/5.3.2/lib")) + +{% endhighlight %} +{% endtabs %} + + +3.Add the TessDataPath from bin folder. Refer to the example code below: + +{% tabs %} +{% highlight C# tabtitle="C# [Cross-platform]" %} + +using (OCRProcessor processor = new OCRProcessor("/opt/homebrew/Cellar/tesseract/5.3.2/lib")) +{ + FileStream fileStream = new FileStream("../../../Input.pdf", FileMode.Open, FileAccess.Read); + //Load a PDF document. + PdfLoadedDocument lDoc = new PdfLoadedDocument(fileStream); + //Set OCR language to process. + processor.Settings.Language = Languages.English; + //Process OCR by providing the PDF document. + processor.TessDataPath = "runtimes/tessdata"; + processor.PerformOCR(lDoc); + //Create file stream. + using (FileStream outputFileStream = new FileStream("Output.pdf", FileMode.Create, FileAccess.ReadWrite)) + { + //Save the PDF document to file stream. + lDoc.Save(outputFileStream); + } + //Close the document. + lDoc.Close(true); +} + +{% endhighlight %} +{% endtabs %} + |
+
| Issue | +Method PerformOCR() causes problem and ignores the tesseract files under WSL | +
|---|---|
| Reason + | +Tesseract binaries in WSL are missing. + | +
| Solution | +To resolve this problem, you should install and utilize Leptonica and Tesseract on your machine. Refer to the following steps for installing Leptonica and Tesseract,
+ +1. Install the leptonica. + +{% tabs %} +{% highlight C# %} + +sudo apt-get install libleptonica-dev + +{% endhighlight %} +{% endtabs %} + + 
++2.Install the tesseract. + +{% tabs %} +{% highlight C# %} + +sudo apt-get install tesseract-ocr-eng + +{% endhighlight %} +{% endtabs %} + + 
++3. Copy the binaries (liblept.so and libtesseract.so) to the missing files exception folder in the project location. + +{% tabs %} +{% highlight C# %} + +cp /usr/lib/x86_64-linux-gnu/liblept.so /home/syncfusion/linuxdockersample/linuxdockersample/bin/Debug/net7.0/liblept1753.so + +{% endhighlight %} +{% endtabs %} + +{% tabs %} +{% highlight C# %} + +cp /usr/lib/x86_64-linux-gnu/libtesseract.so.4 /home/syncfusion/linuxdockersample/linuxdockersample/bin/Debug/net7.0/libSyncfusionTesseract.so + +{% endhighlight %} +{% endtabs %} + + |
+
| Issue | +Syncfusion.Pdf.PdfException: Exception has been thrown by the target of an invocation" in the Linux machine. | +
|---|---|
| Reason + | +The problem occurs due to the missing prerequisites dependencies on your Linux machine. + | +
| Solution | +
+To resolve this problem, you should install all required dependencies in your Linux machine. Refer to the following steps to installing the missing dependencies.
+
+Step 1: Execute the following command in terminal window to check dependencies are installed properly.
+{% tabs %}
+{% highlight C# %}
+
+ldd liblept1753.so
+ldd libSyncfusionTesseract.so
+
+{% endhighlight %}
+{% endtabs %}
+Run the following commands in terminal +Step 1: +{% tabs %} +{% highlight C# %} + +sudo apt-get install libleptonica-dev libjpeg62 + +{% endhighlight %} +{% endtabs %} +Step 2: +{% tabs %} +{% highlight C# %} + +ln -s /usr/lib/x86_64-linux-gnu/libtiff.so.6 /usr/lib/x86_64-linux-gnu/libtiff.so.5 + +{% endhighlight %} +{% endtabs %} +Step 3: +{% tabs %} +{% highlight C# %} + +ln -s /lib/x86_64-linux-gnu/libdl.so.2 /usr/lib/x86_64-linux-gnu/libdl.so + +{% endhighlight %} +{% endtabs %} + |
+
| Exception | +OCR not working on Docker net 8.0: Exception has been thrown by target of an invocation. | +
|---|---|
| Reason + | +The reported issue occurs due to the missing prerequisite dependencies packages in the Docker container in .NET 8.0 version. + | +
| Solution | ++ We can resolve the reported issue by installing the tesseract required dependencies by using Docker file. Please refer the below commands. + +{% tabs %} + +{% highlight C# %} + +FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base + +RUN apt-get update && \ + +apt-get install -yq --no-install-recommends \ + +libgdiplus libc6-dev libleptonica-dev libjpeg62 + +RUN ln -s /usr/lib/x86_64-linux-gnu/libtiff.so.6 /usr/lib/x86_64-linux-gnu/libtiff.so.5 + +RUN ln -s /lib/x86_64-linux-gnu/libdl.so.2 /usr/lib/x86_64-linux-gnu/libdl.so + + + +USER app + +WORKDIR /app + +EXPOSE 8080 + +EXPOSE 8081 + +{% endhighlight %} + +{% endtabs %} + + | +
| Tessdata path + | ++Tessdata default path reference is common for all platform. You can find the tessdata in below path in your project. + +"bin\Debug\net6.0\runtimes\tessdata" + | +
|---|---|
| Tesseract Path | +
+Tesseract binaries are different based on the OS platform and bit version . You can find the tesseract path in below path in your project.
+ +Windows Platform: +bin\Debug\net6.0\runtimes\win-x86\native (or) bin\Debug\net6.0\runtimes\win-x64\native + +Linux: + +bin\Debug\net6.0\runtimes\linux\native + + +Mac: + +bin\Debug\net6.0.\runtimes\osx\native + |
+
| Exception | +System.NullReferenceException in Azure linux VM | +
|---|---|
| Reason + | +The problem occurs while extracting the Image from PDF without a Skiasharp dependency in a Linux environment. + | +
| Solution | +
+Installing the following Skiasharp NuGet for the Linux environment will resolve the System.NullReferenceException while extracting the Images in Linux. +Please find the NuGet link below, +NuGet: https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux.NoDependencies/2.88.6 + |
+
| Exception | +The application failed to load Tesseract OCR DLLs when hosted on IIS, resulting in the error: +Could not find a part of the path 'C:\inetpub\wwwroot\VizarCore\x64'. | +
|---|---|
| Reason + | + * IIS couldn't load the required Tesseract and Leptonica DLLs because some system components were missing. +* The Visual C++ Redistributables for VS2015-VS2022 (x86 and x64) were not installed. +* IIS on a 64-bit server needs both redistributables to load native libraries correctly. +* The application's folder paths and permissions were not properly set up for OCR binaries. + |
+
| Solution | +
+Installed Required Redistributables +Installed both VC_redist.x86 and VC_redist.x64 for VS2015-VS2022 on the IIS server. +Updated Server +Applied all available Windows updates (including cumulative and Defender updates) to ensure system stability. +Configured Application Paths +Set default paths for OCR binaries: +* C:\inetpub\wwwroot\myapp\Tesseractbinaries +* C:\inetpub\wwwroot\myapp\tessdata +Set Proper Permissions +Ensured IIS_IUSRS group has Read & Execute and List folder contents permissions on the above directories. +Observed Delayed Activation +OCR functionality did not activate immediately-likely due to IIS caching or delayed DLL loading-but began working shortly after configuration. + |
+
| Exception | +Syncfusion.Pdf.PdfException: Exception has been thrown by the target of an invocation while deploying ASP .NET Core applications in Azure App Service Linux Docker Container | +
|---|---|
| Reason + | +when publishing the ASP.NET Core application to the Azure App Service Linux Docker container, only the .so, .dylib, and .dll files are copied from the runtimes folder to the publish folder. Files in other formats are not copied to the publish folder. + | +
| Solution | +
+To resolve this problem, the tessdata folder path must be explicitly set relative to the project directory under runtimes/tessdata. The publish folder can be located in your project directory at this path: obj\Docker\publish.
+ +Please refer to the screenshot below: + + 
++ |
+
| Exception | ++'Image stream is null' exception while performing OCR in AKS (Linux)) | +
|---|---|
| Reason + | +This issue typically arises due to insufficient file system permissions for the temporary directory used during OCR processing in an AKS (Azure Kubernetes Service) Linux environment. + | +
| Solution | +
+To ensure your Kubernetes workloads have appropriate read, write, and execute permissions on temporary directories, consider the following solutions:
+ +1.Use an EmptyDir Volume for a Writable Temp Directory: +Update your deployment YAML to include a writable temporary directory with `emptyDir`: + +{% tabs %} + +{% highlight C# %} + +spec: + containers: + - name: your-container + image: your-image + volumeMounts: + - name: temp-volume + mountPath: /tmp # or /app/tmp if your app uses that + volumes: + - name: temp-volume + emptyDir: {} + +{% endhighlight %} + +{% endtabs %} + +This ensures each pod has its own writable temporary directory, ideal for short-lived, non-persistent data + +2.Grant Write Access Using SecurityContext: + +To ensure your container has permission to write to mounted volumes, add: + +{% tabs %} + +{% highlight C# %} + +securityContext: + runAsUser: 1000 # safer than root + fsGroup: 2000 # gives access to mounted files + +{% endhighlight %} + +{% endtabs %} + +N> Avoid setting `runAsUser: 0` in production, as running containers as root poses a security risk. + +3.Use Persistent Writable Storage (Azure Files Example): + +If persistent storage is required, configure Azure Files: + +{% tabs %} + +{% highlight C# %} + +volumes: + - name: azurefile + azureFile: + secretName: azure-secret + shareName: aksshare + readOnly: false + +{% endhighlight %} + +{% endtabs %} + +This setup allows your container to write to a persistent Azure File Share, making it suitable for use cases that require long-term file storage. + +By applying these configuration changes, you can ensure that your AKS workloads have the necessary write access for operations, while maintaining security and flexibility. + + |
+
| Query + | ++Is Microsoft.mshtml required when using the OCRProcessor in the .NET Framework? + | +
|---|---|
| Solution | ++Yes, the Microsoft.mshtml component is required when using the OCRProcessor in .NET Framework applications. We internally rely on this package to parse the hOCR results, which are delivered in HTML format. Because of this, Microsoft.mshtml is necessary for .NET Framework projects that use the OCRProcessor. + | +
| -{{'Syncfusion.SmartDataExtractor.WinForms.nupkg'| markdownify }} +{{'[Syncfusion.SmartDataExtractor.WinForms.nupkg](https://www.nuget.org/packages/Syncfusion.SmartDataExtractor.WinForms/)'| markdownify }} |
| -{{'Syncfusion.SmartDataExtractor.Wpf.nupkg'| markdownify }} +{{'[Syncfusion.SmartDataExtractor.Wpf.nupkg](https://www.nuget.org/packages/Syncfusion.SmartDataExtractor.Wpf)'| markdownify }} |
| -{{'Syncfusion.SmartDataExtractor.AspNet.Mvc5.nupkg'| markdownify }} +{{'[Syncfusion.SmartDataExtractor.AspNet.Mvc5.nupkg](https://www.nuget.org/packages/Syncfusion.SmartDataExtractor.AspNet.Mvc5)'| markdownify }} |
| -{{'Syncfusion.SmartDataExtractor.Net.Core.nupkg'| markdownify }} +{{'[Syncfusion.SmartDataExtractor.Net.Core.nupkg](https://www.nuget.org/packages/Syncfusion.SmartDataExtractor.Net.Core)'| markdownify }} |
| -{{'Syncfusion.SmartDataExtractor.NET.nupkg'| markdownify }} +{{'[Syncfusion.SmartDataExtractor.NET.nupkg](https://www.nuget.org/packages/Syncfusion.SmartDataExtractor.NET)'| markdownify }} |
| Attribute | +Type | +Description | +
|---|---|---|
| Type | +String | +Defines the kind of object detected on the page (Table). | +
| Bounds | +Array of Floats | +The bounding box coordinates [X, Y, Width, Height] representing the object's position and size on the page. | +
| Content | +String | +Extracted text or value associated with the object (if applicable). | +
| Confidence | +Float | +Confidence score (0–1) indicating the accuracy of detection. | +
| TableFormat (only for tables) | +Object | +Metadata about table detection, including detection score and label. | +
| Rows (only for tables) | +Array | +Collection of row objects that make up the table. | +
| Attribute | +Type | +Description | +
|---|---|---|
| Type | +String | +Row type (e.g., tr). | +
| Rect | +Array | +Bounding box coordinates for the row. | +
| Cells | +Array | +Collection of cell objects contained in the row. | +
| Attribute | +Type | +Description | +
|---|---|---|
| Type | +String | +Cell type (e.g., td). | +
| Rect | +Array | +Bounding box coordinates for the cell. | +
| RowSpan / ColSpan | +Integer | +Number of rows or columns spanned by the cell. | +
| RowStart / ColStart | +Integer | +Starting row and column index of the cell. | +
| Content.Value | +String | +Text content inside the cell. | +
| Attribute | +Type | +Description | +
|---|---|---|
| X / Y | +Float | +Coordinates of the form field on the page. | +
| Width / Height | +Float | +Dimensions of the form field. | +
| Type | +Integer | +Numeric identifier for the form field type (e.g., 0 = TextArea, 1 = Checkbox, 2 = Radio Button, 3 = Signature). | +
| Confidence | +Float | +Confidence score (0–1) indicating detection accuracy. | +
| Exception | +ONNX files are missing | +
|---|---|
| Reason | +The required ONNX model files are not copied into the application’s build output. | +
| Solution | +
+ Ensure that the runtimes folder is copied properly to the bin folder of the application from the NuGet package location.
+ + Please refer to the below screenshot, + + 
+ + Note: If you publish your application, ensure the runtimes/models folder and ONNX files are included in the publish output. + |
+
| Exception | +
+ 1. System.TypeInitializationException + 2. FileNotFoundException (Microsoft.ML.ONNXRuntime) + |
+
|---|---|
| Reason | ++ The required Microsoft.ML.ONNXRuntime NuGet package is not installed in your project. + SmartDataExtractor depends on this package and its required assemblies to function properly. + | +
| Solution | +
+ Install the NuGet package
+ Microsoft.ML.ONNXRuntime (Version 1.18.0) manually in your sample/project.
+ This package is required for SmartDataExtractor across .NET Framework projects. + |
+
| Exception | +Microsoft.ML.ONNXRuntime.ONNXRuntimeException | +
|---|---|
| Reason | +The required native runtime library (ONNXRuntime.dll) is missing from your application's bin folder. | +
| Solution | +
+ In your MVC project file (.csproj), add the following build target to copy the native DLL from the NuGet package folder to the bin folder:
+ +{% tabs %} +{% highlight C# %} + + |
+
| -{{'Syncfusion.SmartTableExtractor.WinForms.nupkg'| markdownify }} +{{'[Syncfusion.SmartTableExtractor.WinForms.nupkg](https://www.nuget.org/packages/Syncfusion.SmartTableExtractor.WinForms/)'| markdownify }} |
| -{{'Syncfusion.SmartTableExtractor.Wpf.nupkg'| markdownify }} +{{'[Syncfusion.SmartTableExtractor.Wpf.nupkg](https://www.nuget.org/packages/Syncfusion.SmartTableExtractor.Wpf)'| markdownify }} |
| -{{'Syncfusion.SmartTableExtractor.AspNet.Mvc5.nupkg'| markdownify }} +{{'[Syncfusion.SmartTableExtractor.AspNet.Mvc5.nupkg](https://www.nuget.org/packages/Syncfusion.SmartTableExtractor.AspNet.Mvc5)'| markdownify }} |
| -{{'Syncfusion.SmartTableExtractor.Net.Core.nupkg'| markdownify }} +{{'[Syncfusion.SmartTableExtractor.Net.Core.nupkg](https://www.nuget.org/packages/Syncfusion.SmartTableExtractor.Net.Core)'| markdownify }} |
| -{{'Syncfusion.SmartTableExtractor.NET.nupkg'| markdownify }} +{{'[Syncfusion.SmartTableExtractor.NET.nupkg](https://www.nuget.org/packages/Syncfusion.SmartTableExtractor.NET)'| markdownify }} |
| Attribute | +Type | +Description | +
|---|---|---|
| Type | +String | +Defines the kind of object detected on the page (Table). | +
| Bounds | +Array of Floats | +The bounding box coordinates [X, Y, Width, Height] representing the object's position and size on the page. | +
| Content | +String | +Extracted text or value associated with the object (if applicable). | +
| Confidence | +Float | +Confidence score (0–1) indicating the accuracy of detection. | +
| TableFormat (only for tables) | +Object | +Metadata about table detection, including detection score and label. | +
| Rows (only for tables) | +Array | +Collection of row objects that make up the table. | +
| Attribute | +Type | +Description | +
|---|---|---|
| Type | +String | +Row type (e.g., tr). | +
| Rect | +Array | +Bounding box coordinates for the row. | +
| Cells | +Array | +Collection of cell objects contained in the row. | +
| Attribute | +Type | +Description | +
|---|---|---|
| Type | +String | +Cell type (e.g., td). | +
| Rect | +Array | +Bounding box coordinates for the cell. | +
| RowSpan / ColSpan | +Integer | +Number of rows or columns spanned by the cell. | +
| RowStart / ColStart | +Integer | +Starting row and column index of the cell. | +
| Content.Value | +String | +Text content inside the cell. | +
| Exception | +ONNX files are missing | +
|---|---|
| Reason | +The required ONNX model files are not copied into the application’s build output. | +
| Solution | +
+ Ensure that the runtimes folder is copied properly to the bin folder of the application from the NuGet package location.
+ + Please refer to the below screenshot, + + 
+ + Note: If you publish your application, ensure the runtimes/models folder and ONNX files are included in the publish output. + |
+
| Exception | +
+ 1. System.TypeInitializationException + 2. FileNotFoundException (Microsoft.ML.ONNXRuntime) + |
+
|---|---|
| Reason | ++ The required Microsoft.ML.ONNXRuntime NuGet package is not installed in your project. + SmartTableExtractor depends on this package and its required assemblies to function properly. + | +
| Solution | +
+ Install the NuGet package
+ Microsoft.ML.ONNXRuntime (Version 1.18.0) manually in your sample/project.
+ This package is required for SmartTableExtractor across .NET Framework projects. + |
+
| Exception + | +Microsoft.ML.ONNXRuntime.ONNXRuntimeException + | +
|---|---|
| Reason + | +The required native runtime library (ONNXRuntime.dll) is missing from your application's bin folder. + | +
| Solution + | + In your MVC project file (.csproj), add the following build target to copy the native DLL from the NuGet package folder to the bin folder: +{% tabs %} +{% highlight C# %} + + |
+