🎨 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
ImageOps Grain	ImageOpsGrain	Synthetic film grain with add/overlay/soft_light blend, size, luma response, and per-frame animation
ImageOps Camera Shake	ImageOpsCameraShake	Procedural handheld camera jitter (translate/rotate/zoom) with smoothing and frequency control
ImageOps Keyer	ImageOpsKeyer	Chroma/luma keying with multi-color keys and despill
ImageOps Text	ImageOpsText	Text overlay with font size, alignment, stroke, and opacity
ImageOps Frame Range	ImageOpsFrameRange	Trim, hold, and repeat (loop/bounce/reverse) a frame range
ImageOps Append	ImageOpsAppend	Concatenate two IMAGE/VIDEO clips with FPS policy and padding options
ImageOps Constant	ImageOpsConstant	Solid color, checkerboard, or grid generator
ImageOps Ramp	ImageOpsRamp	Linear or radial gradient generator
ImageOps Crop Stitch	ImageOpsCropStitch	Paste an edited crop back into its original-image position with feathered edges
ImageOps Vignette	ImageOpsVignette	Radial darken-to-color falloff from a configurable center, size, and softness
ImageOps Chromatic Aberration	ImageOpsChromaticAberration	Radial red/blue channel shift simulating lens color fringing
ImageOps Bloom	ImageOpsBloom	Threshold + blur + additive glow on highlights, HDR-safe
ImageOps Lens Artifacts	ImageOpsLensArtifacts	Dirt/smudge texture compositing plus procedural static dust specks
ImageOps Defocus	ImageOpsDefocus	Depth-driven defocus/bokeh with shaped aperture kernels (circle/hexagon/octagon/custom) and highlight bloom

📤 Output Nodes

Node	Internal ID	Description
ImageOps Preview	ImageOpsPreview	Preview bridge node with multiple display modes (images, strip, animated WebP/GIF) and optional A/B compare against a second input

---

🎛️ 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
• input_space: srgb (default) or linear — set to linear for scene-linear/HDR sources so the node doesn't gamma-encode them twice
• invert_mask: Invert mask effect
• bypass: Skip processing

Also exposes per-zone (shadows/midtones/highlights) temperature, tint, hue, contrast, saturation, vibrance, gamma, and brightness wheels for three-way color grading.

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, multiply, screen, overlay, soft_light, difference, lighten, darken, color_dodge, color_burn, exclusion
• 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 Vignette

Radial darken-to-color falloff from a configurable center.

Inputs:

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

Parameters:

• amount (0.0 to 1.0): Strength of the darkening
• size (0.0 to 2.0): Radius (normalized frame units) where the vignette reaches full amount
• softness (0.01 to 2.0): Falloff width feathering the edge inward from size
• center_x, center_y (-1.0 to 2.0): Vignette center, normalized
• color: Color the vignette darkens toward (default black)
• invert_mask: Invert mask effect
• bypass: Skip processing

Outputs: IMAGE, MASK

---

🌈 ImageOps Chromatic Aberration

Radial red/blue channel shift simulating lens color fringing.

Inputs:

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

Parameters:

• amount (-30 to 30): Radial channel shift in pixels at the frame corner; positive shifts red outward and blue inward
• center_x, center_y (-1.0 to 2.0): Aberration center, normalized
• invert_mask: Invert mask effect
• bypass: Skip processing

Outputs: IMAGE, MASK

---

✨ ImageOps Bloom

Threshold + blur + additive glow on highlights.

Inputs:

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

Parameters:

• threshold (0.0 to 4.0): Brightness level above which pixels start to glow
• intensity (0.0 to 4.0): Strength of the added glow
• radius (0 to 128): Gaussian blur radius of the glow, in pixels
• invert_mask: Invert mask effect
• bypass: Skip processing

The glow is added, not screened, so highlights above 1.0 on HDR sources stay correct instead of clamping.

Outputs: IMAGE, MASK

---

🧴 ImageOps Lens Artifacts

Dirt/smudge texture compositing plus procedural static dust specks, in one node.

Inputs:

• image (IMAGE/VIDEO): Source media
• dirt (IMAGE/VIDEO, optional): Dirt/smudge texture plate (e.g. a stock lens-dirt asset); its luma attenuates the image multiplicatively
• mask (MASK, optional): Effect mask

Parameters:

