←Select platform

GetFontName Method

Summary

gets the specific type of font used in the final document.

Syntax
C#
VB
Objective-C
C++
Java
public string GetFontName( 
   string languageName, 
   OcrDocumentFontType fontType 
) 
Function GetFontName( _ 
   ByVal languageName As String, _ 
   ByVal fontType As OcrDocumentFontType _ 
) As String 
- (nullable NSString *)fontNameForLanguage:(LTOcrLanguage)language  
                                  fontType:(LTOcrDocumentFontType)fontType 
                                     error:(NSError **)error 
public String getFontName(String languageName, OcrDocumentFontType fontType) 
String^ GetFontName(  
   String^ languageName, 
   OcrDocumentFontType fontType 
)  

Parameters

languageName
The language name. See remarks for more information.

fontType
The type of font to get.

Return Value

The font name.

Remarks

You can also use GetFontNames and SetFontNames to get or set the font names using an array.

Use GetFontName and SetFontName 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: description:

OcrDocumentFontType Description
OcrDocumentFontType.ProportionalSerif The font used with proportional serif characters
OcrDocumentFontType.ProportionalSansSerif The font used with proportional sans-serif characters
OcrDocumentFontType.FixedSerif The font used with monospaced serif characters
OcrDocumentFontType.FixedSansSerif The font used with monospaced sans-serif characters
OcrDocumentFontType.MICR 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.ZoneType member is OcrZoneType.Icr or OcrZoneType.Micrthen 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 equivalent of passing null (Nothing in VB).

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.

Example
C#
VB
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Ocr; 
using Leadtools.Forms.Common; 
using Leadtools.Document.Writer; 
using Leadtools.WinForms; 
 
public void DocumentFontsTest() 
{ 
   using (RasterCodecs codecs = new RasterCodecs()) 
   { 
      using (IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.LEAD, false)) 
      { 
         ocrEngine.Startup(codecs, null, null, LEAD_VARS.OcrLEADRuntimeDir); 
 
         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 OcrLEADRuntimeDir = @"C:\LEADTOOLS 20\Bin\Common\OcrLEADRuntime"; 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.Ocr 
Imports Leadtools.Forms 
Imports Leadtools.Document.Writer 
Imports Leadtools.WinForms 
 
Public Sub DocumentFontsTest() 
   Using codecs As New RasterCodecs() 
      Using ocrEngine As IOcrEngine = OcrEngineManager.CreateEngine(OcrEngineType.LEAD, False) 
         ocrEngine.Startup(codecs, Nothing, Nothing, LEAD_VARS.OcrLEADRuntimeDir) 
 
         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(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 OcrLEADRuntimeDir As String = "C:\LEADTOOLS 20\Bin\Common\OcrLEADRuntime" 
End Class 

Requirements

Target Platforms

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Ocr Assembly