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

MoveTo (m)

MoveTo演算子(PDFコンテンツストリームでは`m`で表記)は、指定された座標に新しいサブパスを開始する基本的なパス構築演算子であり、視覚的な描画を行いません。

キーワード: moveto (m), MoveTo (m)

概要

MoveTo演算子(PDFコンテンツストリームではmで表記)は、指定された座標に新しいサブパスを開始する基本的なパス構築演算子であり、視覚的な描画を行いません。 ( 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 ) で定義されているように、この演算子はグラフィックス状態の現在点を再配置し、後続のパスセグメントの構築を開始します。これは、紙の上でペンを持ち上げて新しい位置に置き、描画を開始する前の動作に似ています。

定義

MoveTo(m)は、PDFコンテンツストリームにおけるパス構築演算子で、2つのオペランド(x座標とy座標)を取り、ストロークや塗りつぶしのグラフィックスを作成せずに新しい現在点を確立します。この演算子は後置記法でx y mと記述され、xとyは現在のユーザー空間座標系における座標を表す数値です。LineTol)などの線描画演算子とは異なり、MoveToは前の現在点と新しい位置の間に視覚的な線分を作成しません。代わりに、既存のサブパスを終了し、指定された座標で新しいサブパスを開始します。この演算子は、分離されたパスセグメント、複数のコンポーネントを持つ複雑な図形の作成、および単一のパスオブジェクト内での後続描画操作の開始点の配置に不可欠です。

重要性

PDF生成や操作を行う開発者にとって、MoveTo演算子の理解は、正確なベクターグラフィックスの作成とパス構築ロジックの制御において重要です。この演算子により、複数の分離された図形を含む複合パスの作成が可能になります。例えば、内部に穴を持つ文字(「O」や「P」など)や、別々のコンポーネントを持つ複雑なイラストレーションを、すべて単一のパス定義内で表現できます。PDFコンテンツをプログラム的に生成する際、MoveToを適切に使用することで、グラフィックスが正しくレンダリングされ、塗りつぶし操作が適切なワインディングルールで意図通りに機能し、クリッピングパスが正しく動作することが保証されます。PDFライブラリ、レンダリングエンジン、コンテンツ生成ツールを構築する開発者は、PDF仕様で定義されたパスベースのグラフィックスの全範囲をサポートするために、MoveToの処理を実装する必要があります。

仕組み

MoveTo演算子は、現在のパスにジオメトリを追加せずに、新しい現在点を設定することでPDFグラフィックス状態を変更します。PDFコンテンツストリームプロセッサがx y mのシーケンスに遭遇すると、次の動作を実行します:現在のサブパス(存在する場合)を終了し、座標(x, y)を新しい現在点として保存し、新しいサブパスの開始準備をします。LineTo、CurveTo、Rectangleなどの後続のパス構築演算子は、この現在点を開始位置として使用します。座標は現在の変換行列(CTM)内で解釈されるため、MoveToは回転、拡大縮小、または平行移動された座標系とシームレスに連携します。パスオブジェクトは通常、MoveTo演算子で始まり、追加のパス構築演算子が続き、stroke(S)、fill(f)、またはclose and stroke(s)などのパス描画演算子で終了します。同じパス内での複数のMoveTo操作は、単一のユニットとして一緒に描画できる、分離された複数のサブパスを作成します。

関連用語

  • LineTo – 現在点から指定された座標まで直線を描画するパス構築演算子
  • Path Construction Operators(パス構築演算子) – MoveTo、LineTo、CurveToを含む、PDFコンテンツストリームでベクターパスを構築するために使用される演算子のセット
  • Current Point(現在点) – 次のパスセグメントが開始または終了するグラフィックス状態内のアクティブな位置
  • Subpath(サブパス) – MoveTo演算子で始まる、接続されたパスセグメントの連続したシーケンス
  • Content Stream(コンテンツストリーム) – ページコンテンツを記述する演算子とオペランドのシーケンスを含む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