Skip to main content
Interwork Corporation
IDR Solutions Product Support Portal
PDF開発用語集 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動

Text rise

Text riseは、PDFにおけるテキストフォーマットパラメータの1つで、ベースラインからのテキスト文字の垂直オフセットを制御します。

カテゴリ: General PDF Concepts
キーワード: text rise, Text rise

概要

Text riseは、PDFにおけるテキストフォーマットパラメータの1つで、ベースラインからのテキスト文字の垂直オフセットを制御します。PDFコンテンツストリーム内でTsオペレータを使用して指定し、ベースラインを基準として文字を上方(正の値)または下方(負の値)に移動させます ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) 。このパラメータは、フォントサイズや周囲のテキストのベースライン位置を変更することなく、上付き文字、下付き文字、その他の垂直方向のテキスト配置効果を作成する際によく使用されます。

定義

Text riseは、テキストスペース単位で表される数値で、テキストベースライン自体を変更することなく、個々の文字またはテキスト実行を垂直方向にシフトします。PDFコンテンツストリーム内でTsオペレータが適用されると、新しいtext rise値が設定されるまで、後続のテキストは指定された垂直オフセットでレンダリングされます。正の値はテキストをベースラインより上に移動させ(上付き文字に有用)、負の値はテキストをベースラインより下に移動させます(下付き文字に有用)。

複数のテキストプロパティに同時に影響を与えるフォントサイズの変更や行列変換とは異なり、text riseは垂直位置のみを変更する専用パラメータです。テキスト行のベースラインは変更されないため、text riseはグリフのレンダリング位置に影響を与えながら、テキスト行の論理的な流れと間隔計算を維持します。これにより、text riseは単一のテキスト行内でのインラインフォーマット変化に特に効率的です。

重要性

PDFの生成や操作を行う開発者にとって、text riseは、科学・数学文書、法的引用、脚注マーカー、および印刷的に正しいコンテンツを適切にフォーマットするために不可欠です。Text riseを理解することで、開発者は以下のことが可能になります:

  • レンダリングに一貫性のない可能性のある特殊なUnicode文字に頼ることなく、上付き文字と下付き文字を生成できる
  • Tagged PDFにおいて、視覚的なフォーマット要件を満たしながら適切な論理的読み順序を維持できる ( Citation: , (). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ )
  • テキスト行内の混在フォーマット全体でベースラインの整列を保持できる
  • 指数や化学式などの意味的意味が、視覚的位置付けのみではなく構造を通じて適切に伝達されるアクセシブルな文書を実装できる

Text riseの不適切な処理は、スクリーンリーダーが上付き文字または下付き文字のコンテンツを適切に解釈できない、またはテキスト抽出が不正確な文字シーケンスを生成するといったアクセシビリティの問題を引き起こす可能性があります。

仕組み

PDF構文において、text riseはTsオペレータとそれに続く、スケーリングされていないテキストスペース単位での垂直オフセットを表す数値パラメータを使用して設定されます。このオペレータは、PDFコンテンツストリーム内で次のように表示されます:

offset Ts

ここでoffsetはrise値を指定する数値です。例えば、5 Tsは後続のテキストをベースラインより5単位上に移動させ、-3 Tsはテキストをベースラインより3単位下に移動させます。デフォルトのtext rise値は0です。

実際にレンダリングされるオフセットは、現在のテキスト行列と座標変換に依存します。Text riseはフォントサイズのスケーリング後に適用されますが、PDF仕様で定義されている全体的なテキスト変換計算に参加します ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) 。テキスト行列にスケーリングまたは回転が含まれる場合、text riseオフセットもそれに応じて変換されます。

Text riseは、別のTsオペレータによって明示的に変更されるか、グラフィック状態によってリセットされるまで、後続のすべてのテキスト表示操作に対して有効です。ベストプラクティスとしては、上付き文字または下付き文字をレンダリングした後、text riseを0にリセットして、後続のテキスト操作の予測可能な動作を確保することです。

関連用語

  • Baseline(ベースライン) – テキスト文字が配置される想像上の線で、text riseの測定基準となる
  • Text State Parameters(テキスト状態パラメータ) – text riseを含む、テキストレンダリングの外観を制御するパラメータのコレクション
  • Text Matrix(テキスト行列) – テキストスペース座標をユーザースペースにマッピングする変換行列で、text riseのレンダリング方法に影響する
  • Superscript(上付き文字) – ベースラインより上に配置されるテキストで、通常は正のtext rise値を使用して実装される
  • Content Stream(コンテンツストリーム) – text riseコマンドを含む、ページコンテンツを定義するPDFオペレータとオペランドのシーケンス

出典

(N.A.) (2020)
(N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html
PDF Association (2023)
(). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/