SVG Suite for ComfyUI

SVG Suite is an advanced set of nodes for converting images to SVG in ComfyUI, expanding upon the functionality of ComfyUI-ToSVG.

Features

This extension enhances the original SVG conversion capabilities with:

1. Advanced Unified Conversion

The Convert to SVG (Advanced) node combines both color and binary conversion modes with full parameter control:

• Unified Interface: Choose between color and binary modes in a single node
• Dynamic Parameters: Parameters adjust automatically based on selected colormode
• Full Control: Access to all vtracer parameters for precise SVG generation

2. Direct File Processing

The Image File to SVG node allows direct conversion from image files:

• File Path Input: Process images from anywhere on your system
• Direct Output: Optionally save SVG directly to a specified path
• Parameter Control: Full control over conversion parameters

3. Raw Bytes Processing

The Image Bytes to SVG node enables conversion from raw image data:

• Format Support: Process JPG, PNG, and WebP image bytes
• API Integration: Useful for integration with other nodes that produce image bytes
• Resilient Processing: Includes fallback mechanisms for error handling

4. Enhanced Preview & Save

• Advanced Preview: Scale and add background colors to SVG previews
• Optimization Options: Minify and optimize SVG output
• Custom Paths: Save to custom locations with flexible naming options

5. SVG Compression & Optimization

The suite includes powerful SVG compression and optimization capabilities:

Advanced SVG Compression

The Advanced SVG Compression node leverages the SVGCompress library to reduce SVG file size through:

• Multiple Compression Methods:

  • Delete: Remove tiny polygons below a size threshold
  • Simplify: Reduce polygon complexity using the Ramer-Douglas-Peucker algorithm
  • Merge: Combine adjacent or overlapping shapes

• Precision Control: Fine-tune the compression with parameters like curve fidelity, epsilon values, and buffer distances

SVG Optimization with Scour

The SVG Optimize (Scour) node provides granular control over SVG optimization:

• Markup Cleaning: Remove unnecessary elements, attributes, and metadata
• ID Management: Strip or shorten element IDs
• Formatting Options: Control indentation, whitespace, and newlines
• Precision Control: Adjust decimal precision for coordinates

Quick Optimization Presets

The SVG Optimize Presets node offers one-click optimization with predefined configurations:

• Default: Minimal safe changes
• Better: Improved compatibility with older browsers
• Maximum: Aggressive optimization for significantly smaller files
• Compressed: Maximum optimization plus additional compression techniques

6. SVG Color Manipulation

The suite now includes tools for analyzing and modifying the colors in SVG files:

SVG Color Extractor

The SVG Color Extractor node helps identify all colors used in an SVG:

• Color Discovery: Automatically finds all fill colors in the SVG
• Analysis: Useful for preparing color replacements or understanding SVG structure
• Compatible Output: Returns colors in standard hex format for easy reuse

SVG Color Replacer

The SVG Color Replacer node enables precise color substitution in SVGs:

• Targeted Replacement: Replace specific colors with new ones
• Batch Processing: Handle multiple color replacements at once
• Format Control: Works with both style and fill attributes

SVG Batch Color Effects

The SVG Batch Color Effects node applies color transformations across the entire SVG:

• Built-in Transformations:
  • Invert: Flip colors to their opposites
  • Grayscale: Convert to shades of gray using luminance calculation
  • Sepia: Add warm sepia tone effect
• Custom Mappings: Define your own color transformation rules
• Preserves Structure: Maintains all SVG elements while changing only colors

Usage

1. Add any of the nodes from the "💎TOSVG/Advanced" category to your workflow
2. Connect image data, file paths, or image bytes as required
3. Adjust parameters to control the SVG conversion process
4. Apply compression, optimization, or color changes as needed
5. Preview and save your SVG output

Parameters Explained

Main Conversion Parameters

• colormode: Choose between "color" (multi-color SVG) or "binary" (black and white)
• hierarchical: For color mode, controls how colors are stacked ("stacked" or "cutout")
• mode: Shape mode - "spline" (smooth curves), "polygon" (straight lines), or "none"
• filter_speckle: Size threshold to filter small artifacts (higher = more filtering)

Color Processing (Color Mode Only)

• color_precision: Controls color quantization (higher = more colors)
• layer_difference: Color difference threshold between layers (higher = fewer layers)
• max_iterations: Maximum number of iterations for color processing

Shape Processing

• corner_threshold: Angle threshold for corners (higher = fewer corners)
• length_threshold: Length threshold for paths (higher = simpler paths)
• splice_threshold: Angle threshold for path splicing
• path_precision: Decimal precision for path coordinates (higher = more precise but larger file)

Compression Parameters

• compression_type: Method for reducing SVG complexity ("delete", "simplify", or "merge")
• curve_fidelity: Level of detail for curve conversion (higher = more detailed but larger file)
• pre_select: Whether to perform pre-selection of polygons before compression
• selection_criteria: Method for selecting polygons ("bboxarea" or "circumference")
• selection_threshold: Size threshold for polygon selection
• operation_key: For merge operations, method to use ("hull" or "union")

Optimization Parameters

• enable_viewboxing: Enable viewBox attribute for better scaling
• enable_id_stripping: Remove unnecessary ID attributes
• enable_comment_stripping: Remove comments from SVG code
• shorten_ids: Shorten ID names to reduce file size
• indent_type: Control indentation style ("none", "space", or "tab")
• simplify_colors: Convert colors to simpler formats where possible
• precision: Number of decimal places for coordinates (lower = smaller file but less precision)

Color Manipulation Parameters

• color_mapping: Pairs of source and target colors in the format "#FF0000:#0000FF,#00FF00:#FFFF00"
• transformation: Preset color transformations (invert, grayscale, sepia, or custom)
• apply_to_fill_attribute: Whether to modify colors in the fill attribute
• apply_to_style_attribute: Whether to modify colors in the style attribute

Compression and Optimization Workflow

For optimal results with complex SVGs:

1. First convert your image to SVG using one of the conversion nodes
2. Apply the Advanced SVG Compression node to reduce complexity
3. Further reduce file size with the SVG Optimize (Scour) node
4. Apply color changes with the Color Manipulation nodes if needed
5. Preview the result and adjust parameters as needed
6. Save the optimized SVG with the Save SVG (Advanced) node

Color Editing Workflow

To transform the colors in an SVG:

1. Use SVG Color Extractor to identify the colors in your SVG
2. Based on the results, create a color mapping string (e.g., "#FF0000:#0000FF,#00FF00:#FFFF00")
3. Use SVG Color Replacer with your color mapping to create a modified SVG
4. Alternatively, use SVG Batch Color Effects to apply predefined transformations
5. Preview and save the resulting SVG

Comparison with Original ComfyUI-ToSVG

SVG Suite expands upon the original implementation by:

1. Combining separate color and BW nodes into a unified interface
2. Adding direct file processing capabilities
3. Supporting raw image bytes conversion
4. Providing SVG optimization and minification
5. Enhancing preview capabilities with scaling and background options
6. Adding advanced SVG compression and optimization
7. Including SVG color extraction and manipulation tools

Requirements

• ComfyUI
• vtracer
• pymupdf (fitz)
• PIL
• numpy
• torch
• SVGCompress
• scour
• svg.path
• shapely
• rdp
• lxml

Credits

This extension builds upon the ComfyUI-ToSVG project, enhancing its functionality with additional features and parameters.