ComfyUI-QFX-PBRGenerator

A custom node suite for ComfyUI that allows you to generate a full suite of PBR (Physically Based Rendering) texture maps from a single source image.

---

🚀 Features

• One-Click PBR: Convert any 2D image (AI-generated or photographed) into a full material suite.
• AI-Powered Delighting (Advanced): Utilize Marigold appearance and lighting models to strip baked-in shadows and highlights, resulting in clean, professional-grade Albedo maps.
• Automated Map Extraction: Generates BaseColor, Normal, Roughness, Metallic, Ambient Occlusion, and Height maps in one pass.
• Seamless Tiling: Built-in support for generating seamless textures using various tiling modes (Mirror, Replicate, Seamless).

---

🛠 Installation

Manual Installation

1. Navigate to your ComfyUI custom_nodes folder:

   cd ComfyUI/custom_nodes
   

2. Clone this repository:

   git clone https://github.com/qornflex/ComfyUI-QFX-PBRGenerator
   

3. Install dependencies:

   Using your ComfyUI venv:

   cd ComfyUI
   .venv\Scripts\activate
   pip install -r .\custom_nodes\ComfyUI-QFX-PBRGenerator\requirements.txt
   

   Using Windows Portable Version:

   cd ComfyUI
   .\python_embeded\python.exe -m pip install -r .\ComfyUI\custom_nodes\ComfyUI-QFX-PBRGenerator\requirements.txt
   

4. Restart ComfyUI.

---

📦 Nodes

PBR Generator

The standard node for one-click texture processing. It uses AI to analyze your image and generate a full PBR Texture set.

Input	Description
image	The source texture or photo to be converted.
texture_name	Prefix for the saved filenames (e.g., "Stone_Wall").
seamless_mode	Tiling options: off, seamless, mirror, or replicate.
normal_strength	Multiplier for the depth intensity of the Normal map.
normal_invert_y	Toggles Y-channel direction (DirectX vs. OpenGL).
roughness_min/max	Remaps the grayscale range to define surface glossiness.
metallic_threshold	Sensitivity for auto-detecting metal vs. dielectric areas.
ao_blur/strength	Controls the shadow depth and softness in crevices.

PBR Generator (Advanced)

An enhanced version of the generator designed to work alongside Marigold appearance/lighting estimators. It provides granular control over gamma correction to output a delighted albedo map.

Input	Description
image	Your primary source texture.
marigold_appearance	Connect the "appearance" output from a Marigold node.
marigold_lighting	Connect the "lighting" estimation from a Marigold node.
albedo_source	Choose to derive Base Color from appearance or lighting.
gamma_albedo	Brightness curve adjustment for the Base Color map.
gamma_metal_rough	Gamma correction specifically for Metallic and Roughness maps.
gamma_lighting_ao	Gamma correction for the Ambient Occlusion and Lighting-based maps.
roughness_min/max	Precision remapping for surface micro-detail and "wetness" levels.
metallic_min/max	Precision remapping for the intensity of metallic reflections.
save_textures	Toggle automatic export of all maps to the ComfyUI output folder.

---

⚖️ Credits & Acknowledgments

This node is a port of the Material-Map-Generator repository.

• Original Logic & Algorithm: Joey Ballentine
• ComfyUI Implementation: qornflex

---

📄 License

This project follows the licensing of the original Material-Map-Generator where applicable. Please refer to the original repository for core logic licensing details.