ArcGIS Pro 3.8 API Reference Guide
ArcGIS.Core.OCR Namespace / OCRBlock Class
Members Example

In This Topic
    OCRBlock Class
    In This Topic
    Represents a region of text within a document image. Used within the components of an OCRTSVOutput instance.
    Object Model
    OCRBlock ClassOCRBoundingBox Class
    Syntax
    public sealed class OCRBlock 
    Public NotInheritable Class OCRBlock 
    Remarks
    The TSV output hierarchy is as follows: - OCRPage -> OCRBlock -> OCRParagraph -> OCRLine -> OCRWord.

    That is, an OCRBlock contains a set of OCRParagraphs and a set of OCRBlocks are in an OCRPage.

    Example
    Extract TSV output from a document
    {
      string docFileName = "c:\\MyData\\MyDocument.bmp";
    
      var ocrOptions = new OCROptions(docFileName);
      ocrOptions.OutputType = OCROutputType.TSV;
    
      // set a specific page if necessary
      // (if not set, then all pages are scanned)
      // ocrOptions.Page = pageIdx;
    
      // set the resolution if necessary
      // ocrOptions.Resolution = 400;
    
      var output = await OCRManager.Instance.ExtractFromDocumentAsync(ocrOptions);
      if (output is OCRTSVOutput ocr_tsvOutput)
      {
        // process the tsv output
        foreach (var page in ocr_tsvOutput.Pages)
        {
          foreach (var block in page.Blocks)
          {
            foreach (var para in block.Paragraphs)
            {
              foreach (var line in para.Lines)
              {
                foreach (var word in line.Words)
                {
                  var content = word.Content;
                  var confidence = word.Confidence;
    
                  // process content according to confidence
                }
              }
            }
          }
        }
      }
    }
    Get text from TSVOutput (simple)
    {
      string text = "";
    
      var flowDocument = new FlowDocument();
    
      foreach (var page in tsvOutput.Pages)
      {
        List<Paragraph> pageParagraphs = new();
    
        foreach (var block in page.Blocks)
        {
          foreach (var paragraph in block.Paragraphs)
          {
            foreach (var line in paragraph.Lines)
            {
              string lineWords = string.Join(" ", line.Words.Select(w => w.Content));
              pageParagraphs.Add(new Paragraph(new Span(new Run(lineWords))));
            }
          }
        }
    
        flowDocument.Blocks.AddRange(pageParagraphs);
        flowDocument.Blocks.Add(new Paragraph(new Span(new Run(Environment.NewLine))));
      }
    
      var startPointer = flowDocument?.ContentStart;
      var endPointer = flowDocument?.ContentEnd;
    
      if (startPointer != null && endPointer != null)
      {
        text = new TextRange(startPointer, endPointer).Text;
      }
    }
    Inheritance Hierarchy

    System.Object
       ArcGIS.Core.OCR.OCRBlock

    Requirements

    Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

    ArcGIS Pro version: 3.8 or higher.
    See Also