ComfyUI-Majoor-ImageOps

🎨 ComfyUI‑Majoor‑ImageOps

Advanced image processing nodes for ComfyUI with a centralized live preview module (no queue required), batch-first behavior, and comprehensive interop adapters.

---

✨ Features

• 📦 Batch-First Architecture: IMAGE inputs/outputs are treated as batches (frames friendly) - perfect for video and animation workflows
• 🛡️ Fail-Soft Interop: Unsupported upstream nodes don't break the graph or preview - graceful degradation
• 👁️ Live Preview Widget: Real-time preview on ImageOps nodes without queuing (single frontend module)
• 🎛️ Preview Pro UI (only on ImageOpsPreview):
  • 📊 Histogram analysis
  • 🌊 Waveform (luma/RGB)
  • 🎯 Vectorscope
  • 🦓 Zebra/False-color overlays
  • ↔️ A/B freeze + wipe comparison
• 🔀 Optional Bypass: All processing nodes expose bypass (boolean) - when enabled, the node returns input unchanged and live preview skips applying the operation

📋 Requirements

• ComfyUI: Version 0.2.0 or newer (v3 registry node format)
• Python: 3.10+ (3.11/3.12 recommended)
• Frontend: Modern browser with ES2022 support

---

📥 Installation

1. Clone/Place this folder in ComfyUI/custom_nodes/ComfyUI-Majoor-ImageOps
2. Restart ComfyUI
3. Hard refresh the browser: Ctrl+F5 (or Cmd+Shift+R on macOS)

---

🧩 Nodes (image/imageops)

🔧 Processing Nodes

| Node | Internal ID | Description | |------|-------------|-------------| | ImageOps Color Correct | ImageOpsColorAjust | Professional color correction with temperature, hue, brightness, contrast, saturation, and gamma controls | | ImageOps Blur | ImageOpsBlur | Gaussian blur with radius/sigma control and mask support | | ImageOps Channels | ImageOpsChannel | Extract and manipulate individual RGB/Alpha channels | | ImageOps Mask Convert | ImageOpsMaskConvert | Convert images and masks with selectable matte extraction, levels, and antialiasing | | ImageOps Resize/Crop | ImageOpsCrop | Interactive crop and resize with aspect ratio presets | | ImageOps Distort | ImageOpsDistort | iDistort-style displacement warp driven by source channels, external maps, masks, or internal procedural noise | | ImageOps Transform | ImageOpsTransform | Translate, rotate, scale with filter options (nearest/bilinear/bicubic) | | ImageOps Corner Pin | ImageOpsCornerPin | Perspective corner pinning with batched homography warp, bicubic filtering, supersampling, and alpha-safe edges | | ImageOps Pad Out | ImageOpsPadOut | Add per-side borders with constant, edge-extended, reflected, or blurry fill and optional target aspect ratios | | ImageOps Invert | ImageOpsInvert | Invert colors and/or alpha channel (separate alpha control) | | ImageOps Spherize | ImageOpsSpherize | Spherical and fisheye lens projections with five modes, strength control, and circle-mask output | | ImageOps Clamp | ImageOpsClamp | Clamp pixel values to min/max range | | ImageOps Merge | ImageOpsMerge | Linear-light two-input compositing with production blend modes and foreground fit controls | | ImageOps Noise | ImageOpsNoise | GPU-backed procedural noise source with Perlin, value, seamless tiling, 3D Z animation, seed stepping, frame length/FPS controls, and color ramp output | | ImageOps Paint | ImageOpsDraw | Digital painting with brush/eraser tools, cropped overlay payloads, layer JSON support, and pen dynamics | | ImageOps Comp | ImageOpsComp | Multi-layer compositor with blend modes, positioning, and opacity per layer |

📤 Output Nodes

| Node | Description | |------|-------------| | ImageOps Preview | ImageOpsPreview | Preview bridge node with multiple display modes (images, strip, animated WebP/GIF) |

---

🎛️ Node Details

🎨 ImageOps Color Correct

Professional color grading with reference-based correction.

Inputs:

• image (IMAGE/VIDEO): Source media
• mask (MASK, optional): Effect mask

Parameters:

