マスク分散

名前	型	説明
マスク mask	Image 必須	スタンプの中心位置を選ぶマスクです。スタンプ本体は範囲外へはみ出す場合があります
スタンプ stamp	Image	各点に配置する画像（未接続時は1pxドット）

名前	型	説明
画像 output	Image	生成された分散画像

パラメータ

名前	型	既定値	範囲	説明・選択肢
数 count	Int	16	1–4096	配置するオブジェクト数
シード seed	Int	0	0–99999	配置を再現するための乱数シード
しきい値 threshold	Float	0.5	0–1 / step 0.01	配置対象として扱う最小マスク値
Alphaを使う alpha_enabled	Bool	true	—	マスクの明るさではなくアルファを使って判定
反転 invert	Bool	false	—	マスクの反対側の領域に分散配置
色 color	Color	[1,1,1,1]	—	スタンプ未接続時のドット色
ランダム反転 random_flip	Bool	false	—	スタンプごとにランダムで左右・上下反転します
ランダム回転 random_rotate	Bool	false	—	スタンプごとに90°単位でランダム回転します
大きさのばらつき scale_jitter	Float	0	0–1 / step 0.05	スタンプごとの大きさのばらつきです（0で全部同じ大きさ）
明るさのばらつき brightness_jitter	Float	0	0–1 / step 0.05	スタンプごとの明るさのばらつきです（0で全部同じ明るさ）

マスクのしきい値を通った画素からスタンプの中心位置を一様に選ぶノードです。草むら・星空・石ころ・飛沫のような「同じ素材の自然な散布」を、1枚のスタンプと範囲マスクから量産します。

自然に見せる鍵はばらつきパラメータ: random_flip + scale_jitter 0.3前後 + brightness_jitter 0.2前後で「コピペ感」が消える
範囲マスクの作り方で表現が決まる: path_mask で地面の形に草を、 coordinates(Y グラデ)をしきい値で切って配置可能領域を上下に限定する、など
mask値は密度の重みではありません。しきい値を通った候補は同じ確率で選ばれます。 RGBの明るさを使う時は alpha_enabled=false にします
seed を seed_range で振れば散り方のバリエーション比較ができる
スタンプ未接続なら1pxドット: 星空・砂利はこれで十分なことも多い

普通の使い方
- PathMask の出力を mask に入れる
- count で数を決める
- seed を変えて散り方を変える
しきい値
- 0.5 なら半分以上のマスク値の場所に置く
- PathMask のような白+アルファのマスクなら、そのままで問題ない
- 通過後の値の大小は抽選確率へ影響しない
反転
- オンにすると、塗られていない側に配置する

[MultiPathEditor] → [PathMask] → mask → [MaskScatter] → [Preview]

[PathMask] → [MaskScatter(count:32, color:白)] → [Preview]

[PixelCanvas] → mask → [MaskScatter]

草・石・星などを1つのスタンプから量産する場合:

[草スタンプ] → stamp → [MaskScatter(random_flip:on, scale_jitter:0.4, brightness_jitter:0.3)]

同じ seed なら結果は毎回同じです（決定論的）。