• dirt_amount (0.0 to 1.0): Opacity of the connected dirt texture
• dust_amount (0.0 to 1.0): Procedural dust speck density and brightness
• dust_size (0.5 to 20.0): Speck size in pixels
• seed: Dust is a static lens artifact — the same seed always produces the same specks (doesn't drift frame to frame)
• invert_mask: Invert mask effect
• bypass: Skip processing

Dirt darkens multiplicatively (HDR-safe); dust specks add light additively, like real dust catching a highlight.

Outputs: IMAGE, MASK

---

🔵 ImageOps Defocus

Depth-driven defocus/bokeh with shaped aperture kernels.

Inputs:

• image (IMAGE/VIDEO): Source media
• depth (IMAGE/VIDEO, optional): Depth map — its luma drives the per-pixel blur amount. Without it connected, the node is a no-op
• shape_texture (IMAGE/VIDEO, optional): Grayscale bokeh aperture shape, used when bokeh_shape is custom
• mask (MASK, optional): Effect mask

Parameters:

• focus_distance (0.0 to 1.0): Depth value that stays in focus
• focus_range (0.0 to 0.99): Depth thickness around focus_distance that stays sharp before blur ramps up
• max_blur_radius (0 to 128): Bokeh disc radius in pixels at the depth extremes
• num_layers (2 to 32): Depth slices blurred and interpolated between — higher is smoother but slower
• bokeh_shape: circle, hexagon, octagon, or custom (uses shape_texture)
• highlight_threshold (0.0 to 2.0): Brightness above which pixels bloom into visible bokeh discs when blurred
• highlight_boost (0.0 to 8.0): Strength of the bokeh highlight bloom
• invert_depth: Flip the depth map convention (near/far)
• invert_mask: Invert mask effect
• bypass: Skip processing

In-focus pixels stay pixel-perfect sharp; out-of-focus depth slices are convolved with the chosen aperture shape and interpolated per-pixel to avoid banding. The live canvas preview only approximates this (a few gaussian-blur bands by depth, no shape or highlight bloom) — the real shaped/glowing bokeh appears once the backend runs.

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
• image_b (IMAGE/VIDEO, optional): Second source to compare against
• 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
• compare_mode: off, side_by_side, wipe, or diff — when image_b is connected, builds the saved/queued preview thumbnail as an A/B comparison instead of Image alone
• wipe_position (0.0 to 1.0): Split position used by compare_mode=wipe

While editing (before queuing), the live canvas also offers its own on-demand A/B toggle (Live/B/Wipe/Diff buttons) — this compares the two live-rendered inputs directly and is independent of the compare_mode/wipe_position widgets above, which control what actually gets saved once the prompt runs. Without image_b connected, those same buttons fall back to comparing the live canvas proxy against the last real queued result of image, for checking preview accuracy.

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 (ImageOps Merge)

Mode	Description
over	Standard alpha compositing
add	Additive blending (brightens)
multiply	Multiply colors (darkens)
screen	Screen blend (brightens)
overlay	Contrast-boosting multiply/screen mix
soft_light	Softer overlay variant
difference	Absolute difference
lighten	Maximum of each channel
darken	Minimum of each channel
color_dodge	Brightens base to reflect the blend color
color_burn	Darkens base to reflect the blend color
exclusion	Lower-contrast difference

🎛️ 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.7

---

📋 Changelog

Recent changes

• ImageOps Vignette, Chromatic Aberration, Bloom, Lens Artifacts — new nodes for common lens/compositing effects: radial darken falloff, red/blue channel fringing, HDR-safe additive glow, and dirt/dust compositing
• ImageOps Defocus — new depth-driven defocus/bokeh node with shaped aperture kernels (circle, hexagon, octagon, or a custom shape texture) and highlight bloom
• ImageOps Color Correct — added input_space (srgb/linear) so scene-linear/HDR sources aren't gamma-encoded twice
• ImageOps Preview — added an image_b input and compare_mode/wipe_position for a real A/B comparison baked into the saved/queued preview thumbnail, plus a separate live on-demand A/B toggle while editing
• Live preview HUD — the frame-count badge now shows the real total (3 / 24) and hides itself for single-frame sources instead of always showing f 0000; the "Output" overlay only appears for Pad Out (where it's meaningful) and now shows the real pixel size instead of a static label
• 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)

---

Made with ❤️ for the ComfyUI community

Report Issues • Request Features