ComfyUI Node Runs on cloud

Three Scene

The container that decides what's drawn and what's behind it

By WASasquatch·Created 3 years ago·Updated 4 days ago· 1,844
Three Scene
  • root
  • environment
  • scene
background#111111
background_modecolor
fog_enabledfalse
fog_color#111111
fog_near10.0
fog_far100.0

In the WAS Node Suite Three family, all your meshes and lights float around as loose objects until one node gathers them into a world: WASThreeScene. It's the container that says "these are the things drawn, and here's what sits behind them." You can wire an object straight into it, but the intended pattern is to bundle your meshes and lights into a Three Group and drop that single group onto the scene's root.

What it is

A THREE_SCENE value that carries everything to be drawn plus the backdrop settings. The root input takes the object holding the scene - "usually a Three Group," per the tooltip. Left unwired, the scene is empty, which sounds obvious until you've stared at a black render wondering where your mesh went. Check that the root is actually connected before you blame the camera.

The inputs that matter

  • root - the object that holds everything. Wire your group (meshes + lights) here.
  • background and background_mode - the backdrop. color fills behind everything with the hex in background (#111111 near black, #ffffff white); transparent draws no backdrop at all, so the page shows through and your render comes out with real alpha.
  • fog_enabled / fog_color / fog_near / fog_far - distance fog. fog_enabled fades distant objects toward the fog color, which reads as depth and hides the far edge of a ground plane. For a floor that stretches to the horizon, a fog color matching the background hides the seam where it ends. fog_near 10 leaves a subject at the origin untouched; fog_far 100 suits a scene tens of units deep.
  • environment - the surroundings every Physical material reflects. Here's the gotcha the tooltip warns about: wire nothing in and metal has nothing to mirror, so it renders nearly black. If your chrome ball looks dead, this socket is why.

Where it fits

The spine of every Three workflow runs through this node:

geometry + material → Three Mesh → Three Group (with a Three Light) → Three Scene root → Three App (with a camera) → Three Render or Three Path Trace Render

Because Three Group aggregates, you can build half a dozen meshes and lights and keep them all in one tidy root. And because the scene is a value on the wire, you can branch it - render the same scene twice at different sizes, or once with fog and once without, just by changing the Scene node feeding each render.

Install

WASThreeScene is one of 43 Three nodes in WAS Node Suite v3. Install through ComfyUI Manager (search WAS Node Suite v3) or:

cd ComfyUI/custom_nodes
git clone https://github.com/WASasquatch/was-node-suite-comfyui.git

Restart after. Requires ComfyUI 0.14.0+ and Python 3.10+, nothing extra installs. If the node's missing, the whole family is gated by features.threejs in <ComfyUI user dir>/was-node-suite/config.yaml - on by default in current releases, but set it true if it isn't and restart.

CategoryWAS Suite/Three

Inputs (8)

NameTypeDefaultDescription
backgroundSTRING#111111Backdrop colour as hexadecimal. #111111 is near black, #ffffff white. Ignored when the mode is transparent.
background_modeCOMBOcolor'color' fills the backdrop with the colour above. 'transparent' draws no backdrop at all.
fog_enabledBOOLEANfalse`true` fades distant objects toward the fog colour; `false` draws everything crisp.
fog_colorSTRING#111111Colour distant objects fade into, as hexadecimal. #111111 matching the background hides the horizon.
fog_nearFLOAT10.00–1000000000Distance the fade starts at. 10.0 leaves a subject at the origin untouched.
fog_farFLOAT100.00.0001–1000000000Distance objects are fully fog by. 100.0 suits a scene tens of units deep.
rootoptTHREE_OBJECTThe object holding the scene, usually a Three Group. Left unwired the scene is empty.
environmentoptTHREE_ENVIRONMENTSurroundings for every physical material to reflect, from Three Environment. Left unwired, metal has nothing to mirror and renders nearly black.

Outputs (1)

NameTypeDescription
sceneTHREE_SCENEThe scene, for the scene socket on Three App.