PixaromaHelp
Help › Nodes › Image

Seamless Material Pixaroma

Turns a seamless tile into a 3D material for Blender.

In ComfyUI: double-click an empty spot on the canvas and type Seamless Material Pixaroma.

What it does

A 3D program needs more than a picture to make a surface look real. It needs to know how rough the surface is, where it is high and low, and which way each bump faces the light. This node makes those maps from your seamless tile: color, roughness, normal, height and AO.

Every map is seamless too, because all the math wraps around the edges. So the material repeats on a floor or a wall with no line. No model and no download: it is plain image math and takes about a second.

Where it goes

Put it after VAE Decode of a seamless tile made with Seamless Tile Pixaroma. A tile you already have works too, from Load Image. Put Seamless Preview Pixaroma on any output to see that map repeated, with its PASS / WARN / FAIL edge check.

With save_files on, new maps are saved in a new folder inside ComfyUI's output folder. materials/stone saves output/materials/stone_001/stone_color.png, stone_roughness.png, stone_normal.png, stone_height.png and stone_ao.png. New maps go to the next number, so the highest number is the newest. A Run with nothing changed saves nothing new.

In Blender

Blender's Node Wrangler loads all five files in one step and connects four of them. It comes with Blender but starts switched off.

Once
In Edit > Preferences > Add-ons, search Node Wrangler and tick it.
Step 1
Add a plane. Open the Shading tab and click New to give it a material.
Step 2
Click the Principled BSDF node and press Ctrl+Shift+T.
Step 3
Open the folder the node saved, press A to select all five files, and click Add Principled Texture Setup.
Step 4
In the Mapping node, set Scale X and Y to 4. The tile now repeats 4 times each way.

What Node Wrangler connects

  • Color goes to Base Color, roughness to Roughness.
  • The normal map goes through a Normal Map node.
  • The height goes through a Displacement node and works as bump, in Cycles and EEVEE.
  • The AO file is loaded but left unconnected: Blender makes its own shadows.
  • A Mapping node is added in front of every texture. Its Scale sets how often the tile repeats.
  • Tested in Blender 5.2.2.

Good to know

The relief comes from the tile's brightness, so dark means deep. That is right for stone, bricks with dark gaps, wood planks, tiles and woven fabric. It is wrong where a dark colour is not deeper: a dark red flower on a pale print becomes a hole. So use it on materials, not on printed patterns.

A tile that does not join gives maps that do not join either: check the tile first.

Other shapes in Blender: the default cube turns the pattern sideways on its side faces, so bricks and planks lie on their side. Fix it in Edit Mode: press A, then U and Cube Projection. On a UV Sphere set the Mapping Scale X to twice Y (8 and 4), because the picture goes all the way round but only from pole to pole. Its top and bottom squeeze together, as they do with any texture.

What you wire in

imageIMAGE
The seamless tile, for example from Seamless Tile Pixaroma and VAE Decode. A tile with an edge gives maps with the same edge.

The settings on the node

strengthnumberdefault 1
How deep the relief looks in the normal map. 1 suits most stone and wood. Above 2, stains and small dark spots start to look like pits. Only the normal map changes.
roughness_minnumberdefault 0.55
Roughness of the brightest parts. 0 = mirror, 1 = fully matte.
roughness_maxnumberdefault 0.9
Roughness of the darkest parts. Set both the same for one even roughness.
invert_heighton / offdefault off
Off: dark = deep (gaps between stones and planks). On: light = deep (light mortar between darker bricks).
normal_formatchoicedefault OpenGL (Blender)
OpenGL is what Blender reads. DirectX flips the green channel, for programs that read DirectX normal maps.
OpenGL (Blender)DirectX
save_fileson / offdefault on
On: new maps are saved as five PNG files in a new numbered folder inside ComfyUI's output folder. A Run with nothing changed saves nothing new. Off: nothing is saved.
save_totextdefault materials/stone
Folder and name inside ComfyUI's output folder. materials/stone saves output/materials/stone_001/stone_color.png, stone_roughness.png, stone_normal.png, stone_height.png and stone_ao.png. New maps go to the next number: the highest number is the newest.

What comes out

colorIMAGE
The tile itself (Base Color in Blender).
roughnessIMAGE
Grey roughness map: white = matte, black = shiny.
normalIMAGE
Normal map (blue-purple), the small relief for the light. OpenGL or DirectX as chosen.
heightIMAGE
Grey height map: white = high, black = deep. Blender's Displacement or Bump node.
aoIMAGE
Ambient occlusion: dark in the crevices. Blender renders its own shadows, so it is optional there.
Height is saved as a 16-bit PNG, so a displacement shows no steps. The workflow is stored in the color file, so you can drag it back into ComfyUI.

This is the help that comes with Pixaroma 1.4.261. Inside ComfyUI, select the node and click the orange ? above it to read the same help there.