THotPDF.CMapResourcePath Property

読み込みドキュメントのテキスト抽出時に標準 CMap コレクションを探すルートディレクトリーを設定します。空のままにすると自動リソース参照を使います

宣言

property CMapResourcePath: TFileName read FCMapResourcePath write SetCMapResourcePath;

ユニット

HPDFDoc

パラメータ

戻り値

設定された CMap コレクションのルートを返します

使用上の注意

• UniJIS・UniGB・UniCNS・UniKS の UCS2 / UTF16 横書きおよび縦書きマッピングは、補助 Unicode スカラーを含めて組み込み済みです。そのためこれらの標準 Unicode CMap に外部リソースディレクトリーは不要です
• 設定したディレクトリーには Adobe-GB1-6\CMap のようなコレクションフォルダーが含まれている必要があります
• リソースが実行ファイル相対の参照位置の外にある場合は、読み込みテキスト抽出の前にこのプロパティーを設定してください
• 代入のたびに読み込みフォントデコーダーのキャッシュはクリアされます。同じパスの再代入でも同様です
• 外部 CMap ファイルが変更され、プロセス全体の解析済みリソースキャッシュも更新が必要な場合は、このプロパティーの再設定前に HPDFClearCMapCaches を呼び出してください
• 解析済みの標準マップと CID テーブルは解決済みルートとマップ名でキャッシュされるため、2 つのリソースルートが同じ名前の異なるマップを安全に提供できます
• プロセス全体の標準 CMap リソースキャッシュは並行アクセスに対して安全で、ソート済みの文字マッピングと範囲マッピングは対数時間で参照されます
• 1 バイトから 4 バイトのコードスペースは、有効な 3 バイトコードスペースを含めてそのまま保持されます
• 追加バンドルの 182 個のエンコーディングマップはすべて組み込みです。レガシーな GBK・EUC・Big5・Shift-JIS 系の各バリアント、継承された縦書きオーバーライド、UTF8 / UTF32 のコードスペースを含みます
• Type0 テキストオペランドは 1 バイトから 4 バイトのエンコーディングコードスペースを正確に使い、UTF32 における混在幅や先行ゼロバイトを保持します
• 明示的なリソースディレクトリは引き続き標準マップをオーバーライドできます。ローダーパスを空にすると、周囲のコレクションファイルを読まずに組み込みテーブルが選択されます
• 不正な 16 進データ、無効なサロゲートシーケンス、逆転した範囲、過大な明示範囲、あふれるターゲットは、無制限の割り当てや折り返しマッピングなしで処理されます

関連 API

• THotPDF
• THPDFPage
• 目次