Yotsuba Games
Back to Node List

Mask Scatter

mask_scatter

Scatter stamps randomly inside a mask image, with optional per-stamp flip, rotation, scale, and brightness variation

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
マスク
mask
Image
Required
配置範囲として使うマスク画像
スタンプ
stamp
Image
各点に配置する画像（未接続時は1pxドット）

Output Ports

NameTypeDescription
画像
output
Image
生成された分散画像

Parameters

NameTypeDefaultRangeDescription / Options
数
count
Int
161–4096

配置するオブジェクト数

シード
seed
Int
00–99999

配置を再現するための乱数シード

しきい値
threshold
Float
0.50–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
00–1 / step 0.05

スタンプごとの大きさのばらつきです（0で全部同じ大きさ）

明るさのばらつき
brightness_jitter
Float
00–1 / step 0.05

スタンプごとの明るさのばらつきです（0で全部同じ明るさ）

概要

  • バージョン: 1

使い方

  • 普通の使い方

    • PathMask の出力を mask に入れる
    • count で数を決める
    • seed を変えて散り方を変える

  • しきい値

    • 0.5 なら半分以上のマスク値の場所に置く
    • PathMask のような白+アルファのマスクなら、そのままで問題ない

  • 反転

    • オンにすると、塗られていない側に配置する

使用例

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 なら結果は毎回同じです（決定論的）。

注意事項

  • 同じピクセル位置には重複して置きません
  • スタンプ画像自体は重なることがあります
  • 出力サイズは入力マスク画像と同じです
  • ばらつきはすべて seed から決定論的に導出されます
Back to Node List
Mask Scatter — PixPipeline Node Reference