Nodes/ComfyUI_KubaNodes/kubakub scene walkthrough
ComfyUI Node

kubakub scene walkthrough

Makes a previz video of the projection as someone walking past would see it: a camera walks through the audience along keyframes while the matrix (a still or video frames, frame i of the walk shows matrix frame i, looping) is projected onto the model. Optional background image / frames behind the building. Output: IMAGE frames (-> Create Video / Save Video). The camera views are kept on disk: a changed path or matrix renders only new views (25 per Blender job).

By kubakubkub·Created 15 days ago·Updated 3 days ago· 9
kubakub scene walkthrough
  • scene
  • matrix
  • background
  • clay_color
  • frames
  • report
  • fps
  • shadow
◄path-15, 25, 1.7 0, 15, 1.7 15, 10, 1.7►
◄seconds8.0►
◄fps25►
◄lens_mm24►
◄width960►
◄height540►
◄ambient0.15►
◄gain1.00►
◄physical1.00►
◄shaderclay►
Categorykubakub/3d/scene

Inputs (14)

NameTypeDefaultDescription
sceneKUBA_SCENEFrom kubakub scene render.
pathSTRING-15, 25, 1.7 0, 15, 1.7 15, 10, 1.7Keyframes, one per line: x along the wall from the frame centre, distance from the wall, eye height[, look x, look height] (m). Spread evenly over the walk, smooth spline between them. No look = the frame centre.
secondsFLOAT8.00.1–600Length of the walk in seconds (frames = seconds x fps).
fpsINT251–120Frames per second of the video. A whole number typed here: the decimal fps output of other nodes does not connect to it. The 'fps' output of this node passes it on (-> Create Video).
lens_mmFLOAT246–300Walking camera lens (36 mm sensor); 20 = wide, 35 = natural.
widthINT96064–8192Video width in pixels.
heightINT54064–8192Video height in pixels.
ambientFLOAT0.150–1Brightness of the unlit building (clay) around the projection.
gainFLOAT1.000–4Brightness of the projected image; 1 = as it is, 2 = twice as bright.
physicalFLOAT1.000–11 = surfaces hit at a steep angle or far away get darker, as with a real projector; 0 = flat.
matrixoptIMAGEMatrix image or frames. Nothing connected: the walk past the clay model, without a picture.
backgroundoptIMAGEBehind the building: a still or frames (looping), scaled to cover the view. Default black.
clay_coloroptCOLOR#f2f2f2Colour 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.
shaderoptCOMBOclayHow 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.

Outputs (4)

NameTypeDescription
framesIMAGEThe walk as video frames (-> Create Video / Save Video).
reportSTRINGFrame count, time, views rendered new or from the cache, and the projection shadow share.
fpsFLOATThe frames per second of this walk (-> Create Video, fps).
shadowMASKPer frame: 1 where the audience sees the building but the projector does not reach it (as on kubakub scene preview).