• temperature (-100 to 100): Color temperature adjustment
• hue (-180 to 180): Hue rotation in degrees
• brightness (-100 to 100): Brightness adjustment
• contrast (-100 to 100): Contrast adjustment
• saturation (-100 to 100): Saturation adjustment
• gamma (0.2 to 2.2): Gamma correction
• invert_mask: Invert mask effect
• bypass: Skip processing

Outputs: IMAGE, MASK

---

🌫️ ImageOps Blur

Gaussian blur with optional mask support.

Inputs:

• image (IMAGE/VIDEO): Source media
• mask (MASK, optional): Effect mask

Parameters:

• radius (0 to 128): Blur support radius in pixels; when set to 0, support is derived from sigma
• sigma (0.01 to 64.0): Gaussian sigma value controlling blur spread
• invert_mask: Invert mask effect
• bypass: Skip processing

Outputs: IMAGE, MASK

---

🔴 ImageOps Channels

Extract and isolate individual color channels.

Inputs:

• image (IMAGE/VIDEO): Source media
• mask (MASK, optional): Effect mask

Parameters:

• channel: Red, Green, Blue, or Alpha
• invert_mask: Invert mask effect
• bypass: Skip processing

Outputs: IMAGE, MASK

---

🎚️ ImageOps Mask Convert

Convert images to masks and masks to previewable images.

Inputs:

• image (IMAGE/VIDEO, optional): Source media when reverse is enabled
• mask (MASK, optional): Source mask when reverse is disabled

Parameters:

• reverse: image -> mask when enabled, mask -> image when disabled
• mask_source: auto, luma, max_rgb, saturation, red, green, blue, or alpha
• black_point / white_point: Remap the extracted matte to harden or soften the mask
• antialias_radius: Small blur radius before levels to smooth jagged matte edges

Outputs: IMAGE, MASK

---

✂️ ImageOps Resize/Crop

Interactive crop and resize with aspect ratio control.

Inputs:

• image (IMAGE/VIDEO): Source media
• mask (MASK, optional): Effect mask

Parameters:

• aspect_ratio: Preset ratios (1:1, 3:4, 4:3, 16:9, 9:16, custom)
• width (1 to 8192): Output width
• height (1 to 8192): Output height
• sync_dimensions: Link width/height changes
• crop_center_x (0.0 to 1.0): Horizontal crop position
• crop_center_y (0.0 to 1.0): Vertical crop position
• crop_scale (0.05 to 1.0): Crop zoom level
• Crop outputs include imageops_crop_bbox metadata in source-image coordinates for UI overlays/extensions
• invert_mask: Invert mask effect
• bypass: Skip processing

Outputs: IMAGE, MASK

---

🌀 ImageOps Distort

Channel-driven displacement warp inspired by iDistort-style workflows.

Inputs:

• image (IMAGE/VIDEO): Source media to deform
• displacement (IMAGE/VIDEO, optional): External displacement plate when map_source is displacement_channel
• mask (MASK, optional): Used as the distortion map in mask mode, otherwise acts as an effect mask

Parameters:

• map_source: source_channel, displacement_channel, mask, or noise
• x_channel, y_channel: Choose independent channels for horizontal and vertical deformation
• strength_x, strength_y: Warp amplitude in pixels
• centered_map: Treat mid-gray as neutral displacement
• invert_map: Invert the driving map before warping
• filter: nearest, bilinear, bicubic
• edge_mode: border, reflection, zeros
• Internal noise controls: basis, fractal mode, scale, octaves, lacunarity, gain, seed, and offsets
• invert_mask: Invert the effect mask when the mask input is acting as an effect mask

Outputs: IMAGE, MASK

---

🔄 ImageOps Transform

Geometric transformations with quality filters.

Inputs:

• image (IMAGE/VIDEO): Source media
• mask (MASK, optional): Effect mask

Parameters:

• translate_x (-4096 to 4096): Horizontal offset
• translate_y (-4096 to 4096): Vertical offset
• rotate_deg (-180 to 180): Rotation angle (clockwise positive)
• scale (0.01 to 8.0): Scale factor
• filter: Nearest, Bilinear, or Bicubic
• expand: Compatibility option; the GPU affine path keeps the output size fixed
• invert_mask: Invert mask effect
• bypass: Skip processing

Outputs: IMAGE, MASK

