Dash pattern

Dash patternは、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 ) によると、dash patternは交互に配置される破線とギャップの長さを指定する数値の配列と、パターンをどこから開始するかを決定するオフセット値で構成されます。これにより、開発者はベクターグラフィックスやパスに対して、破線、点線、またはカスタムの破線とギャップの組み合わせなど、さまざまな線スタイルを作成できます。

Dash patternは、パスに沿ってストロークがどのように描画されるかを制御するグラフィックス状態パラメータです。これは、dash arrayとdash phaseの2つのコンポーネントで構成されます。Dash arrayは、描画される破線（線分）とギャップ（描画されない空白）の長さを交互に表す数値のシーケンスで、ユーザー空間単位で測定されます。Dash phaseは、パターンを開始する位置を示すdash pattern内の距離を指定するオフセットです。空のdash arrayまたは長さゼロのdash arrayは、実線の連続した線を生成します。線幅やストローク色のように均一に外観に影響を与えるものとは異なり、dash patternはストロークされたパス全体にわたって繰り返しの変化を作り出します。

PDF生成または操作を行う開発者にとって、dash patternは技術図面、チャート、ダイアグラムにおいて異なる意味を伝える視覚的に識別可能な線スタイルを作成するために不可欠です。異なるdash patternは、グラフ内のさまざまなデータ系列を区別したり、建築図面で異なるタイプの境界を示したり、エンジニアリングダイアグラムで隠れたエッジを表示したりできます。Dash patternを適切に指定する方法を理解することで、生成されたPDFがさまざまなビューアで正しく描画され、意図された視覚的コミュニケーションが維持されることが保証されます。不適切に指定されたdash patternは、描画エラーや、破線を意図していた箇所に実線が表示される結果を招く可能性があります。

Dash patternは、非負の数値の配列とdash phase値を使用してグラフィックス状態で指定されます。配列内の数値は循環的に使用されます。最初の数値は破線の長さを指定し、2番目はギャップの長さ、3番目は別の破線、というように続きます。配列の要素数が奇数の場合、配列全体が繰り返されて偶数長のパターンが作成されます。例えば、[3 1]というdash arrayは、3単位の破線と1単位のギャップで区切られたパターンを作成し、[3 1 1 1]は、3単位の破線、1単位のギャップ、1単位の破線、1単位のギャップのパターンを作成します。Dash phaseは、この繰り返しパターン内の開始点をシフトし、パス上で破線がどこから始まり終わるかを細かく制御できます。パスがストロークされると、パターンはパスの長さに沿って継続的に繰り返され、レンダラーはパターン定義に基づいて適切な破線とギャップの配置を計算します。

• Stroke – 指定された幅と色でパスに沿って描画する操作
• Graphics state – グラフィックス操作がどのように描画されるかを定義するパラメータの集合
• Line cap style – ストロークされたパスの端点で使用される形状
• Line join style – パスセグメントが接続する角で使用される形状
• User space – パス座標と破線の長さが指定される座標系