Three Scene
The container that decides what's drawn and what's behind it
- root
- environment
- scene
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.
colorfills behind everything with the hex inbackground(#111111near black,#ffffffwhite);transparentdraws 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_enabledfades 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_near10 leaves a subject at the origin untouched;fog_far100 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.
Inputs (8)
| Name | Type | Default | Description |
|---|---|---|---|
| background | STRING | #111111 | Backdrop colour as hexadecimal. #111111 is near black, #ffffff white. Ignored when the mode is transparent. |
| background_mode | COMBO | color | 'color' fills the backdrop with the colour above. 'transparent' draws no backdrop at all. |
| fog_enabled | BOOLEAN | false | `true` fades distant objects toward the fog colour; `false` draws everything crisp. |
| fog_color | STRING | #111111 | Colour distant objects fade into, as hexadecimal. #111111 matching the background hides the horizon. |
| fog_near | FLOAT | 10.00–1000000000 | Distance the fade starts at. 10.0 leaves a subject at the origin untouched. |
| fog_far | FLOAT | 100.00.0001–1000000000 | Distance objects are fully fog by. 100.0 suits a scene tens of units deep. |
| rootopt | THREE_OBJECT | The object holding the scene, usually a Three Group. Left unwired the scene is empty. | |
| environmentopt | THREE_ENVIRONMENT | Surroundings for every physical material to reflect, from Three Environment. Left unwired, metal has nothing to mirror and renders nearly black. |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| scene | THREE_SCENE | The scene, for the scene socket on Three App. |