aTanguay-ComfyUI_Detonate/DEVLOG.md

ComfyUI_Detonate - Development Log

This document tracks the development history and version releases of ComfyUI_Detonate.

For current status and features, see README.md.
For project planning, see PLANNING.md.

---

🎉 Version 0.10.0 - Bridge Tools Round 2: AI Inpainting Perfection! 🎨

Release Date: 2025-01-23

Essential tools for AI inpainting and tiled generation workflows!

New Bridge Tools (2 Critical Nodes)

1. TriMap Generator ⭐⭐⭐ - Perfect AI inpainting setup

• Auto-generate trimaps - White (keep), Black (remove), Gray (AI decides)
• Adjustable unknown width - Control transition zone size
• Multiple modes - Edge Distance, Threshold Only, Full Unknown
• RGB preview - See trimap regions (Green=FG, Red=BG, Blue=Unknown)
• Threshold controls - Define foreground/background certainty
• Essential for high-quality AI inpainting - tells AI exactly what needs work
• UNIQUE: No proper trimap generator exists in ComfyUI ecosystem

2. Seam Blender ⭐⭐⭐ - Remove AI tiling seams

• Multiple blend methods - Feather (fast), Gradient (good), Poisson (best)
• Auto-detect seams - Find tile boundaries automatically
• Manual seam placement - JSON array for precise control
• Adjustable blend width - Control transition smoothness
• Horizontal & vertical - Handle any tiling pattern
• Fixes visible seams from AI tiled generation, panorama stitching
• UNIQUE: Solves specific AI tiling problem, doesn't exist elsewhere

MatteControl Highlight ⭐⭐⭐ - Professional matte refinement (Tier 2 node)

• All-in-one workflow - Erode/Dilate + Blur + Gamma + Levels in one node
• Preview modes - See each processing stage
• Proper operation order - Industry-standard matte cleanup pipeline
• Replaces 4-5 node chains with a single professional control
• Essential daily tool for every compositor

Total node count: 44 nodes

---

🎉 Version 0.9.0 - Bridge Tools: GenAI ↔ Compositing! 🌉

Release Date: 2025-01-23

Unique tools bridging traditional compositing and generative AI workflows!

What Makes These Special?

These nodes fill critical gaps in the ComfyUI ecosystem - they either don't exist elsewhere or lack professional-grade implementations. Built specifically to help compositors work with AI-generated images.

Bridge Tools (3 Unique Nodes)

1. Edge Defringe (AlphaPremultFix) ⭐⭐⭐ - Fix AI image edge artifacts

• Erode Matte technique - Shrink alpha, dilate color to fill edge
• Color suppression - Remove greenscreen spill and color contamination
• Premult fix - Remove dark/bright halos from premult errors
• Problem color selection - Green, Blue, Red, Custom, or Auto-detect
• Multiple modes - Erode Matte, Color Suppress, Premult Fix, or All
• Essential for cleaning up AI inpainting, background removal, and greenscreen artifacts
• UNIQUE: Nothing else in ComfyUI handles edge defringing this comprehensively

2. Displacement Map ⭐⭐⭐ - Professional IDistort-style warping

• UV displacement - R=X, G=Y vector field warping
• Adjustable scale - Independent X/Y displacement strength
• Edge modes - Clamp, Wrap, or Black
• Bilinear interpolation - Smooth, high-quality results
• Center-neutral option - 0.5 = no displacement (standard)
• Alpha as Y option - Use alpha channel for Y displacement
• Perfect for heat distortion, refraction, lens correction, creative warping
• UNIQUE: No professional displacement mapping exists in ComfyUI

3. GridWarp ⭐⭐ - Mesh-based image warping

• Control grid - 2×2 to 32×32 mesh resolution
• Piecewise affine - Smooth quad-based warping
• JSON grid data - Persistent grid point offsets
• Strength control - Warp intensity multiplier
• Edge modes - Clamp or Black
• Ideal for perspective correction, lens distortion, creative warping, building straightening
• UNIQUE: Mesh-based warping doesn't exist in ComfyUI

Total node count: 42 nodes

---

🎉 Version 0.8.0 - Tier 6: Professional Keying! 🎬

Release Date: 2025-01-22

Essential greenscreen and brightness keying tools!

Keying Toolkit (3 Professional Nodes)

1. ChromaKeyer ⭐⭐⭐ - Professional greenscreen/bluescreen keying

• Screen color presets - Green, Blue, Custom RGB
• Color difference algorithm - Industry-standard keying
• Threshold & tolerance controls - Precise key tuning
• Softness control - Smooth edge transitions
• Spill suppression - Remove green/blue color cast from edges
• Multiple output modes - Alpha, Foreground, Raw Key, Despilled
• Essential for greenscreen removal and virtual production

2. LumaKeyer ⭐⭐ - Advanced brightness-based keying

• Multiple luma modes - Rec.709, Average, Max, Min
• Range controls - Min/Max brightness selection
• Soft edges - Smooth key transitions
• Invert option - Key dark or bright areas
• Output modes - Alpha or Foreground
• Perfect for sky replacement, highlight/shadow isolation

