Load(Stream) Method

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

void Load( 
   Stream stream
)

'Declaration
 
Overloads Sub Load( _
   ByVal stream As Stream _
)

'Usage
 
Dim instance As IOcrSettingManager
Dim stream As Stream
 
instance.Load(stream)

void Load( 
   Stream stream
)

function Leadtools.Forms.Ocr.IOcrSettingManager.Load(Stream)( 
   stream 
)

void Load( 
   Stream^ stream
)

Parameters

stream: The stream to read the settings from.

Once you set up the OCR engine, you can re-use these settings by saving the engine state into memory or to an XML file on disk. Later, reload these settings and use them in the same or a different instance of IOcrEngine.

The following table lists all the states loaded from the XML file. After the load operation completes, some or all of the settings below will be changed.

Part	Members
IOcrSettingManager (accessed through IOcrEngine.SettingManager	All the settings as obtained through IOcrSettingManager.GetSettingNames
IOcrLanguageManager (accessed through IOcrEngine.LanguageManager	The value of IOcrLanguageManager.GetEnabledLanguages
IOcrSpellCheckManager (accessed through IOcrEngine.SpellCheckManager	The values of IOcrSpellCheckManager.SpellCheckEngine and IOcrSpellCheckManager.SpellLanguage.
IOcrDocumentManager (accessed through IOcrEngine.DocumentManager	The values of the IOcrDocumentManager.RejectionSymbol and IOcrDocumentManager.MissingSymbol.

You can save the settings to a .NET stream using Save(Stream), you can load and save the settings to a disk file using Load(String) and Save(String).

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

Copy Code

Public Sub LoadSettingsExample2()
      Dim userDictionaryFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "MyDictionary.ud")
      ' Stream to save the settings to
      Dim ms As New MemoryStream()

      ' Create an instance of the engine
      Using ocrEngine As IOcrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Plus, False)
         ' Start the engine using default parameters
         ocrEngine.Startup(Nothing, Nothing, Nothing, Nothing)

         Dim settingManager As IOcrSettingManager = ocrEngine.SettingManager

         ' Enable English and German character sets
         ocrEngine.LanguageManager.EnableLanguages(New String() {"en", "de"})

         ' Set the spell checking options
         ocrEngine.SpellCheckManager.SpellCheckEngine = OcrSpellCheckEngine.None
         ocrEngine.SpellCheckManager.SpellLanguage = "en"

         ' Change some settings
         settingManager.SetValue("SaveDocument.FormatLevel", "Part")
         settingManager.SetBooleanValue("SaveDocument.Document.TextInBoxes", False)
         settingManager.SetIntegerValue("SaveDocument.Document.Margin.Left", 2400)
         settingManager.SetStringValue("SaveDocument.Character.ProportionalSansSerifFontName", "MyFont")
         settingManager.SetStringValue("SaveDocument.Mark.BeforeMissingCharacterSeparator", "MyMark")
         settingManager.SetValue("SaveDocument.Mark.BeginOfLineSeparator", Nothing)
         ' Change an enum using an integer
         settingManager.SetEnumValue("SaveDocument.Mark.SuspectedCharacterColor", 7)
         ' Change an enum using strings
         settingManager.SetEnumValue("SaveDocument.Mark.RejectionCharacterColor", "Blue, Green, Red")

         ' Save the settings
         settingManager.Save(ms)

         ' Note: calling Dispose will also automatically shutdown the engine if it has been started
         ocrEngine.Shutdown()
      End Using

      ' Reset the stream position to the beginning
      ms.Position = 0

      ' Now create another instance of the engine, load the settings and make sure they are the same
      Using ocrEngine As IOcrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Plus, False)
         ' Start the engine using default parameters
         ocrEngine.Startup(Nothing, Nothing, Nothing, Nothing)

         Dim settingManager As IOcrSettingManager = ocrEngine.SettingManager

         ' Load the settings
         settingManager.Load(ms)

         ' Check the character set
         Dim languages() As String = ocrEngine.LanguageManager.GetEnabledLanguages()
         Debug.Assert(languages(0) = "en" AndAlso languages(1) = "de")

         ' Check the spell checking options
         Debug.Assert(ocrEngine.SpellCheckManager.SpellCheckEngine = OcrSpellCheckEngine.Native)
         Debug.Assert(ocrEngine.SpellCheckManager.SpellLanguage = "en")

         ' Check the settings
         Debug.Assert(settingManager.GetValue("SaveDocument.FormatLevel") = "Part")
         Debug.Assert(settingManager.GetBooleanValue("SaveDocument.Document.TextInBoxes") = False)
         Debug.Assert(settingManager.GetIntegerValue("SaveDocument.Document.Margin.Left") = 2400)
         Debug.Assert(settingManager.GetStringValue("SaveDocument.Character.ProportionalSansSerifFontName") = "MyFont")
         Debug.Assert(settingManager.GetStringValue("SaveDocument.Mark.BeforeMissingCharacterSeparator") = "MyMark")
         Debug.Assert(settingManager.GetValue("SaveDocument.Mark.BeginOfLineSeparator") = Nothing)
         Debug.Assert(settingManager.GetEnumValue("SaveDocument.Mark.SuspectedCharacterColor") = 7)
         Debug.Assert(settingManager.GetEnumValueAsString("SaveDocument.Mark.RejectionCharacterColor") = "Blue, Green, Red")

         ' Note: calling Dispose will also automatically shutdown the engine if it has been started
         ocrEngine.Shutdown()
      End Using
   End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class

public void LoadSettingsExample2()
   {
      string userDictionaryFileName = Path.Combine(LEAD_VARS.ImagesDir, "MyDictionary.ud");
      // Stream to save the settings to
      MemoryStream ms = new MemoryStream();

      // Create an instance of the engine
      using(IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Plus, false))
      {
         // Start the engine using default parameters
         ocrEngine.Startup(null, null, null, null);

         IOcrSettingManager settingManager = ocrEngine.SettingManager;

         // Enable English and German character sets
         ocrEngine.LanguageManager.EnableLanguages(new string[] { "en", "de" });

         // Set the spell checking options
         ocrEngine.SpellCheckManager.SpellCheckEngine = OcrSpellCheckEngine.None;
         ocrEngine.SpellCheckManager.SpellLanguage = "en";

         // Change some settings
         settingManager.SetValue("SaveDocument.FormatLevel", "Part");
         settingManager.SetBooleanValue("SaveDocument.Document.TextInBoxes", false);
         settingManager.SetIntegerValue("SaveDocument.Document.Margin.Left", 2400);
         settingManager.SetStringValue("SaveDocument.Character.ProportionalSansSerifFontName", "MyFont");
         settingManager.SetStringValue("SaveDocument.Mark.BeforeMissingCharacterSeparator", "MyMark");
         settingManager.SetValue("SaveDocument.Mark.BeginOfLineSeparator", null);
         // Change an enum using an integer
         settingManager.SetEnumValue("SaveDocument.Mark.SuspectedCharacterColor", 7);
         // Change an enum using strings
         settingManager.SetEnumValue("SaveDocument.Mark.RejectionCharacterColor", "Blue, Green, Red");

         // Save the settings
         settingManager.Save(ms);

         // Note: calling Dispose will also automatically shutdown the engine if it has been started
         ocrEngine.Shutdown();
      }

      // Reset the stream position to the beginning
      ms.Position = 0;

      // Now create another instance of the engine, load the settings and make sure they are the same
      using(IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.Plus, false))
      {
         // Start the engine using default parameters
         ocrEngine.Startup(null, null, null, null);

         IOcrSettingManager settingManager = ocrEngine.SettingManager;

         // Load the settings
         settingManager.Load(ms);

         // Check the character set
         string[] languages = ocrEngine.LanguageManager.GetEnabledLanguages();
         Debug.Assert(languages[0] == "en" && languages[1] == "de");

         // Check the spell checking options
         Debug.Assert(ocrEngine.SpellCheckManager.SpellCheckEngine == OcrSpellCheckEngine.Native);
         Debug.Assert(ocrEngine.SpellCheckManager.SpellLanguage == "en");

         // Check the settings
         Debug.Assert(settingManager.GetValue("SaveDocument.FormatLevel") == "Part");
         Debug.Assert(settingManager.GetBooleanValue("SaveDocument.Document.TextInBoxes") == false);
         Debug.Assert(settingManager.GetIntegerValue("SaveDocument.Document.Margin.Left") == 2400);
         Debug.Assert(settingManager.GetStringValue("SaveDocument.Character.ProportionalSansSerifFontName") == "MyFont");
         Debug.Assert(settingManager.GetStringValue("SaveDocument.Mark.BeforeMissingCharacterSeparator") == "MyMark");
         Debug.Assert(settingManager.GetValue("SaveDocument.Mark.BeginOfLineSeparator") == null);
         Debug.Assert(settingManager.GetEnumValue("SaveDocument.Mark.SuspectedCharacterColor") == 7);
         Debug.Assert(settingManager.GetEnumValueAsString("SaveDocument.Mark.RejectionCharacterColor") == "Blue, Green, Red");

         // Note: calling Dispose will also automatically shutdown the engine if it has been started
         ocrEngine.Shutdown();
      }
   }

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

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

IOcrSettingManager Interface
IOcrSettingManager Members
Overload List
Programming with the LEADTOOLS .NET OCR