テキストモードオプション – textMode
BuildVuの主な設定オプションの一つにテキストモードがあります。これはテキスト、図形、画像の出力方法を制御します。さまざまな要件を満たすために、さまざまなオプションが用意されています。
PDFファイルはレイヤーシステムを使用してレンダリングされ、コンテンツは上のレイヤーにある他のコンテンツの後ろに隠すことができます。HTMLに変換する場合、BuildVuはこのモデルを単純化し、プレゼンテーション用の背景レイヤーとテキスト選択用の前景レイヤーにします。テキストモードによっては、これを異なる方法で処理します。正確な動作は以下の説明を参照してください。
テキスト・モードはtextMode設定で設定できます。
2つの主な出力形式（SVGまたは画像）があり、それぞれに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よりイメージモードの方がレンダリングが速いです。