Yotsuba Games
Back to Node List

Path Fill

path_fill

Fill the interior of a closed bezier path as an image and surface

Draft
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

NameTypeDescription
パス
path
Path
Required
塗りつぶすベジェパス
色
color
Color
塗りの色（接続時はパラメータより優先）

Output Ports

NameTypeDescription
画像
output
Image
塗りつぶされたパス画像
サーフェース
surface
Surface
塗りつぶした形に高さ・素材ID・面IDを付けたサーフェースです

Parameters

NameTypeDefaultRangeDescription / Options
幅
width
Int
641–1024

キャンバスの幅（ピクセル）

高さ
height
Int
641–1024

キャンバスの高さ（ピクセル）

色
color
Color
[1,1,1,1]—

塗りの色（入力ポート未接続時に使用）

素材ID
material_id
Text
core:default—

サーフェース出力で、塗りつぶしたピクセルに付ける素材です

面ID
face_id
Text
surface:path-fill—

サーフェース出力で、塗り部分がどの面に属するかを示すIDです

面の高さ
surface_height
Float
0.550–1 / step 0.01

塗り部分の高さです。大きいほど出っ張った面として扱います

くぼみの暗さ
surface_ao
Float
0.960–1 / step 0.01

塗り部分の暗さです。小さいほどくぼんだように暗くなります

ざらつき
surface_roughness
Float
0.750–1 / step 0.01

光を当てた時の質感です。大きいほどつやが弱い面になります

概要

  • バージョン: 1
  • ジェネレーター: はい（is_generator: true）

アルゴリズム

  1. path_stroke と同じ rasterize_subpath パイプラインでアウトライン座標列を生成（PP 補正は無効）
    • セグメント接合点での .5,.5 角ピクセル復元も自動的に適用
  2. アウトラインの各行（y ライン）で x の最小値・最大値を算出
  3. 各行の min_x から max_x まで全ピクセルを塗りつぶし（アウトラインを含む）

開いたサブパスはスキップされます（closed: true のサブパスのみ塗りつぶし）。

使用例

基本的な塗りつぶし

[BezierPath] → path → [PathFill] → output → [Preview]

ストロークと塗りつぶしの合成

[BezierPath] → path → [PathFill]   → output → [Blend] → [Preview]
              → path → [PathStroke] → output ↗

サーフェースとして使う

[BezierPath] → path → [PathFill] → surface → [Surface Light Preview]

material_id を石や金属に変えると、同じ塗り形状でも素材ID付きのサーフェースとして扱えます。

注意事項

  • アウトラインが3点未満のパスでは空画像を返します
  • パス未接続時も空画像と空サーフェースを返します
  • サーフェース関連のパラメータはインスペクターの「サーフェース関連」に折りたたまれます
  • .5,.5 アンカーポイントの角ピクセル復元は rasterize_subpath 内部で自動的に処理されるため、正方形・三角形等の形状で一貫した塗りつぶし結果が得られます
Back to Node List
Path Fill — PixPipeline Node Reference