asset-format-bridge

Asset Format Bridge Skill

Convert and transport assets between ComfyUI (image/DTX), Blender (mesh/texture), and Godot (GLTF scene) environments.

Format Priority for This Pipeline

Core Conversion Tools

Image Format Conversion

from PIL import Image
from pathlib import Path

def convert_image(src: Path, dst_format: str = "PNG", size: tuple[int,int] = None, quality: int = 95) -> Path:
    """Convert image to target format, optional resize."""
    img = Image.open(src)
    if size:
        img = img.resize(size, Image.LANCZOS)
    if img.mode in ("RGBA", "P") and dst_format in ("JPG", "JPEG"):
        img = img.convert("RGB")
    out = src.with_suffix(f".{dst_format.lower()}")
    img.save(out, format=dst_format, quality=quality)
    return out

Texture Pack Generation (ComfyUI → 3D)

from PIL import Image, ImageDraw
from pathlib import Path

def generate_texture_pack(diffuse_path: Path, output_dir: Path = None) -> dict[str, Path]:
    """Generate albedo + normal + roughness texture set from a single diffuse.
    
    For pipeline: ComfyUI output → projection-ready texture set for Blender/Godot.
    """
    output_dir = output_dir or diffuse_path.parent
    diffuse = Image.open(diffuse_path).convert("RGB")
    
    base = diffuse_path.stem
    textures = {}
    
    # Albedo (diffuse as-is)
    albedo = output_dir / f"{base}_albedo.png"
    diffuse.save(albedo)
    textures["albedo"] = albedo
    
    # Normal map approximation (Sobel on diffuse)
    import numpy as np
    arr = np.array(diffuse, dtype=np.float32)
    gray = 0.299*arr[:,:,0] + 0.587*arr[:,:,1] + 0.114*arr[:,:,2]
    
    sobel_x = np.gradient(gray, axis=1)
    sobel_y = np.gradient(gray, axis=0)
    normal_z = np.sqrt(1 - np.clip(sobel_x**2 + sobel_y**2, 0, 1))
    normal = np.stack([sobel_x, sobel_y, normal_z], axis=-1)
    normal = ((normal + 1) / 2 * 255).astype(np.uint8)
    normal_map = Image.fromarray(normal, mode="RGB")
    normal_path = output_dir / f"{base}_normal.png"
    normal_map.save(normal_path)
    textures["normal"] = normal_path
    
    return textures