Text Modeオプション
BuildVuの主な設定オプションの1つにテキストモードがあります。これはテキスト、シェイプ、イメージの出力方法を制御します。様々な要件に対応できるよう、様々なオプションが用意されています。
PDFファイルはレイヤーシステムを使用してレンダリングされ、コンテンツは上のレイヤーにある他のコンテンツの後ろに隠れることができます。HTMLに変換する際、BuildVuはこのモデルをプレゼンテーション用の背景レイヤーとテキスト選択用の前景レイヤーに単純化します。テキストモードによっては、この処理を異なる方法で行います。正確な動作は以下の説明をご覧ください。
テキストモードは、VM引数 –Dorg.jpedal.pdf2html.textMode=[MODE] または関連するOptionsクラスのsetTextMode()メソッドを使って設定することができます。
出力形式は主に2種類（SVGまたはImage）あり、それぞれ3種類のテキストビヘイビアを備えているので、合計6種類のモードから選ぶことができます。
svg_realtext(デフォルト)svg_shapetext_selectablesvg_shapetext_nonselectableimage_realtextimage_shapetext_selectableimage_shapetext_nonselectable
イメージかSVGか？
背景レイヤーのフォーマットを制御します。
SVG モード (svg_realtext, svg_shapetext_selectable, svg_shapetext_nonselectable)
- ベクターコンテンツはベクターコンテンツのままなので、画質を落とすことなくページを拡大することができます。
- 図形はSVGの図形として描画されます。
- 画像や陰影は、SVG内の画像として描画されます。
- 1ページにつき1つの.svgファイルが使用されます（デフォルトでは個別の画像ファイルが使用されます）。
- 高画質ですが、イメージモードよりレンダリングに時間がかかります。
イメージモード (image_realtext, image_shapetext_selectable, image_shapetext_nonselectable)
- すべての図形、画像、陰影は画像レイヤーに描画されます。
- イメージモードは、ファイルサイズが最も小さく、レンダリング速度も速い（一般的に）。
- 1ページに1つの画像だけなので、出力はシンプルで簡潔です。
- 図形を拡大すると、画素が現れます。
リアルテキスト、シェイプテキスト、あるいはその両方？
これは、出力におけるテキストのレンダリング方法を制御します。
リアルテキストモード (svg_realtext, image_realtext)
- PDFテキストを選択可能な実際のテキストに変換し、フォントを使用して表示します。
- ファイルサイズは最も小さくなります。
- テキストは検索可能です（ウェブクローラーやウェブブラウザーなど）。
- テキストを修正することができます（自動翻訳ツールなど）。
- テキストの間隔は各行で平均化されます（HTMLではテキストのカーニングはサポートされていない）。
- テキストを最前面に表示することで、他のコンテンツで隠れていたテキストが表示されたり、テキストにブレンドモードが適用されなくなったりすることがあります。
- テキストを最も正確に表示する必要がある場合は、シェイプテキストモードを採用してください。
シェイプテキスト・セレクタブルモード (svg_shapetext_selectable, image_shapetext_selectable)
- テキストは SVG またはイメージの背景レイヤーに図形として描画されます。
- 前景レイヤーには不可視の実テキストが描画され、検索と選択に使用されます。
- テキストは検索して選択することができます。
- テキストの選択を保持したまま、PDFで完璧に表現できます。
- svg shapetext変数を使用すると、パフォーマンスとファイルサイズに若干影響があります。
- image shapetext変数を使うと、拡大時にテキストが画素化することがあります。これは imageScale 設定を大きくすることで軽減されます。
シェイプテキスト・ノンセレクタブルモード(svg_shapetext_nonselectable, image_shapetext_nonselectable)
- テキストはSVGまたはイメージの背景レイヤーの中に図形として描き出されます。
- PDF の完全なテキスト表現が可能です （ただし 検索・選択はでき ません）。
- svg shapetext 変数を使うと 、パフォーマンスとファイルサイズに影響があります。
- image shapetext 変数を使用した場合、ズームインするとテキストが画素化することがあります。これは、imageScale 設定を大きくすることで軽減されます。
実験的なテキストモード
現在、背景のSVGレイヤーにテキストをリアルテキストとして書き込む実験的なテキストモードの評価を行っています。SVGはテキストのカーニングをサポートしているため、表示精度が向上し、またリアルテキストモードで発生しうるレイヤーの問題を防ぐことができます。
また、選択用に不可視のHTMLテキストが前景レイヤーに追加されます。
このモードは、コマンドラインオプション（またはシステムプロパティ）で有効にすることができます。-DexperimentalTextMode=true
このモードに関するフィードバックがありましたら、ぜひお聞かせください。
どのモードがおすすめですか？
デフォルトの設定（svg_realtext）は、変換精度、ファイルサイズ、およびレンダリング性能のバランスが取れています。
表示精度を優先するのであれば、シェイプテキストモードをお勧めしますが、その代償としてレンダリング速度が遅くなり（SVGモード）、ファイルサイズも大きくなります。
最高のパフォーマンスを求めるのであれば、リアルテキストモードをお勧めします。一般に、ブラウザはSVGよりイメージモードの方がレンダリングが速いです。