Preview Tiles

The most honest node in this pack, and also the smallest. Preview Tiles just repeats an image into a grid so you can stare at the seams and decide whether your material actually tiles. You just ran the PBR Generator with seamless_mode on - this is how you check whether the seams actually vanished before you export a texture pack that's broken in a real renderer.

How it works

Under the hood it's embarrassingly simple: torch.tile repeats your image tile_x times across and tile_y times down, clamps the values, and stacks the result back into a batch. Then it saves a uniquely-named PNG to ComfyUI's temp folder and hands it to the UI as a preview image. There's no GPU inference, no model loading, no weights - a plain tensor op that runs in milliseconds even on CPU.

The key detail: it has no graph outputs (RETURN_TYPES is empty). It's a pure preview node - its job is to show you the tiled result in the canvas, not to pass data downstream. Wire it in wherever you're curious, and its only outputs are the image previews.

The inputs

Just two, and both have sane defaults:

• image - any IMAGE tensor. Wire it to the BaseColor, ORM, or Normal output of the PBR Generator, or drop in any texture you're considering.
• tile_x and tile_y - grid size, 1 to 10 each, default 3×3. Three by three is usually enough to spot a seam; crank it up if the pattern is subtle or large-scale.

When to reach for it

Right after a PBR generation, basically. Run your BaseColor or ORM through it and look for three things: a bright or dark seam at the tile boundaries (your seamless_mode isn't doing its job), visible "make-up lines" where the wrap didn't blend, and whether the repeating pattern is actually aesthetically acceptable at 3×3 - some textures only look tiled when you see the repetition. If a seam shows up, that's your cue to switch seamless_mode in the generator to mirror or replicate and rerun.

It's also handy as a general-purpose texture inspection tool even outside this pack - a quick grid check on any image, from an icon you're thinking about using as a pattern to a photo you're considering for a floor material. The cost is one node and a fraction of a second.

Installing it

It ships in the same pack as the generators, so you get it for free with either of them:

cd ComfyUI/custom_nodes
git clone https://github.com/qornflex/ComfyUI-QFX-PBRGenerator
pip install -r ComfyUI-QFX-PBRGenerator/requirements.txt

Restart ComfyUI and it's under QFX as "Preview Tiles". No models, no extra dependencies beyond the pack's pillow/numpy/opencv-python/scipy set. It's the unglamorous but genuinely useful bit of the pack - the one that keeps you from exporting a material you can't tile.