テキストモードオプション

BuildVuの主要な設定オプションの1つにテキストモードがあります。これは、テキスト、図形、画像の出力方法を制御します。さまざまな要件に対応するために、多様なオプションが用意されています。

PDFファイルはレイヤーシステムを使用してレンダリングされ、コンテンツは上位のレイヤーにある他のコンテンツの背後に隠れることがあります。HTMLへの変換時、BuildVuはこのモデルを簡略化し、プレゼンテーション用の背景レイヤーとテキスト選択用の前景レイヤーにします。一部のテキストモードでは、この処理方法が異なります。正確な動作については、以下の説明を参照してください。

テキストモードはtextMode 設定を使用して設定できます。

主な出力形式は2つ（SVGまたは画像）あり、それぞれに3つのテキスト動作があるため、合計6つのモードから選択できます。

• svg_realtext （デフォルト）
• svg_shapetext_selectable
• svg_shapetext_nonselectable
• image_realtext
• image_shapetext_selectable
• image_shapetext_nonselectable

これは背景レイヤーの形式を制御します。

SVGモード（svg_realtext、svg_shapetext_selectable、svg_shapetext_nonselectable）

• ベクターコンテンツはベクターコンテンツのまま保持されるため、品質を損なうことなくページをズームできます。
• 図形はSVG図形として描画されます。
• 画像とシェードは、SVG内で画像として描画されます。
• ページごとに1つの.svgファイルが使用されます（デフォルトでは別々の画像ファイルとともに）。
• 画像モードよりも高品質ですが、レンダリングが遅くなります。

画像モード（image_realtext、image_shapetext_selectable、image_shapetext_nonselectable）

• すべての図形、画像、シェードが画像レイヤーに描画されます。
• 画像モードは、ファイルサイズが最も小さく、レンダリングが最も高速です（一般的に）。
• ページごとに1つの画像のみであるため、出力はシンプルで簡潔です。
• ズームインすると図形がピクセル化されます。

これは出力でテキストがどのようにレンダリングされるかを制御します。

リアルテキストモード（svg_realtext、image_realtext）

• PDFテキストは実際の選択可能なテキストに変換され、フォントを使用して表示されます。
• ファイルサイズが最も小さくなります。
• テキストは検索可能です（Webクローラーやウェブブラウザで）。
• テキストは変更可能です（自動翻訳ツールなどによって）。
• テキストの間隔は各行で平均化されます（テキストカーニング はHTMLではサポートされていません）
• テキストは選択のために前景レイヤーに移動されます。これにより、他のコンテンツによって隠されるはずのテキストが表示される場合があり、テキストにブレンドモードが適用されなくなります。

最も正確なテキスト表示が必要な場合は、シェイプテキストモードを使用する必要があります。

シェイプテキスト選択可能モード（svg_shapetext_selectable、image_shapetext_selectable）

• テキストはSVGまたは画像の背景レイヤー内で図形として描画されます。
• 検索と選択に使用するための不可視の実際のテキストレイヤーが前景レイヤーに描画されます。
• テキストを検索および選択できます。
• テキスト選択を保持したまま、PDFを完璧に再現します。
• svgシェイプテキストバリアントを使用すると、パフォーマンスとファイルサイズにペナルティがあります。
• imageシェイプテキストバリアントを使用すると、ズームイン時にテキストがピクセル化される場合があります。これはimageScale 設定を増やすことで緩和できます。

シェイプテキスト選択不可モード（svg_shapetext_nonselectable、image_shapetext_nonselectable）

• テキストはSVGまたは画像の背景レイヤー内で図形として描画されます。
• PDFのテキストを完璧に再現します（ただし、検索/選択はできません）。
• svgシェイプテキストバリアントを使用すると、パフォーマンスとファイルサイズにペナルティがあります。
• imageシェイプテキストバリアントを使用すると、ズームイン時にテキストがピクセル化される場合があります。これはimageScale 設定を増やすことで緩和できます。

現在、テキストを実際のテキストとして背景のSVGレイヤーに書き込む実験的なテキストモードを評価しています。SVGはテキストカーニングをサポートしているため、表示精度が向上し、リアルテキストモードで発生する可能性のあるレイヤーの問題も防止されます。

選択のための不可視のHTMLテキストの追加レイヤーも前景レイヤーに追加されます。

このモードは、コマンドラインオプション（またはシステムプロパティ）で有効にできます：-DexperimentalTextMode=true

このモードに関するフィードバックがあれば、ぜひお聞かせください。

デフォルト設定（svg_realtext）は、変換精度、ファイルサイズ、レンダリングパフォーマンスのバランスが良好です。

表示精度を優先する場合は、シェイプテキストモードを推奨しますが、レンダリングが遅くなり（SVGモードの場合）、ファイルサイズが大きくなるというトレードオフがあります。

最高のパフォーマンスを求める場合は、リアルテキストモードを推奨します。一般的に、ブラウザはSVGモードよりも画像モードの方が高速にレンダリングします。