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

Stroke (S)

Stroke (S) オペレーターは、PDF コンテンツストリーム内の基本的なグラフィックスオペレーターであり、現在のパスの輪郭を、現在のストロークカラー、線幅、およびその他のグラフィックス状態パラメーターを使用してレンダリングします。

キーワード: stroke (s), Stroke (S)

概要

Stroke (S) オペレーターは、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 ) 。このオペレーターが呼び出されると、movetolinetocurveto、rectangle オペレーションを通じて構築されたパスに対して、定義されたストロークパラメーターを適用し、視覚的な輪郭を描画します。パスの内部領域を塗りつぶす fill オペレーションとは異なり、stroking はパスの縁に沿って指定された線の特性で描画を行います。

定義

Stroke (S) オペレーターは、PDF コンテンツストリームにおけるパス描画オペレーターであり、PDF 構文では単一の文字「S」で表されます。このオペレーターは、グラフィックス状態で構築された現在のパスを消費し、ストローク輪郭としてレンダリングした後、グラフィックス状態からパスをクリアします ( 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 ) 。このオペレーターは、現在のグラフィックス状態から様々なストロークパラメーターを適用します。これには、ストロークカラー(RG、G、K などのオペレーターで設定)、線幅(w オペレーター)、線端スタイル(J オペレーター)、線結合スタイル(j オペレーター)、マイター制限(M オペレーター)、破線パターン(d オペレーター)が含まれます。

Stroke オペレーターは、パスの内部領域ではなく輪郭のみをレンダリングする点で、fill オペレーター(f、F、f*、B など)とは異なります。また、現在のパスを閉じてからストロークを実行する「s」(小文字)オペレーターとも異なります。S オペレーターの実行後、現在のパスはクリアされ、後続の描画オペレーションには新しいパスを構築する必要があります。

重要性

PDF の生成や操作を行う開発者にとって、Stroke オペレーターを理解することは、PDF ドキュメント内で線ベースのグラフィックス、境界線、輪郭を作成するために不可欠です。このオペレーターは、線、矩形、曲線、複雑な図形がどのように視覚的に表示されるかを正確に制御することができ、技術図面、ダイアグラム、フォームフィールド、ベクターグラフィックスにとって重要です。

ストロークオペレーションと塗りつぶしオペレーションの違いは、ファイルサイズ、レンダリングパフォーマンス、視覚的出力品質に直接影響します。開発者は、破線、角の丸み、特定の線の太さなど、望ましい視覚効果を実現するために、S オペレーターを適切なグラフィックス状態設定と連携させる必要があります。ストロークオペレーションを誤って使用すると、見えないパス(ストロークカラーが背景と一致する場合)、予期しない線の太さ、PDF ビューアでのレンダリングエラーが発生する可能性があります。

仕組み

Stroke オペレーターは、PDF のパス構築と描画モデルの一部として機能します。典型的なワークフローは、パス構築、グラフィックス状態の設定、パス描画の3つの段階で構成されます ( 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 )

パス構築段階では、m(moveto)、l(lineto)、c(curveto)、re(rectangle)などのオペレーターが、パスを可視化せずにジオメトリを定義します。これらのオペレーターは、グラフィックス状態内の現在のパスに座標とセグメントを蓄積します。

S オペレーターを呼び出す前に、開発者は関連するグラフィックス状態パラメーターを設定する必要があります:

  • ストロークカラースペースとカラー値
  • w オペレーターを使用した線幅(デフォルトは 1.0 ユーザースペース単位)
  • J オペレーターを使用した線端スタイル(butt、round、projecting square)
  • j オペレーターを使用した線結合スタイル(miter、round、bevel)
  • 非実線用の d オペレーターを使用した破線パターン

S オペレーターが実行されると、PDF レンダラーは現在のパスに沿って追跡し、設定されたストロークパラメーターを適用して可視的なピクセルまたはマークを生成します。ストロークは、パスの方向に対して垂直に延び、数学的なパス中心線の両側に線幅の半分ずつ配置されます。ストロークが完了すると、現在のパスはグラフィックス状態からクリアされ、後続のオペレーションには新しいパスの構築が必要になります。

このオペレーターは現在の変換マトリックス(CTM)内で動作するため、線幅と座標は、ユーザースペース座標系に適用されるスケーリング、回転、平行移動の影響を受けます。

関連用語

  • Fill (f) – パスの輪郭ではなく内部領域を塗りつぶすオペレーター
  • Path Construction – 描画前に moveto、lineto、curveto オペレーターを使用してジオメトリックパスを構築するプロセス
  • Graphics State – ストロークカラーや塗りつぶしカラーを含む、グラフィックスオペレーターがコンテンツをレンダリングする方法を制御するパラメーターの集合
  • Line Width (w) – ユーザースペース単位でストロークパスの太さを設定するオペレーター
  • 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