iText Tutorial: Text

PDF シンタックス

テキストを書き込む PDF シンタックスは、次のようになります。

BT
  /F13 12 Tf
  288 720 Td
  (ABC) Tj
ET

上の例では、あるフォント（/F13）のあるサイズ（12）を使ってある位置に、ABC（Tj）書いています。テキストステートは、グラフィックスステートのサブセットであり、iText は、多数のメソッドが提供されているので PDF シンタックスを主導で書く必要はありませんが、テキストステート、テキストのポジショニング、テキスト表示演算子のリストを見る前に、テキストオブジェクト演算子について知っておかなければなりません。

BT	beginText()
ET	endText()

下記で示すメソッドを beginText/endText ブロックの外側で使ったら、PDF Reader は、'破壊された PDF ファイル'の警告あるいはエラーメッセージを出力します。これらのメソッドを使うのを忘れないでください！

先頭に戻る

テキストステート

テキストだけに影響する九つのグラフィックスステートのパラメータがあります(PDF Reference Manual 表 5.1 参照)。下の表に、そのパラメータ（斜体）と対応する演算子（太字、Reference Manual 表 5.2 参照）、対応するテキストステートを変更する iText のメソッドを列挙しました。

Tc	Tc	setCharacterSpacing(float)
Tw	Tw	setWordSpacing(float)
Th	Th	setHorizontalScaling(float)
Tl	TL	setLeading(float)
Tf	Tf	setFontAndSize(com.lowagie.text.pdf.BaseFont, float)
Tfs	Tf	setFontAndSize(com.lowagie.text.pdf.BaseFont, float)
Tmode	Tr	setTextRenderingMode(int) テキストンダリングモードは、次の値のうちのひとつです。 PdfContentByte.TEXT_RENDER_MODE_FILL PdfContentByte.TEXT_RENDER_MODE_STROKE PdfContentByte.TEXT_RENDER_MODE_FILL_STROKE PdfContentByte.TEXT_RENDER_MODE_INVISIBLE PdfContentByte.TEXT_RENDER_MODE_FILL_CLIP PdfContentByte.TEXT_RENDER_MODE_STROKE_CLIP PdfContentByte.TEXT_RENDER_MODE_FILL_STROKE_CLIP PdfContentByte.TEXT_RENDER_MODE_CLIP 例は、Chunk の章を参照ください。
Trise	Ts	setTextRise(float)
Tk		PdfGState.setTextKnockout(boolean)

テキストそれ自体も、テキスト空間という座標系を持っています。それは、テキスト行列 Tm とテキストステートパラメータ Tfs、Th、Trise によって定義され、テキスト空間からユーザ空間への変換行列を作り出します。次に、テキストポジショニングパラメータのリストを示します（PDF Reference Manual 表 5.5 参照）。

Td	moveText(float, float)
Td	moveTextWithLeading(float, float)
Tm	setTextMatrix(float, float) setTextMatrix(float, float, float, float, float, float)
T*	newlineText()

最後に、テキスト表示演算子を示します（PDF Reference Manual 表 5.6 参照）。

Tj	showText(java.lang.String)
'	newlineShowText(java.lang.String)
"	newlineShowText(float, float, java.lang.String)
TJ	showText(com.lowagie.text.pdf.PdfTextArray)

iText は、上記のメソッドを組み合わせた showTextKerned(java.lang.String)、showTextAligned(int, java.lang.String, float, float, float)、showTextAlignedKerned(int, java.lang.String, float, float, float) といった拡張メソッドも提供しています。 .
この単純な例は、いくつかのテキストを絶対位置へ書き込みます。

Example: java com.lowagie.examples.directcontent.text.Text
Adding text at absolute positions: see text.pdf

この例は、テキストステートも適用できるグラフィックスステートメソッドを示しています。テキストグリフはシェープであり、その色を変えたいときには、'colorfill'を変更しなければなりません。

Example: java com.lowagie.examples.directcontent.text.Logo
Draws the iText logo: see logo.pdf

先頭に戻る

フォント

PDF Reference Manual 第5章の第一部でテキストステートが取り扱われています。（5.4節から始まる）第二部で、フォントが取り扱われています。
In this tutorial fonts are discussed in 3 chapters of a separate part: このチュートリアルでは、フォントは別々の三つの章で説明されています。

先頭に戻る

チュートリアル: iText.NET

テキスト