Windows 내장 OCR을 .NET 없이 부르는 DLL — winrtOcr
Windows에 들어 있는 OCR 엔진(Windows.Media.Ocr)을 .NET 런타임 없이 쓰게 해 주는 약 175KB짜리 C++ DLL입니다. 명령줄 도구와 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 저장소에 있습니다.