---

📐 ImageOps Corner Pin

Perspective corner pinning for screen replacement, planar warps, and compositing.

Inputs:

• image (IMAGE/VIDEO): Source media

Parameters:

• tl_x, tl_y: Top-left destination corner in normalized image coordinates
• tr_x, tr_y: Top-right destination corner in normalized image coordinates
• bl_x, bl_y: Bottom-left destination corner in normalized image coordinates
• br_x, br_y: Bottom-right destination corner in normalized image coordinates
• filter: Nearest, Bilinear, or Bicubic
• supersample: 1x to 4x multisampling before downsampling
• edge_mode: border, reflection, or zeros
• invert_mask: Invert the warped transparency mask
• bypass: Skip processing

The warp uses batched PyTorch homographies with grid_sample; RGBA input is premultiplied before warping so transparent edges stay clean.

Outputs: IMAGE, MASK

---

🧱 ImageOps Pad Out

Add borders around an image without scaling the source.

Inputs:

• image (IMAGE/VIDEO): Source media

Parameters:

• pad_left, pad_top, pad_right, pad_bottom: Per-side padding in pixels
• target_format: custom, 1:1, 16:9, 9:16, 4:3, or 3:4
• fill_mode: constant, edge_extend, reflect, or blurry
• fill_color: Solid color for constant padding
• blur_radius: Background blur radius for blurry padding
• invert_mask: Invert the padding mask
• bypass: Skip processing

The target_format option adds only the extra padding needed to reach the selected ratio, so manual side padding can still decenter the source.

Outputs: IMAGE, MASK, INT (width), INT (height)

---

Note: A dedicated ImageOps PadOut Stitch node (to restore the original into the padded area after outpainting) is planned for a future release.

🎭 ImageOps Invert

Invert colors and/or the alpha channel independently.

Inputs:

• image (IMAGE/VIDEO): Source media
• mask (MASK, optional): Effect mask

Parameters:

• invert_alpha: Also invert the alpha channel (only applies to RGBA images with 4 channels)
• invert_mask: Invert the output mask
• bypass: Skip processing

Outputs: IMAGE, MASK

---

🔮 ImageOps Spherize

Spherical, fisheye, and equirectangular lens-projection distortions.

Inputs:

• image (IMAGE/VIDEO): Source media
• mask (MASK, optional): Mask to multiply against the circle boundary

Parameters:

• mode: spherize (barrel/pincushion), fisheye (equidistant projection), defisheye (flatten fisheye), latlong (equirectangular → rectilinear), unlatlong (rectilinear → equirectangular)
• strength (0.0 to 2.0): Effect intensity; 1.0 = full projection, values > 1 push beyond the normal range
• invert: Swap the forward and inverse mapping directions (e.g. barrel ↔ pincushion, latlong ↔ unlatlong)
• filter: bilinear, bicubic, or nearest — resampling quality
• edge_mode: border, reflection, or zeros — behavior at the image boundary
• size_mode: from_input (use input dimensions) or custom (resize to width × height before applying)
• width / height: Target dimensions when size_mode is custom
• bypass: Skip processing

The output mask is a unit-circle alpha (1 inside the sphere, 0 outside), multiplied by the optional input mask.

Outputs: IMAGE, MASK

---

📏 ImageOps Clamp

Clamp pixel values to specified range.

Inputs:

• image (IMAGE/VIDEO): Source media
• mask (MASK, optional): Effect mask

Parameters:

• min_v (-1.0 to 1.0): Minimum value
• max_v (0.0 to 2.0): Maximum value
• invert_mask: Invert mask effect
• bypass: Skip processing

Outputs: IMAGE, MASK

---

🔀 ImageOps Merge

Blend two images with linear-light or sRGB blend modes.

Inputs:

• A (IMAGE/VIDEO): Background layer
• B (IMAGE/VIDEO): Foreground layer
• mask (MASK, optional): Effect mask

Parameters:

• mode: over, add, subtract, multiply, screen, overlay, soft_light, difference, max, min, lighten, darken, color_dodge, color_burn, exclusion, vivid_light, pin_light, hard_mix
• mix (0.0 to 1.0): Blend opacity
• foreground_fit: stretch, contain, cover, or none for adapting foreground B to background A
• blend_space: linear or srgb; linear performs RGB blend math in gamma 1.0 then converts back to sRGB
• invert_mask: Invert mask effect
• bypass: Skip processing

