GetFontNames Method

C#
Visual Basic
WinRT C#
Objective-C
Java
WinRT JavaScript
C++

string[] GetFontNames( 
   string languageName
)

'Declaration
 
Function GetFontNames( _
   ByVal languageName As String _
) As String()

'Usage
 
Dim instance As IOcrDocumentManager
Dim languageName As String
Dim value() As String
 
value = instance.GetFontNames(languageName)

string[] GetFontNames( 
   string languageName
)

- (NSArray*)getFontNames:(NSString*)languageName
                   error:(NSError**)outError;

public String[] getFontNames(String languageName)

function Leadtools.Forms.Ocr.IOcrDocumentManager.GetFontNames( 
   languageName 
)

array<String^>^ GetFontNames( 
   String^ languageName
)

Parameters

languageName: The language name. See remarks for more information.

Return Value

An array of six string values that contains the font names used in the final document.

Use GetFontNames and SetFontNames to get/set the fonts used in the final recognized document (PDF, DOC, HTML, etc). The fonts will not be used when the final document format is text.

The OCR engine uses six different fonts when creating the final output document as follows. The following table shows the array index and the font description:

Index	Description
0	The font used with proportional serif characters
1	The font used with proportional sans-serif characters
2	The font used with monospaced serif characters
3	The font used with monospaced sans-serif characters
4	The font used with ICR (hand-written) characters
5	The font used with MICR (check font) characters

The OcrCharacter.FontStyle member of each character returned in IOcrPage.GetRecognizedCharacters determines which font to use with the character. If the zone is ICR or MICR (the OcrZone.RecognitionModule member is OcrZoneRecognitionModule.Micr, OcrZoneRecognitionModule.IcrNumeral or OcrZoneRecognitionModule.IcrCharacter), then the character will use the ICR or MICR fonts accordingly.

The OCR engine keeps a list of fonts for some languages, for example all the Latin languages currently use the same font. So passing languageName equals to "en" for English or "de" for German will change the default Latin fonts used in the final document. This is the equivalant of passing null (Nothing in Visual Basic).

If the OCR engine supports Asian languages, then each language will have its own font sets and you can get/set these fonts individually. Currently, the LEADTOOLS OCR toolkits supports individual fonts for Latin (null), Japanese (ja), Korean (ko), Chinese (zh-Hans and zh-Hant) and Korean (ko). The following table lists the default fonts used for each language:

Language

Fonts

Latin (all other languages) including languageName equals to null

Font	Value
Proportional Serif	Times New Roman
Proportional Sans-Serif	Arial
Monospace Serif	Courier New
Monospace Sans-Serif	Arial
ICR	Bookman Old Style
MICR	Arial Unicode MS

Japanese (languageName equals to "ja")

Font	Value
Proportional Serif	MS PMincho
Proportional Sans-Serif	MS PGothic
Monospace Serif	MS Gothic
Monospace Sans-Serif	SimSun
ICR	MS Gothic
MICR	SimSun

Chinese (languageName equals to "zh-Hans" or "zh-Hant")

Font	Value
Proportional Serif	SimSun
Proportional Sans-Serif	SimHei
Monospace Serif	Hei Simplified
Monospace Sans-Serif	SimSun
ICR	Hei Simplified
MICR	SimSun

Korean (languageName equals to "ko")

Font	Value
Proportional Serif	Gungsuh
Proportional Sans-Serif	Gulim
Monospace Serif	Dotum
Monospace Sans-Serif	Gungsuh
ICR	Dotum
MICR	Gungsuh

Note that changing the fonts is not recommended in most cases, the character position and size is calculated based on the default fonts even if the user changes the fonts before the recognition process. After the changing the fonts, it might be required to use IOcrPage.GetRecognizedCharacters and IOcrPage.SetRecognizedCharacters to further change the character position and font size to create the final output document.

C#
Visual Basic
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Copy Code

Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.Forms.Ocr
Imports Leadtools.Forms
Imports Leadtools.Forms.DocumentWriters
Imports Leadtools.WinForms

Private Shared Sub DocumentFontsTest()
   Using codecs As New RasterCodecs()
      Using ocrEngine As IOcrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, False)
         ocrEngine.Startup(codecs, Nothing, Nothing, LEAD_VARS.OcrAdvantageRuntimeDir)
         Dim ocrDocumentManager As IOcrDocumentManager = ocrEngine.DocumentManager

         Using ocrDocument As IOcrDocument = ocrEngine.DocumentManager.CreateDocument()
            ' Add a page to OCR
            Dim ocrPage As IOcrPage = ocrDocument.Pages.AddPage(Path.Combine(LEAD_VARS.ImagesDir, "Ocr1.tif"), Nothing)

            ocrPage.AutoZone(Nothing)
            ocrPage.Recognize(Nothing)

            ' Show the current fonts used to save default documents
            Console.WriteLine("Saving use the following fonts:")
            ShowFonts(ocrDocumentManager)
            ocrDocument.Save(Path.Combine(LEAD_VARS.ImagesDir, "Ocr1_DefaultFonts.pdf"), DocumentFormat.Pdf, Nothing)

            ' Now change the fonts to something else
            Dim newFonts() As String = ocrDocumentManager.GetFontNames(Nothing)

            ' Use Cambira for Proportional Serif font - instead of Times New Roman
            newFonts(0) = "Cambria"
            ' Use Calibri for Proportional Sans-serif font - instead of Arial
            newFonts(1) = "Calibri"
            ' Use Lucida Console for Monospace fonts (both Serif and Sans-serif)
            newFonts(2) = "Lucida Console"
            newFonts(3) = "Lucida Console"
            ' Leave the ICR and MICR fonts the same

            ocrDocumentManager.SetFontNames(Nothing, newFonts)

            ' Show the new fonts used to save default documents
            Console.WriteLine("Saving use the following fonts:")
            ShowFonts(ocrDocumentManager)
            ocrDocument.Save(Path.Combine(LEAD_VARS.ImagesDir, "Ocr1_CustomFonts.pdf"), DocumentFormat.Pdf, Nothing)
         End Using
      End Using
   End Using
