augment-lib-augment-ComfyUI/py/preview.py

# "Design-focused node suite for ComfyUI."
# Copyright 2026 Augment Studio
# Augmentstudio.app

import json
import os
import numpy as np
from PIL import Image
from PIL.PngImagePlugin import PngInfo

import folder_paths


class AugmentPreviewImage:
    """Previews images in the ComfyUI UI without saving to the output folder."""

    @classmethod
    def INPUT_TYPES(cls):
        return {
            "required": {
                "images": ("IMAGE",),
            },
            "optional": {
                "trigger": ("TRIGGER",),
            },
        }

    RETURN_TYPES = ("IMAGE", "AUGMENT_JSON", "TRIGGER")
    RETURN_NAMES = ("image", "json", "trigger")
    OUTPUT_NODE = True
    FUNCTION = "preview"
    CATEGORY = "Augment/Image"

    def preview(self, images, trigger=None):
        results = []
        for batch_idx in range(images.shape[0]):
            i = 255.0 * images[batch_idx].cpu().numpy()
            img = Image.fromarray(np.clip(i, 0, 255).astype(np.uint8))

            filename = f"augment_preview_{batch_idx:05d}.png"
            subfolder = "augment_temp"
            temp_dir = folder_paths.get_temp_directory()
            full_dir = os.path.join(temp_dir, subfolder)
            os.makedirs(full_dir, exist_ok=True)
            img.save(os.path.join(full_dir, filename), compress_level=1)

            results.append({
                "filename": filename,
                "subfolder": subfolder,
                "type": "temp",
            })

        json_result = json.dumps({"node": "AugmentPreviewImage", "images": results, "count": len(results)})
        return {"ui": {"images": results}, "result": (images, json_result, "done")}


class AugmentSaveImage:
    """Saves images to the output folder with a customizable filename prefix."""

    @classmethod
    def INPUT_TYPES(cls):
        return {
            "required": {
                "images": ("IMAGE",),
                "filename_prefix": ("STRING", {"default": "Augment"}),
            },
            "optional": {
                "trigger": ("TRIGGER",),
            },
        }

    RETURN_TYPES = ("IMAGE", "AUGMENT_JSON", "TRIGGER")
    RETURN_NAMES = ("image", "json", "trigger")
    OUTPUT_NODE = True
    FUNCTION = "save"
    CATEGORY = "Augment/Image"

    def __init__(self):
        self.output_dir = folder_paths.get_output_directory()
        self.type = "output"
        self.compress_level = 4

    def save(self, images, filename_prefix="Augment", trigger=None):
        full_output_folder, filename, counter, subfolder, filename_prefix = (
            folder_paths.get_save_image_path(
                filename_prefix, self.output_dir, images.shape[2], images.shape[1]
            )
        )

        results = []
        for batch_idx in range(images.shape[0]):
            i = 255.0 * images[batch_idx].cpu().numpy()
            img = Image.fromarray(np.clip(i, 0, 255).astype(np.uint8))

            metadata = PngInfo()
            file = f"{filename}_{counter + batch_idx:05d}.png"
            img.save(
                os.path.join(full_output_folder, file),
                pnginfo=metadata,
                compress_level=self.compress_level,
            )

            results.append({
                "filename": file,
                "subfolder": subfolder,
                "type": self.type,
            })

        json_result = json.dumps({"node": "AugmentSaveImage", "images": results, "count": len(results), "prefix": filename_prefix})
        return {"ui": {"images": results}, "result": (images, json_result, "done")}


class AugmentPreviewMask:
    """Previews a mask in the ComfyUI UI without saving to the output folder."""

    @classmethod
    def INPUT_TYPES(cls):
        return {
            "required": {
                "mask": ("MASK",),
            },
            "optional": {
                "trigger": ("TRIGGER",),
            },
        }

    RETURN_TYPES = ("MASK", "AUGMENT_JSON", "TRIGGER")
    RETURN_NAMES = ("mask", "json", "trigger")
    OUTPUT_NODE = True
    FUNCTION = "preview"
    CATEGORY = "Augment/Image"

    def preview(self, mask, trigger=None):
        results = []
        for batch_idx in range(mask.shape[0]):
            m = 255.0 * mask[batch_idx].cpu().numpy()
            img = Image.fromarray(np.clip(m, 0, 255).astype(np.uint8), mode="L")

            filename = f"augment_mask_preview_{batch_idx:05d}.png"
            subfolder = "augment_temp"
            temp_dir = folder_paths.get_temp_directory()
            full_dir = os.path.join(temp_dir, subfolder)
            os.makedirs(full_dir, exist_ok=True)
            img.save(os.path.join(full_dir, filename), compress_level=1)

            results.append({
                "filename": filename,
                "subfolder": subfolder,
                "type": "temp",
            })

        json_result = json.dumps({"node": "Preview Mask", "images": results, "count": len(results)})
        return {"ui": {"images": results}, "result": (mask, json_result, "done")}


class AugmentPreviewAny:
    """Displays the string representation of any value in the ComfyUI UI."""

    @classmethod
    def INPUT_TYPES(cls):
        return {
            "required": {
                "source": ("*", {"forceInput": True}),
            },
            "optional": {
                "trigger": ("TRIGGER",),
            },
        }

    RETURN_TYPES = ("*", "AUGMENT_JSON", "TRIGGER")
    RETURN_NAMES = ("value", "json", "trigger")
    OUTPUT_NODE = True
    FUNCTION = "preview"
    CATEGORY = "Augment/Utils"

    @classmethod
    def VALIDATE_INPUTS(cls, **kwargs):
        return True

    def preview(self, source=None, trigger=None):
        if isinstance(source, str):
            text = source
        elif isinstance(source, (int, float, bool)):
            text = str(source)
        elif source is None:
            text = "None"
        else:
            try:
                text = json.dumps(source, indent=2, default=str)
            except Exception:
                try:
                    text = str(source)
                except Exception:
                    text = "Value exists but could not be serialized"

        json_result = json.dumps({"node": "AugmentPreviewAny", "value": text, "type": type(source).__name__})
        return {"ui": {"text": [text]}, "result": (source, json_result, "done")}