Outputs: IMAGE, MASK

---

🌫️ ImageOps Noise

Procedural texture generator for masks and grayscale or color noise plates.

Parameters:

• width / height: Output resolution (64 to 8192)
• frame_length: Number of frames to generate (1 to 256)
• fps: Preview playback speed
• seed: Deterministic noise seed
• basis: perlin, value, or white
• fractal_mode: none, fbm, turbulence, or ridged
• scale: Primary feature size
• octaves (1 to 12), gain (0.0 to 1.0): Fractal shaping controls
• offset_z: Static Z offset into the 3D noise field
• animation_speed: Z offset added per frame — higher = faster animation, 0 = still image
• seamless: Tileable X/Y noise for repeating textures
• contrast, invert: Output tonal shaping
• low_color, high_color: Color ramp applied to the grayscale output

Outputs: IMAGE, MASK

---

🖌️ ImageOps Paint

Digital painting and drawing tool.

Inputs:

• image (IMAGE/VIDEO, optional): Base media (creates blank canvas if not provided)

Parameters:

• width (64 to 4096): Canvas width
• height (64 to 4096): Canvas height
• sync_dimensions: Link width/height changes
• bg_color: Background color (hex)
• tool: Brush or Eraser
• brush_color: Brush color (hex)
• brush_opacity (0.0 to 1.0): Brush transparency
• brush_size (1 to 256): Brush diameter
• brush_pressure_size: Pen pressure modulates brush diameter
• brush_pressure_opacity: Pen pressure modulates brush opacity
• brush_tilt_size: Pen tilt can widen the brush footprint
• overlay_format: WebP or PNG payload encoding
• overlay_data: Encoded overlay payload; the preview stores cropped visible bounds to reduce transfer size
• overlay_layers: Optional JSON layer list for composing multiple overlay payloads
• invert_mask: Invert mask effect
• bypass: Skip processing

The node still accepts older full-frame Base64 PNG overlay_data values. New preview payloads are cropped to the visible painted bounds and can use WebP when the browser supports it; overlay_layers accepts {"layers":[{"data":"...","opacity":1,"enabled":true}]} for non-destructive multi-layer overlays.

Outputs: IMAGE, MASK

---

🎬 ImageOps Comp

Multi-layer compositor with professional controls.

Inputs:

• image_1, image_2, ... (IMAGE/VIDEO): Layer inputs
• mask_1, mask_2, ... (MASK): Per-layer masks
• Dynamic slot system with auto-expansion

Parameters:

• bypass: Skip processing
• use_first_layer_size: Use first layer as canvas size
• auto_layering: Use the largest connected layer dimensions as canvas size
• width (1 to 8192): Custom canvas width
• height (1 to 8192): Custom canvas height
• background_color: Canvas background (hex)
• layers_json: Layer configuration (auto-managed by UI)
• invert_mask: Invert output mask

Interactive UI Features:

• ➕ Add layer button
• 🔄 Reset layer button
• 🎨 Blend mode selector per layer
• 🎚️ Opacity slider per layer
• 🖱️ Drag-to-position layers on preview

Outputs: IMAGE, MASK

---

👁️ ImageOps Preview

Preview output node with advanced visualization modes.

Inputs:

• image (IMAGE/VIDEO): Source media
• mask (MASK, optional): Mask to preview

Parameters:

• preview_target: auto, image, or mask
• mode:
  • images: Individual frames
  • strip: Horizontal strip for batch inspection
  • animated_webp: Animated WebP preview
  • animated_gif: Animated GIF preview

Outputs: IMAGE, MASK

---

🔧 Bypass Mode

All processing nodes expose a bypass parameter (boolean). When enabled:

• ✅ Node returns input unchanged
• ✅ Live preview skips applying the operation
• ✅ Useful for A/B comparison and workflow debugging

---

🖥️ Live Preview (Frontend)

Architecture