3. LumaKeyer Simple ⭐ - Quick single-threshold luma keyer

• Single threshold - Fast brightness keying
• Tolerance control - Adjust key range
• Brighter/Darker modes - Quick selection
• Ideal for simple sky replacement or quick selections

Total node count: 39 nodes

---

🎉 Version 0.7.0 - Tier 5: Interactive Masking! 🔥

Release Date: 2025-01-22

MAJOR FEATURE: Professional Rotoscoping Tools + Phase 1.5 Enhancements!

RotoBezier - Interactive Spline Drawing

The #1 requested feature by compositors is here! Draw precise masks directly in ComfyUI with professional Bezier spline tools.

2 nodes with Phase 1.5 professional enhancements:

1. RotoBezier - Interactive Bezier spline drawing for mask creation

• Web-based interactive drawing widget - Click to draw points, drag handles for smooth curves
• de Casteljau's algorithm from Natron for numerically stable Bezier evaluation
• Supersampling anti-aliasing (1-16×) for film-quality smooth edges
• Distance field feathering with smoothstep falloff (better than gaussian blur!)
• 🔥 Phase 1.5: Shape operations - Add/Subtract/Intersect per spline for complex boolean masking
• 🔥 Phase 1.5: Falloff curves - Linear/Smooth/Gaussian feather types for artistic control
• 🔥 Phase 1.5: Per-spline invert - Individual control over each shape's contribution
• 🔥 Phase 1.5: Preset shapes - Circle, Rectangle, Star generators for quick work
• Multiple splines - Draw multiple shapes with boolean operations
• Keyboard shortcuts - Enter to close, Delete to remove, Escape to cancel
• JSON-based data exchange between web widget and Python backend

2. RotoBezier From Image - Automatically matches input image dimensions

• Same features as RotoBezier
• Convenience node for rotoscoping over footage

Why this is a game-changer:

• Replaces Natron/Nuke RotoPaint for basic rotoscoping workflows
• Best-in-class implementation with modern web UI and high-quality rendering
• Essential for garbage mattes - quickly isolate subjects for compositing
• Professional soft edges - distance field feathering beats traditional blur approaches
• 🔥 Shape operations - Add/Subtract/Intersect for complex boolean masking like Photoshop
• 🔥 Artistic feathering - Choose between Linear, Smooth (smoothstep), or Gaussian falloff curves

Total node count: 36 nodes

---

🎉 Version 0.6.0 - Tier 4: Production Finishing!

Release Date: 2025-01-22

8 new professional nodes for final polish and creative effects:

1. Crop - Aspect ratio presets (16:9, 2.39:1, etc.) + soft edges (linear/smooth/gaussian falloff)
2. Exposure - Photographic f-stops + per-channel exposure + highlight rolloff + response curves (linear/log/filmic)
3. Vignette - Multiple shapes (circular/oval/rectangular) + falloff curves + color tinting
4. Grain - 4 grain types (film/digital/organic/halftone) + luminance-dependent + per-channel intensity
5. HueSatVal - Direct HSV manipulation + selective hue ranges (reds/yellows/etc.) + preserve luminance
6. Denoise - 3 algorithms (bilateral/median/gaussian) + detail preservation + luma/chroma separation
7. LUT - 1D/3D .cube file support + trilinear interpolation + LUT caching + strength control
8. CornerPin - 4-point perspective transform + homography calculation (DLT/SVD) + multiple filter modes

Total node count: 34 nodes

---

🎉 Version 0.5.0 - Quality-of-Life Upgrades!

Release Date: 2025-01-22

We've upgraded 5 core nodes with professional enhancements that weren't in the original implementations:

Merge - 16 Blend Modes (was 8)

Added 8 Photoshop-style blends: Overlay, Soft Light, Hard Light, Color Dodge, Color Burn, Divide, Difference, Exclusion

Perfect for advanced compositing, glow effects, and color grading workflows.

Grade - Per-Channel RGB Controls

Added separate R/G/B lift/gamma/gain controls (like Nuke's full Grade node)

Now supports precise per-channel color correction for matching problematic footage. Master controls + per-channel adjustments work together.

ColorCorrect - Hue Shift

Added hue rotation control (-180° to +180°)

Essential for color matching between different camera sources or lighting conditions. Uses proper RGB→HSV→RGB conversion.

EdgeDetect - 4 Algorithms (was 1)

Added Laplacian, Prewitt, and Scharr (in addition to Sobel)

Different algorithms for different needs:

• Sobel: Standard, balanced
• Laplacian: Fine edges, more noise-sensitive
• Prewitt: Simpler, faster
• Scharr: Best rotation invariance

MatteControl - 4 Kernel Shapes (was 1)

Added Circular, Cross, and Diamond (in addition to Square)

Professional matte refinement with shape control:

• Square: Traditional morphology
• Circular: Natural, organic edges
• Cross: Directional (H+V only)
• Diamond: 45° diagonal emphasis

Total node count: 26 nodes

---

Earlier Versions

See CHANGELOG.md for detailed commit history.

For complete development history, see the git commit log.