Skip to content

Architecture and concepts

OCR SDK distribution components​

Details of the OCR SDK components are as follows.

HANCOM OCRSDK
├─assets (OCRSDK resource directory)
│      Hancom.{yy}.{mm}.{dd}.cpu.imr
│
├─bin64 (OCRSDK binary directory)
│  │  libArgoSDK.dll
│  │  libArgoSDK.lib
│  │  libArgoCommonStructure.dll
│  │  ArgoSDKLicense.dll
│  │  HncSentinelRMS.dll
│  │  pthreadVC3.dll
│  │  libcrypto-3-x64.dll
│  │  (License)
│  │  Hancom.{mode}.license
│  │  SampleWindowsMain.exe
│  │
│  └─libs
│      └─CPU
│          └─modulelibs
│                  {module}.dll
│                  {module}.set
│                   ...
│
├─include (OCRSDK header file directory)
│      HOCR_SDK_CPU.h
│      HOCR_SDK_COMMON.h
│
├─notice (OCRSDK open-source license notice directory)
│      Hancom OCR SDK_{version}_Notice.txt

assets​

This directory contains the resource files used by Hancom OCR SDK. You can initialize Hancom OCR SDK using an encrypted integrated module resource file (*.imr). The modules currently available in Hancom OCR SDK are as follows:

  • TEXT_DETECTION: Detects text regions in an image.
  • TEXT_RECOGNITION: Depends on TEXT_DETECTION and recognizes text in the target regions of an image.

File list​

  • Hancom.{yy}.{mm}.{dd}.cpu.imr: An encrypted resource file that consolidates the modules available in Hancom OCR SDK into a single file. Used when initializing the SDK in HOCR_SDK_CPU_CreateFromImrModelFile.

bin64​

This directory contains the binary files used by Hancom OCR SDK.

  • Be sure to check the Installing Libtorch document so that libtorch can be referenced.
  • Be sure to check the License activation document and place the license file (License) you received in the same path as the *.license file in this directory.

File list​

  • libArgoSDK.dll: The core runtime DLL of Hancom OCR SDK. Must be included at runtime.
  • libArgoSDK.lib: The import library required to implicitly link the above core DLL during project build.
  • libArgoCommonStructure.dll: A common DLL that depends on libArgoSDK.dll. Must be located in the same path as libArgoSDK.dll.
  • ArgoSDKLicense.dll: A verification DLL that depends on libArgoSDK.dll. Must be located in the same path as libArgoSDK.dll.
  • HncSentinelRMS.dll: A verification DLL that depends on ArgoSDKLicense.dll. Must be located in the same path as ArgoSDKLicense.dll.
  • pthreadVC3.dll: An open-source DLL for multi-threaded processing that depends on libArgoSDK.dll. Must be located in the same path as libArgoSDK.dll.
  • libcrypto-3-x64.dll: An open-source DLL for cryptography and security processing that depends on ArgoSDKLicense.dll. Must be located in the same path as ArgoSDKLicense.dll.
  • License: The activation license file. It is not included when you first download Hancom OCR SDK; you will receive it through License activation and place it in this directory. This license file is used for the first-stage verification when initializing Hancom OCR. Do not change the file name, and it must be placed in the same path as the runtime license below.
  • Hancom.{mode}.license: The runtime license file. Unlike the License obtained through License activation, this file is included when you first download Hancom OCR SDK. Pass this runtime license file as an argument when calling the Hancom OCR SDK initialization API; it is used for secondary verification and resource validation. ( Example filename: Hancom.trial.license )
  • SampleWindowsMain.exe: The sample program for Hancom OCR SDK. You can interactively test the main features of Hancom OCR SDK via a CLI. Microsoft Visual C++ 2015–2022 Redistributable is required to run the sample.

bin64\libs\CPU\modulelibs​

This directory contains the module binary files used by Hancom OCR SDK. When calling the Hancom OCR SDK initialization API, you must pass the path of this directory as an argument. For the list of provided modules, see assets in this document.

File list​

  • {module}.dll: The runtime DLL referenced by each module. ( Example filename: libArgoTextRecognition.dll )
  • {module}.set: The encrypted configuration file for each module. It is verified through the runtime license. It must be paired with the runtime DLL of the same name. ( Example filename: libArgoTextRecognition.dll )

include​

This directory contains the header files where the public API functions of the SDK are declared.

File list​

  • HOCR_SDK_CPU.h: Header that defines APIs responsible for creating and initializing Hancom OCR SDK engine instances.
  • HOCR_SDK_COMMON.h: Header that defines the core runtime functions provided by Hancom OCR SDK, such as module execution, engine information retrieval, and resource release.

notice​

This directory contains license notices for open-source software included in the SDK.

File list​

  • Hancom OCR SDK_{version}_Notice.txt: License notice for all open-source software used in Hancom OCR SDK.