| File | Purpose | |------|---------| | js/preview/host.js | Widget injection, video loop, Preview Pro UI (scopes/overlays/A‑B) | | js/preview/renderer.js | Recursive render with caching (recursion limit: 64) | | js/preview/registry.js | Adapter selection (core/WAS/VHS/generic/ImageOps) | | js/preview/ops.js | Preview ops implementation (single source for preview behavior) |

Preview Pro UI Features (ImageOpsPreview only)

• 📊 Histogram: Luminance distribution
• 🌊 Waveform: Luma or RGB waveform monitor
• 🎯 Vectorscope: Color vector analysis
• 🦓 Zebra/False Color: Exposure visualization
• ↔️ A/B Compare: Freeze and wipe comparison

Interop Support

| Source | Adapters | |--------|----------| | Core | Basic invert/sharpen/blend (best effort) | | WAS | Heuristics for common nodes | | VHS | Video frame sources | | Generic | Fallback adapter |

⚠️ Fail-Soft: Unsupported nodes don't break the graph - they simply bypass preview processing.

---

⚙️ Configuration

Preview Canvas Size

localStorage["imageops.preview.canvasSize"] = 512; // Default: 512px

Large Image Warning Threshold

# Environment variable (in MB)
IMAGEOPS_LARGE_IMAGE_WARN_MB=2048  # Default: 2048 MB

---

📝 Notes & Troubleshooting

⚠️ Deprecation Warnings

If ComfyUI logs [DEPRECATION WARNING], another extension is using legacy frontend APIs. This doesn't affect ImageOps functionality.

🎥 Video/Frame Sources

Some packs expose video via custom types. Best results when upstream provides frames as IMAGE batches.

🔌 Input Types

• IMAGE: Standard ComfyUI image batches [B, H, W, C]
• VIDEO: Frame sources from video nodes (VHS, etc.)
• MASK: Single-channel masks [B, H, W]

🎨 Blend Modes Reference

| Mode | Description | |------|-------------| | over | Standard alpha compositing | | add | Additive blending (brightens) | | subtract | Subtractive blending (darkens) | | multiply | Multiply colors (darkens) | | screen | Screen blend (brightens) | | difference | Absolute difference | | max | Maximum of each channel | | min | Minimum of each channel |

🎛️ Compositor Blend Modes

| Mode | Canvas Operation | |------|------------------| | over | source-over | | add | lighter | | multiply | multiply | | screen | screen | | overlay | overlay | | soft_light | soft-light | | difference | difference | | lighten | lighten | | darken | darken | | color_dodge | color-dodge | | color_burn | color-burn | | exclusion | exclusion |

---

🏗️ Technical Details

Batch Processing

All nodes process batches natively:

• Single images: [1, H, W, C]
• Image sequences: [B, H, W, C]
• Video frames: [B, H, W, C]

Mask Handling

• Masks are automatically prepared and matched to reference dimensions
• invert_mask affects both processing and output mask
• Alpha channel extracted as mask when available

Color Space

• All processing in linear float32 [0.0, 1.0]
• Luma weights: [0.2126, 0.7152, 0.0722] (Rec. 709)
• Gamma safe range: 0.2 to 5.0

Performance

• Live preview uses optimized canvas rendering
• Recursive render cache limit: 64 nodes
• Large image warning threshold: 2048 MB (configurable)

---

📄 License

Check the repository for license information.

---

🙏 Credits

Author: Majoor
Category: image/imageops
Version: 0.1.5

---

📋 Changelog

Recent changes

• ImageOps Spherize — new node with five projection modes (spherize, fisheye, defisheye, latlong, unlatlong), bicubic/bilinear/nearest filter, edge modes, custom output size, and circle-mask output
• ImageOps Corner Pin — bicubic interpolation option added
• ImageOps Color Correct — enhanced color correction capabilities
• ImageOps Preview — improved noise node performance and zoom/pan interactions
• ImageOps Invert — invert_alpha is now a proper UI checkbox (previously in the signature but not exposed); RGBA images can invert color and alpha independently
• ImageOps Noise — incremental CPU transfer during frame generation reduces peak VRAM usage on large batches; deprecated legacy parameters (seed_step, compute_device, offset_x/y, frame_offset_x/y/z, lacunarity) removed from UI (still accepted in saved workflows for backwards compatibility)

---

<div align="center">

Made with ❤️ for the ComfyUI community

Report Issues • Request Features

</div>