ocr_init

OCR エンジンを初期化

ocr_init [, "lang"]

lang : BCP-47 言語タグ (例 "ja" / "en-US")。省略時はユーザー
       プロファイル言語から自動選択。

(プラグイン / モジュール : hspwinrtocr.dll)

解説

Windows.Media.Ocr.OcrEngine を作成します。

引数を省略した場合は OcrEngine::TryCreateFromUserProfileLanguages()
を使って OS 側の言語設定から自動で選ばれます。言語タグを指定
した場合は IsLanguageSupported() で利用可能か確認してから
TryCreateFromLanguage() で作成します。

戻り値 (stat):
  0  : 成功
 -1  : エンジン作成失敗 (言語パック未インストール等)
 -2  : 指定言語がサポート外

関連項目

ocr_freeOCR エンジンを解放(hspwinrtocr.dll)
ocr_langs利用可能な OCR 言語一覧を取得(hspwinrtocr.dll)
ocr_run_file画像ファイルを OCR する(hspwinrtocr.dll)

サンプル逆引き (1)

sample_winrtocr.hsp

情報

プラグイン / モジュールhspwinrtocr.dll
バージョン1.0
作成日2026-04-15
著作者IronHSP / hspwinrtocr
URLhttps://github.com/inovia/IronHSP
備考hspwinrtocr.dll は Windows 10 以降に標準搭載されている WinRT
OCR エンジン (Windows.Media.Ocr.OcrEngine) を HSP3 から直接呼び
出すためのプラグインです。

追加のモデルダウンロードは不要で、OS にインストール済みの言語パ
ックがそのまま OCR の認識言語になります (日本語 OCR は OS の
言語設定に日本語が含まれている必要があります)。

実装は C++/WinRT (header-only) + windowsapp.lib で、非同期
API はすべて内部で .get() による同期待ち扱いになっています。
HSP 側からは通常の同期呼び出しとして使えます。

API は画像ファイルからの OCR (ocr_run_file) と、HSP カレント
ウィンドウの描画内容からの OCR (ocr_run_hwnd) の 2 種類を提供
します。
タイプ拡張命令
グループhspwinrtocr ― 基本
対応環境
  • その他 : Win32 / Win64 (Windows 10 以降)
hs ファイルhsphelp\hspwinrtocr.hs