End Sub

Private Shared Sub ShowFonts(ByVal ocrDocumentManager As IOcrDocumentManager)
   ' Get the default fonts
   ' The default fonts will be used for all Latin languages
   Dim fonts() As String = ocrDocumentManager.GetFontNames(Nothing)

   ' This should return an array of 6 items, as follows:
   Console.WriteLine("Proportional Serif font:        " + fonts(0))
   Console.WriteLine("Proportional Sans-serif font:   " + fonts(1))
   Console.WriteLine("Monospace Serif font:           " + fonts(2))
   Console.WriteLine("Monospace Sans-serif font:      " + fonts(3))
   Console.WriteLine("ICR (hand-written) font:        " + fonts(4))
   Console.WriteLine("MICR (Check) font:              " + fonts(5))
End Sub

Public NotInheritable Class LEAD_VARS
Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
Public Const OcrAdvantageRuntimeDir As String = "C:\LEADTOOLS 18\Bin\Common\OcrAdvantageRuntime"
End Class

using Leadtools;
using Leadtools.Codecs;
using Leadtools.Forms.Ocr;
using Leadtools.Forms;
using Leadtools.Forms.DocumentWriters;
using Leadtools.WinForms;

private static void DocumentFontsTest()
{
   using (RasterCodecs codecs = new RasterCodecs())
   {
      using (IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Advantage, false))
      {
         ocrEngine.Startup(codecs, null, null, LEAD_VARS.OcrAdvantageRuntimeDir);
         IOcrDocumentManager ocrDocumentManager = ocrEngine.DocumentManager;

         using (IOcrDocument ocrDocument = ocrEngine.DocumentManager.CreateDocument())
         {
            // Add a page to OCR
            IOcrPage ocrPage = ocrDocument.Pages.AddPage(Path.Combine(LEAD_VARS.ImagesDir, "Ocr1.tif"), null);

            ocrPage.AutoZone(null);
            ocrPage.Recognize(null);

            // Show the current fonts used to save default documents
            Console.WriteLine("Saving use the following fonts:");
            ShowFonts(ocrDocumentManager);
            ocrDocument.Save(Path.Combine(LEAD_VARS.ImagesDir, "Ocr1_DefaultFonts.pdf"), DocumentFormat.Pdf, null);

            // Now change the fonts to something else
            string[] newFonts = ocrDocumentManager.GetFontNames(null);

            // Use Cambira for Proportional Serif font - instead of Times New Roman
            newFonts[0] = "Cambria";
            // Use Calibri for Proportional Sans-serif font - instead of Arial
            newFonts[1] = "Calibri";
            // Use Lucida Console for Monospace fonts (both Serif and Sans-serif)
            newFonts[2] = "Lucida Console";
            newFonts[3] = "Lucida Console";
            // Leave the ICR and MICR fonts the same

            ocrDocumentManager.SetFontNames(null, newFonts);

            // Show the new fonts used to save default documents
            Console.WriteLine("Saving use the following fonts:");
            ShowFonts(ocrDocumentManager);
            ocrDocument.Save(Path.Combine(LEAD_VARS.ImagesDir, "Ocr1_CustomFonts.pdf"), DocumentFormat.Pdf, null);
         }
      }
   }
}

private static void ShowFonts(IOcrDocumentManager ocrDocumentManager)
{
   // Get the default fonts
   // The default fonts will be used for all Latin languages
   string[] fonts = ocrDocumentManager.GetFontNames(null);

   // This should return an array of 6 items, as follows:
   Console.WriteLine("Proportional Serif font:        " + fonts[0]);
   Console.WriteLine("Proportional Sans-serif font:   " + fonts[1]);
   Console.WriteLine("Monospace Serif font:           " + fonts[2]);
   Console.WriteLine("Monospace Sans-serif font:      " + fonts[3]);
   Console.WriteLine("ICR (hand-written) font:        " + fonts[4]);
   Console.WriteLine("MICR (Check) font:              " + fonts[5]);
}

static class LEAD_VARS
{
public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
public const string OcrAdvantageRuntimeDir = @"C:\LEADTOOLS 18\Bin\Common\OcrAdvantageRuntime";
}

Target Platforms

Reference

IOcrDocumentManager Interface
IOcrDocumentManager Members
IOcrPage.Recognize
IOcrDocument Interface
IOcrDocument.Save
IOcrDocument.SaveXml
IOcrEngine Interface
OcrEngineManager Class
OcrEngineType Enumeration
Programming with the LEADTOOLS .NET OCR