名刺には、企業や個人に関するビジネス情報が記載されています。名刺には、氏名、会社名、電話番号、ファクス番号、メール アドレス、Web サイトのアドレスなどの情報が含まれることがあります。こうした情報を紙の名刺から取り込み、電子形式で保存する必要が生じることがあります。保存先としては、携帯電話のアドレス帳、メール クライアント、その他のデータ保存システムなどが考えられます。たとえば、名刺はメールやネットワークを通じて vCard 形式でやり取りされることがよくあります。
このシナリオで実行する主な手順は次のとおりです。
- 名刺のデジタル コピーを取得する
名刺をスキャンするか、写真を撮影します。モバイル端末のデジタル カメラで撮影した写真は、解像度や画質が低い場合があります。そのため、画像に追加の前処理が必要になることがあります。
- 名刺を認識する
スキャンしたページには、1ページに複数の名刺が含まれている場合があります。高精度で認識し、すべての情報を正確に抽出する必要があります。
- 認識したデータを適切な形式で保存する
認識したデータは、さまざまなデータ保存システムに保存したり、vCard 形式にエクスポートしてメールで送信したりできます。
このトピックで紹介しているコードサンプルは、Windows 固有です。
ステップ 1. ABBYY FineReader Engine の読み込み
ABBYY FineReader Engine を使い始めるには、Engine オブジェクトを作成する必要があります。Engine オブジェクトは、ABBYY FineReader Engine のオブジェクト階層の最上位に位置するオブジェクトで、さまざまなグローバル設定、一部の処理メソッド、およびほかのオブジェクトを作成するためのメソッドを提供します。Engine オブジェクトを作成するには、InitializeEngine 関数を使用できます。Engine オブジェクトを読み込むその他の方法 (Win) も参照してください。public class EngineLoader : IDisposable
{
public EngineLoader()
{
// これらの変数を、FREngine.dll へのフル パス、Customer Project ID、
// および該当する場合は、Online License トークン ファイルへのパスと Online License パスワードで初期化します
string enginePath = "";
string customerProjectId = "";
string licensePath = "";
string licensePassword = "";
// FREngine.dll ライブラリを読み込みます
dllHandle = LoadLibraryEx(enginePath, IntPtr.Zero, LOAD_WITH_ALTERED_SEARCH_PATH);
try
{
if (dllHandle == IntPtr.Zero)
{
throw new Exception("Can't load " + enginePath);
}
IntPtr initializeEnginePtr = GetProcAddress(dllHandle, "InitializeEngine");
if (initializeEnginePtr == IntPtr.Zero)
{
throw new Exception("Can't find InitializeEngine function");
}
IntPtr deinitializeEnginePtr = GetProcAddress(dllHandle, "DeinitializeEngine");
if (deinitializeEnginePtr == IntPtr.Zero)
{
throw new Exception("Can't find DeinitializeEngine function");
}
IntPtr dllCanUnloadNowPtr = GetProcAddress(dllHandle, "DllCanUnloadNow");
if (dllCanUnloadNowPtr == IntPtr.Zero)
{
throw new Exception("Can't find DllCanUnloadNow function");
}
// ポインターをデリゲートに変換します
initializeEngine = (InitializeEngine)Marshal.GetDelegateForFunctionPointer(
initializeEnginePtr, typeof(InitializeEngine));
deinitializeEngine = (DeinitializeEngine)Marshal.GetDelegateForFunctionPointer(
deinitializeEnginePtr, typeof(DeinitializeEngine));
dllCanUnloadNow = (DllCanUnloadNow)Marshal.GetDelegateForFunctionPointer(
dllCanUnloadNowPtr, typeof(DllCanUnloadNow));
// InitializeEngine 関数を呼び出し、
// Online License ファイルへのパスと Online License パスワードを渡します
int hresult = initializeEngine(customerProjectId, licensePath, licensePassword,
"", "", false, ref engine);
Marshal.ThrowExceptionForHR(hresult);
}
catch (Exception)
{
// FREngine.dll ライブラリを解放します
engine = null;
// FreeLibrary の呼び出し前にすべてのオブジェクトを削除します
GC.Collect();
GC.WaitForPendingFinalizers();
GC.Collect();
FreeLibrary(dllHandle);
dllHandle = IntPtr.Zero;
initializeEngine = null;
deinitializeEngine = null;
dllCanUnloadNow = null;
throw;
}
}
// Kernel32.dll functions
[DllImport("kernel32.dll")]
private static extern IntPtr LoadLibraryEx(string dllToLoad, IntPtr reserved, uint flags);
private const uint LOAD_WITH_ALTERED_SEARCH_PATH = 0x00000008;
[DllImport("kernel32.dll")]
private static extern IntPtr GetProcAddress(IntPtr hModule, string procedureName);
[DllImport("kernel32.dll")]
private static extern bool FreeLibrary(IntPtr hModule);
// FREngine.dll functions
[UnmanagedFunctionPointer(CallingConvention.StdCall, CharSet = CharSet.Unicode)]
private delegate int InitializeEngine(string customerProjectId, string licensePath,
string licensePassword, string tempFolder, string dataFolder, bool isSharedCPUCoresMode,
ref FREngine.IEngine engine);
[UnmanagedFunctionPointer(CallingConvention.StdCall)]
private delegate int DeinitializeEngine();
[UnmanagedFunctionPointer(CallingConvention.StdCall)]
private delegate int DllCanUnloadNow();
// private 変数
private FREngine.IEngine engine = null;
// FREngine.dll へのハンドル
private IntPtr dllHandle = IntPtr.Zero;
private InitializeEngine initializeEngine = null;
private DeinitializeEngine deinitializeEngine = null;
private DllCanUnloadNow dllCanUnloadNow = null;
}
このシナリオに適した処理設定は、Engine オブジェクトの LoadPredefinedProfile メソッドを使用して読み込めます。このメソッドは、設定プロファイル名を入力パラメーターとして使用します。詳細については、プロファイルの操作を参照してください。このシナリオ用の設定は、定義済みプロファイル BusinessCardsProcessing で利用できます。
- 名刺のみを検出します (SynthesisParamsForPage オブジェクトの SynthesizeBusinessCards プロパティを TRUE に設定します) 。
- 品質の低い小さなテキスト領域も含めて、画像内のすべてのテキストを検出します (画像および表は検出されません) 。
- 解像度補正が実行されます。
- Document の論理構造の完全な合成は実行されません。
// 定義済みプロファイルを読み込む
engine.LoadPredefinedProfile("BusinessCardsProcessing");
FineReader Engine に画像を読み込むには、次のオブジェクトのメソッドを使用できます。FRDocument オブジェクトに画像を読み込むには、次のいずれかを行います。これらのメソッドはすべて、画像の前処理に関するさまざまなパラメーターを指定できる PrepareImageMode オブジェクトをパラメーターとして使用します。このオブジェクトは IEngine::CreatePrepareImageMode 関数を呼び出して作成し、必要に応じてそのプロパティを変更した後、そのオブジェクトを必要とする関数に渡します。FREngine.IEngine engine;
string imagePath;
FREngine.IPrepareImageMode pim = engine.CreatePrepareImageMode();
pim.DocumentType = FREngine.DocumentTypeEnum.DT_BusinessCard;
FREngine.IFRDocument frDoc = engine.CreateFRDocument();
frDoc.AddImageFile(imagePath, pim, null);
認識された名刺 (BusinessCard オブジェクト) には、次の field を含めることができます。  | - 氏名
- 会社名
- 会社での役職
- 会社の住所
- 電話番号
- Fax
- 携帯電話番号
- 電子メール
- Web サイト
|
各 field には、そのタイプ (FieldByType プロパティ) または fields コレクション内のインデックス (Field プロパティ) でアクセスできます。各 field には Value プロパティがあり、field の値を string 形式で取得できます。field 内の各文字については、その認識候補を利用できます (GetCharParams メソッド) 。一部の field は複数の構成要素から成る場合があります。たとえば、住所 field には郵便番号、国、USA の州、市区町村、番地を含めることができます。field の構成要素にアクセスするには、Component プロパティまたは FindComponent メソッドを使用できます。前者ではインデックスで構成要素にアクセスでき、後者ではタイプで構成要素を検索できます。各構成要素について、そのタイプと値を確認し、各文字のパラメーターと認識候補を取得できます (GetCharParams メソッド) 。// 名前fieldを取得します
FREngine.IBusinessCardField nameField = card.FieldByType( FREngine.BusinessCardFieldTypeEnum.BCFT_Name, 0 );
// 名を含む構成要素を取得します
FREngine.IBusinessCardFieldComponent firstNameComponent =
nameField.FindComponent( FREngine.BusinessCardFieldComponentTypeEnum.BCFCT_FirstName );
// 認識された名
string firstName = firstNameComponent.Value;
BusinessCard オブジェクトには、名刺を vCard 形式で保存するための専用の ExportToVCard メソッドがあります。ファイルへのパスはパラメーターとして渡します。名刺は、たとえば XML など、利用可能な他のエクスポート形式でも保存できます。// 認識されたデータを vCard 形式で保存します
card.ExportToVCard("D:\\sample.vcf");
// XML で保存します
frDoc.Export("D:\\Demo.xml", FREngine.FileExportFormatEnum.FEF_XML, null);
ステップ 7. ABBYY FineReader Engine のアンロード
ABBYY FineReader Engine での作業が完了したら、Engine オブジェクトをアンロードする必要があります。そのためには、エクスポートされた DeinitializeEngine 関数を使用します。public class EngineLoader : IDisposable
{
// FineReader Engine をアンロードする
public void Dispose()
{
if (engine == null)
{
// Engine はロードされていない
return;
}
engine = null;
// FreeLibrary を呼び出す前にすべてのオブジェクトを削除する
GC.Collect();
GC.WaitForPendingFinalizers();
GC.Collect();
int hresult = deinitializeEngine();
hresult = dllCanUnloadNow();
if (hresult == 0)
{
FreeLibrary(dllHandle);
}
dllHandle = IntPtr.Zero;
initializeEngine = null;
deinitializeEngine = null;
dllCanUnloadNow = null;
// クリーンアップ後に例外をスローする
Marshal.ThrowExceptionForHR(hresult);
}
// Kernel32.dll の関数
[DllImport("kernel32.dll")]
private static extern IntPtr LoadLibraryEx(string dllToLoad, IntPtr reserved, uint flags);
private const uint LOAD_WITH_ALTERED_SEARCH_PATH = 0x00000008;
[DllImport("kernel32.dll")]
private static extern IntPtr GetProcAddress(IntPtr hModule, string procedureName);
[DllImport("kernel32.dll")]
private static extern bool FreeLibrary(IntPtr hModule);
// FREngine.dll の関数
[UnmanagedFunctionPointer(CallingConvention.StdCall, CharSet = CharSet.Unicode)]
private delegate int InitializeEngine( string customerProjectId, string LicensePath, string LicensePassword, , , , ref FREngine.IEngine engine);
[UnmanagedFunctionPointer(CallingConvention.StdCall)]
private delegate int DeinitializeEngine();
[UnmanagedFunctionPointer(CallingConvention.StdCall)]
private delegate int DllCanUnloadNow();
// プライベート変数
private FREngine.IEngine engine = null;
// FREngine.dll へのハンドル
private IntPtr dllHandle = IntPtr.Zero;
private InitializeEngine initializeEngine = null;
private DeinitializeEngine deinitializeEngine = null;
private DllCanUnloadNow dllCanUnloadNow = null;
}
