ComfyUI Node
kubakub scene preview
Shows how the projection will look to the audience: the matrix (image or video frames) projected from the file's camera onto the model and seen from audience spots. Where the projector does not reach a surface the audience sees, it stays dark (projection shadow, also as a mask). The mapping is computed once per spot, so video frames are cheap. One Blender render per spot (cached).
kubakub scene preview
- scene
- matrix
- background
- clay_color
- viewer
- preview
- shadow
- views
- report
- scene
◄spots0, 20, 1.7
-15, 12, 1.7
12, 8, 1.7►
◄lens_mm20►
◄width1280►
◄height720►
◄ambient0.15►
◄gain1.00►
◄physical1.00►
◄shaderclay►
Categorykubakub/3d/scene
Inputs (13)
| Name | Type | Default | Description |
|---|---|---|---|
| scene | KUBA_SCENE | From kubakub scene render. | |
| spots | STRING | 0, 20, 1.7 -15, 12, 1.7 12, 8, 1.7 | One audience spot per line: x along the wall from the frame centre, distance from the wall, eye height (m). |
| lens_mm | FLOAT | 206–300 | Audience camera lens (36 mm sensor); 20 = wide, 35 = natural. |
| width | INT | 128064–8192 | Width of each audience view, in pixels. |
| height | INT | 72064–8192 | Height of each audience view, in pixels. |
| ambient | FLOAT | 0.150–1 | Brightness of the unlit building (clay) around the projection. |
| gain | FLOAT | 1.000–4 | Brightness of the projected image; 1 = as it is, 2 = twice as bright. |
| physical | FLOAT | 1.000–1 | 1 = surfaces hit at a steep angle or far away get darker, as with a real projector; 0 = flat. |
| matrixopt | IMAGE | Matrix image or frames (resized to the projection view if needed). Nothing connected: the clay views alone, without a picture. | |
| backgroundopt | IMAGE | Behind the building (still or frames, looping), scaled to cover the view. | |
| clay_coloropt | COLOR | #f2f2f2 | Colour of the clay: the building and its surroundings where no picture lands. Almost white by default; pick the stone's colour for a closer look. |
| shaderopt | COMBO | clay | How the model is drawn where no picture lands: clay, wireframe (its edges as lines in the clay colour, not dimmed by ambient) or clay with the edges on it. |
| vieweropt | KUBA_VIEWER | The audience spot of kubakub scene measure / audience viewpoint / project settings, one spot for all nodes. Connected: it replaces the typed 'spots' (one view from there). |
Outputs (5)
| Name | Type | Description |
|---|---|---|
| preview | IMAGE | Per spot all frames (spot-major batch). |
| shadow | MASK | Per spot: building the audience sees but the projector misses. |
| views | IMAGE | Per spot the clay view (no projection). |
| report | STRING | Per spot: how much of the view is building and how much of it the projector misses. |
| scene | KUBA_SCENE | The scene with these viewpoints (spots, lens, size) -> kubakub scene relight with camera = previz: the lit picture from the same spot. |