Different Ways to Load the Engine Object

There are three ways to load the Engine object in ABBYY FlexiCapture 12 SDK. Each of the loading methods has its own specifics affecting the use of the object in different circumstances. The first two methods are most suitable for use in interactive applications which are not intended for simultaneous processing of multiple requests. The third method is most suitable for server solutions.

Loading FCEngine.dll manually and working with “naked” interfaces

This is the standard method to load the Engine object that was also used in old versions of ABBYY FlexiCapture Engine. To get a reference to the Engine object, you should do the following:

This object loading method is described in detail in the Tutorial, Step 1: Load FlexiCapture SDK.

Advantages Limitations
  • Results in maximum performance.
  • Easy access to any licensing type.
  • Does not require registration of FCEngine.dll.

Loading the Engine object by means of COM into the current process

The Engine is loaded as an in-process server into the same process where the application is running. The Engine object is loaded using the InprocLoader object, which implements the IEngineLoader interface.

Please note that you must keep the reference to the loader object until you finish working with the Engine. You can then call the Unload method of the loader object to deinitialize the Engine, and then destroy the loader object.

Advantages Limitations
  • All ABBYY FlexiCapture SDK objects are completely thread-safe and can be created and used in different threads.
  • When working from the Мain STA apartment, performance is the same as when working with the naked interfaces. When accessing from different threads, some marshalling losses may occur, which are negligible in most scenarios.
  • Registration of FCEngine.dll is required when installing the final application on an end user's computer.

C# code

Note:

To register FCEngine.dll when installing your application on an end-user computer, use the following command line:

regsvr32 /s /n /i:"<path to the Inc folder>" "<path to FCEngine.dll>"
    

Loading the Engine object by means of COM into a separate process

The Engine is loaded as an out-of-process server into a separate process. The Engine object is loaded by means of the OutprocLoader object, which implements a IEngineLoader interface.

Please note that you must keep the reference to the loader object until you finish working with the Engine. You can then call the Unload method of the loader object to deinitialize the Engine, and then destroy the loader object.

Advantages Limitations
  • All ABBYY FlexiCapture SDK objects are completely thread-safe. Each instance of the Engine runs in a separate process parallel to the others.
  • There are some small marshalling losses.
  • Registration of FCEngine.dll is required when installing the final application on an end user's computer.
  • When working under accounts with limited permissions, the necessary permissions must be granted.
  • It is impossible to access a page image as HBITMAP without marshalling.

C# code

Notes:

  • Account permissions can be set up using the DCOM Config utility (either type DCOMCNFG in the command line, or select Control Panel > Administrative Tools > Component Services). In the console tree, locate the Component Services > Computers > My Computer > DCOM Config folder, right-click ABBYY FlexiCapture 12 SDK Loader (Local Server), and click Properties. A dialog box will open. Click the Security tab. Under Launch Permissions, click Customize, and then click Edit to specify the accounts that can launch the application.

    Note that on a 64-bit operating system the registered DCOM-application is available in the 32-bit MMC console, which can be run using the following command line:

    "mmc comexp.msc /32"
    
  • To register FCEngine.dll when installing your application on an end-user computer, use the following command line:
regsvr32 /s /n /i:"<path to the Inc folder>" "<path to FCEngine.dll>"
    
  • We recommend that you use a Network license both for debugging your server application and for running it.

Additionally you can manage the priority of work processes and control whether their parent process is alive and terminate if it is not. Use the IWorkProcessControl interface.

Comparison table

The table below sums up the characteristics of the three loading methods:

Characteristics Naked interfaces In-process server Out-of-process server
Works without proxy (no marshalling losses) Yes There are limitations No
Works in multi-threaded applications There are limitations Yes Yes
Parallel running processes are possible (for server solutions) No No Yes
No registration of FCEngine.dll required Yes No No
No running permissions must be set up Yes Yes No
Objects can be created using the new operator. Works from scripts. No Yes Yes
Ability to access a page image as HBITMAP Yes Yes No
Works in a separate process (fail-proof, recycling) No No Yes

Using from a 64-bit process

If you are going to use ABBYY FlexiCapture SDK from a 64-bit process (e.g. ASP.NET on 64-bit servers), we recommend that you use the way of loading FlexiCapture SDK into a work process.

See also

Using ABBYY FlexiCapture SDK in Multi-Threaded Server Applications

15.08.2023 13:19:30

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.