Nodes/SP-Nodes/ScatterParams
ComfyUI Node

ScatterParams

The recipe for scattering copies across a canvas

By bananasss00·Created 2 years ago·Updated 5 days ago· 20
ScatterParams
    • SCATTER_PARAMS
    count5
    scale0.7
    x_min-1
    x_max-1
    y_min-1
    y_max-1
    rotate_degrees_delta25

    ScatterParams doesn't touch an image itself - it produces a SCATTER_PARAMS object, a bundle of settings meant to be handed to a scatter or collage node elsewhere in SP-Nodes that actually does the placing. Think of it the way you'd think of a settings object in any node-based tool: this node's whole job is to package "how many copies, how big, where, and how rotated" into one wire, so the node that consumes it doesn't need eight separate inputs of its own.

    What each field controls

    count (1–50, default 5) is how many copies get placed. scale (0.1–1, default 0.7) sets how large each placed copy is relative to its source. rotate_degrees_delta (0–180, default 25) bounds how much random rotation each placement gets - a small delta keeps things looking roughly upright, a large one lets copies land at wild angles.

    The four range fields - x_min, x_max, y_min, y_max - all default to -1 with a max of 10000. Reading that default against the max, -1 looks like a sentinel for "not set, figure it out from the canvas" rather than a literal negative coordinate - that's the standard convention this kind of field uses in node-based tools generally, though SP-Nodes' own README doesn't spell it out explicitly since this node doesn't get its own screenshot there. If you want copies confined to part of a canvas rather than the whole thing, that's what these four are for; leave them at -1 to let the consuming node use its own bounds.

    The fields worth setting

    • count - how many placements you're generating parameters for.
    • scale - relative size of each copy, 0.1 to 1.
    • x_min/x_max/y_min/y_max - leave at -1 for full-canvas placement, or set explicit bounds to confine the scatter to a region.
    • rotate_degrees_delta - how much random rotation variance to allow, in degrees.

    Output: SCATTER_PARAMS - not directly useful on its own; it needs to reach a scatter/composite node further down the graph, or feed into ScatterParamsBatch if you're combining several scatter recipes for different sets of images.

    Installing SP-Nodes

    Manager: search "SP-Nodes," install, restart. Manual:

    cd ComfyUI/custom_nodes
    git clone https://github.com/bananasss00/ComfyUI-SP-Nodes
    

    Restart afterward. No model download, no extra dependency - this node just packages a handful of numbers.

    Where to be careful

    Because this node produces a settings bundle and nothing visible on its own, the most common confusion is expecting to see an effect just from running it - you won't, until it's wired into whatever actually consumes SCATTER_PARAMS. If your graph seems to do nothing after adding this node, check that the output is actually connected downstream before assuming anything's broken.

    The other thing worth flagging honestly: this node's exact placement math (how count copies get distributed within the x/y range, whether they're allowed to overlap, how rotate_degrees_delta gets applied per copy) isn't documented in the README, and I don't have visibility into it beyond what the field names and ranges suggest. Treat the descriptions above as what the schema tells you with confidence, and expect some trial and error to learn the exact visual behavior once it's wired into a real scatter workflow.

    CategorySP-Nodes

    Inputs (7)

    NameTypeDefaultDescription
    countINT51–50
    scaleFLOAT0.70.1–1
    x_minINT-1-1–10000
    x_maxINT-1-1–10000
    y_minINT-1-1–10000
    y_maxINT-1-1–10000
    rotate_degrees_deltaINT250–180

    Outputs (1)

    NameTypeDescription
    SCATTER_PARAMSSCATTER_PARAMS