본문으로 건너뛰기
시골프로그래머의 블로그
블로그 메뉴

Windows 내장 OCR을 .NET 없이 부르는 DLL — winrtOcr

Windows에 들어 있는 OCR 엔진(Windows.Media.Ocr)을 .NET 런타임 없이 쓰게 해 주는 약 175KB짜리 C++ DLL입니다. 명령줄 도구와 Delphi 래퍼, 데모 앱이 함께 들어 있습니다.

풀빛컴퓨팅2분 읽기#오픈소스#C++#OCR#Delphi

Windows 10부터는 OCR 엔진(Windows.Media.Ocr)이 운영체제에 들어 있습니다. 학습 데이터를 따로 받을 필요도 없습니다. 그런데 이 엔진은 WinRT API라서, Delphi나 C 같은 네이티브 프로그램에서 부르려면 .NET을 거치거나 WinRT 호출 코드를 직접 짜야 합니다.

winrtOcr는 이 엔진을 평범한 C 함수로 감싼 DLL(sc_ocr.dll)과, 그 DLL을 쓰는 명령줄 도구와 Delphi 데모 앱을 담은 저장소입니다.

무엇을 하나

  • CRT를 정적으로 링크한 DLL 하나(약 175KB)입니다. .NET, VC 재배포 패키지, COM 등록이 필요 없습니다.
  • 64비트용 sc_ocr.dll과 32비트용 sc_ocr32.dll이 있습니다.
  • 함수는 UTF-16 문자열과 stdcall 규약을 쓰므로 Delphi, C, C# 어디서든 부를 수 있습니다.
  • 내부 MTA 워커 스레드에서 돌기 때문에 호출하는 스레드에서 COM을 초기화하지 않아도 됩니다.

명령줄에서 쓰기

winocr.exe를 sc_ocr.dll과 같은 폴더에 두고 실행합니다.

winocr scan.png                       rem 텍스트를 표준 출력으로 (파이프 가능)
winocr scan.png -l ko-KR -o out.txt   rem 한국어 인식 후 UTF-8 파일 저장
winocr --list-langs                   rem 사용 가능한 OCR 언어 목록
옵션 설명
-i, --input <파일> 입력 이미지(위치 인자로도 지정 가능)
-o, --output <파일> 결과를 UTF-8 파일로 저장(생략하면 표준 출력)
-l, --lang <태그> OCR 언어(BCP-47). 생략하면 사용자 프로필 언어
--list-langs 사용 가능한 OCR 언어 목록

종료 코드는 0 성공, 1 OCR 오류, 2 사용법 오류입니다.

프로그램에서 쓰기

DLL 함수는 네 개입니다. 이미지에서 글자를 뽑는 SC_OcrExtractText, 쓸 수 있는 언어 목록을 주는 SC_OcrGetAvailableLanguages, 언어 지원 여부를 묻는 SC_OcrIsLanguageSupported, 마지막 오류 메시지를 주는 SC_OcrGetLastError입니다. 텍스트를 돌려주는 함수는 버퍼에 null을 넘기면 필요한 길이를, 버퍼를 넘기면 내용을 채워 주는 두 단계 방식입니다.

Delphi에서는 SCOcr.pas의 TSCOcr 클래스로 한 줄에 끝납니다.

uses
  SCOcr;

// 한국어 OCR (sc_ocr.dll 은 exe 와 같은 폴더에 배치)
var LText := TSCOcr.ExtractText('C:\images\sample.png', 'ko-KR');

// 시스템 기본 언어로 인식
var LAuto := TSCOcr.ExtractText('C:\images\sample.png');

오류는 ESCOcrError 예외로 올라오고, 워커 스레드에서 불러도 됩니다.

빌드

rem 1) C++ DLL (x64 + x86 동시 빌드 → bin\)
build_cpp.bat

rem 2) Delphi 데모 앱 (src\ 에서)
dcc64 -B -E..\bin -N0..\dcu WinRTOCR.dpr

DLL 빌드에는 Visual Studio 2022(C++/WinRT)가, 데모 앱에는 Delphi 13이 필요합니다. 빌드한 파일은 릴리스에서도 받을 수 있습니다.

알아 둘 점

  • Windows 10(빌드 10240) 이상에서 동작합니다.
  • 인식할 언어의 OCR 기능이 Windows 언어 팩으로 설치되어 있어야 합니다(설정 → 시간 및 언어 → 언어). 없으면 언어 팩 미설치 오류(-2)가 납니다.
  • 서명하지 않은 새 실행 파일은 Windows Defender가 악성코드로 잘못 잡을 수 있습니다. winocr.exe는 OCR 본체를 DLL로 따로 불러 이를 줄였습니다. 배포할 때 근본 해결책은 코드 서명입니다.
  • 라이선스는 MIT입니다.

소스와 자세한 설명은 GitHub 저장소에 있습니다.

함께 읽으면 좋은 글