LineTo (l)
LineTo演算子(略称`l`)は、PDFコンテンツストリーム内のパス構築演算子であり、現在の点から指定された座標まで直線セグメントを追加します。
LineTo演算子(略称l)は、PDFコンテンツストリーム内のパス構築演算子であり、現在の点から指定された座標まで直線セグメントを追加します
(
Citation: N.A., 2020
(N.A.).
(2020).
Document management — Portable document format — Part 2: PDF 2.0
.
International Organization for Standardization
Retrieved from
https://www.iso.org/standard/75839.html
)
。この演算子はPDFにおけるベクターグラフィックスの基本要素であり、複雑な図形、境界線、幾何学的図形の作成を可能にします。他のパス構築演算子と共に、LineToはPDF文書内のすべての可視的な線ベースグラフィックスの構成要素となります。
LineTo演算子は、PDFコンテンツストリーム内で小文字のlとして表され、2つのオペランド(ユーザー空間におけるx座標とy座標)を取ります。構文はx y lであり、この演算子は現在の点(MoveToなどの前のパス演算子によって確立された点)から点(x, y)まで直線を描画します。描画せずに位置を移動するだけのMoveTo演算子とは異なり、LineToは実際に現在のパスに可視的な線セグメントを追加し、そのパスが後で線描画または塗りつぶしされたときに表示されます。この演算子は現在の点を指定された(x, y)座標に更新し、後続のパス演算子がその位置から継続できるようにします。LineToはパス構築段階の一部であり、完全なパスにパス描画演算子(strokeやfillなど)が適用されるまで、可視的なものは何もレンダリングされません。
PDFの生成や操作を行う開発者にとって、LineTo演算子はベクターグラフィックスをプログラム的に作成するために不可欠です。この演算子の理解は、図形、境界線、表、カスタムグラフィックスを含むPDFコンテンツを生成する際に極めて重要であり、線描画に対する正確な制御を提供します。JavaまたはWebアプリケーションでPDFライブラリを使用する開発者は、レンダリングの問題をデバッグしたり、カスタム描画ルーチンを実装したり、PDFファイルサイズを最適化したりする際にLineToを理解する必要があります(ベクターパスはラスター画像よりもコンパクトです)。この演算子のシンプルさと効率性により、幾何学的図形にはビットマップグラフィックスを埋め込むよりも好ましく、結果としてファイルサイズが小さくなり、どの拡大レベルでもきれいにスケーリングされる解像度非依存のグラフィックスが得られます。
LineTo演算子は、PDFのパス構築モデル内で動作し、複数段階のプロセスに従います。まず、パスはMoveTo(m)演算子で開始される必要があり、これは何も描画せずに現在の点を確立します。次に、1つ以上のLineTo演算子を呼び出して、パスに直線セグメントを追加できます。各LineTo操作は、概念的に現在の点から新しい座標まで描画し、現在の点をその座標に更新します。
例えば、以下のコンテンツストリームシーケンスを見てみましょう:
100 100 m
200 100 l
200 200 l
100 200 l
これは、長方形の3辺を形成する3つの接続された線セグメントを持つパスを作成します。これらの操作後の現在の点は(100, 200)になります。長方形を閉じるには、通常ClosePath(h)演算子が使用されるか、(100, 100)に戻る別のLineToが使用されます。
LineTo操作で指定される座標は、現在のユーザー空間座標系で解釈され、この座標系は現在の変換マトリックス(CTM)によって変換される可能性があります。LineToおよび他のパス演算子で完全なパスを構築した後、パス描画演算子を適用する必要があります:線描画(アウトライン)にはS、塗りつぶし(内部)にはf、またはそれらの組み合わせです。パス描画演算子が呼び出されるまで、パスは不可視のままであり、グラフィックス状態内の数学的構造としてのみ存在します。
- MoveTo (m) – 線を描画せずに新しい現在の点を確立するパス演算子
- ClosePath (h) – 開始点まで直線を描画して現在のサブパスを閉じるパス演算子
- CurveTo (c) – 直線の代わりに3次ベジェ曲線セグメントをパスに追加するパス演算子
- Stroke (S) – 現在の線描画色と幅で現在のパスのアウトラインを描画するパス描画演算子
- Content Stream – パス構築および描画操作を含む、ページコンテンツを記述するPDF演算子とオペランドのシーケンス
- (N.A.) (2020)
- (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 . International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html
