Path Array

Place objects along a bezier path with various distribution modes

intermediate
Since P00

Input Ports

Path

オブジェクトを配置するベジェパス

Path
Stamp

各点に配置する画像(未接続時は1pxドット)

Image

Output Ports

Image

配列が配置された画像

Image

Parameters

NameTypeDefaultDescription
WidthInt64キャンバスの幅
HeightInt64キャンバスの高さ
ScopeEnum`すべて`全サブパスに適用するか、1 本だけに適用するか
Sub-pathInt0個別モード時に使うサブパス
CountInt5各サブパスに配置する数
ModeEnumEqual配置方法(下記参照)
SeedInt0Random/Scatter用乱数シード
SpreadInt4Scatter用の最大偏差ピクセル数
Scatter SideEnumBothScatter時に両側 / 内側 / 外側のどちらへ散らすか
Fill DirectionEnumForwardFill時の配置方向(始点→終点 / 終点→始点)
Fill StepInt1Fill時に何ピクセルおきに配置するか
ColorColorドットの色(スタンプ未接続時)
Pixel PerfectBoolfalseピクセルパーフェクトモード
PP モードEnumRemoveCornerPP補正方式
閉パス外積Boolfalse閉パスの外積ベースエッジ削除
閉パス削除側EnumOuter内側/外側エッジのどちらを削除

配置モード

モード説明
**Equal**(等間隔)Pathを均等分割して配置。閉じPathでは始点=終点の重複を自動回避
**Fill**(順次配置)ラスタライズ済みピクセル列を順に使用。`fill_direction` で向き、`fill_step` で間引き間隔を指定可能
**Random**(ランダム)Path上のランダムな位置に配置。シードで再現可能
**Scatter**(分散)Path周辺にランダムに分散配置。`spread` で偏差、`scatter_side` で両側 / 内側 / 外側を制御。開いたサブPathでは `Inside` / `Outside` を指定しても `Both` 相当で扱う

pixel-perfectモード

  • オン: rasterize_subpath でラスタライズ済みピクセル座標列を基準に配置。Pathストロークと同じPP補正オプション(対角優先/直線優先/角削除/角保持、閉Path外積/削除側)が使用可能
  • オフ: ベジェ曲線の数学的サンプリング(sample_sub_path)でPlacement positionを計算

サブPathの扱い

  • 対象サブPath = すべて

- 各サブPathに count 個ずつ同じルールでplaces

  • 対象サブPath = 個別

- 指定した 1 本のサブPathだけにplaces

  • sub_path_index の上限は入力PathのサブPath数に合わせて UI が更新します

Usage Examples

等間隔配置

[BezierPath] → path → [PathArray(mode:Equal, count:10)] → [Preview]

ランダム分散

[MultiPath] → path → [PathArray(mode:Scatter, count:20, spread:8, seed:42)] → [Preview]

ピクセルパーフェクト配置

[BezierPath] → path → [PathArray(pixel_perfect:ON, pp_mode:RemoveCorner)] → [Preview]

1 本だけ選んで配置

[MultiPath] → path → [PathArray(sub_path_scope:Single, sub_path_index:1)] → [Preview]

Related Nodes

bezierpath
preview
multipath
Path Array — PixPipeline Node Reference