よつばゲームズ
ノード一覧に戻る

パス塗りつぶし

path_fill

閉じたベジェパスの内部を塗りつぶし、画像とサーフェースを出力します

下書き
解説あり

入力ポート

名前型説明
パス
path
Path
必須
塗りつぶすベジェパス
色
color
Color
塗りの色（接続時はパラメータより優先）

出力ポート

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

パラメータ

名前型既定値範囲説明・選択肢
幅
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 内部で自動的に処理されるため、正方形・三角形等の形状で一貫した塗りつぶし結果が得られます
ノード一覧に戻る
パス塗りつぶし — PixPipeline ノード解説