🎨 ComfyUI_DAO_master

ComfyUI_DAO_master est une collection de custom nodes pour ComfyUI. Ces nodes apportent des outils supplémentaires pour la création, la manipulation d’image et l’expérimentation visuelle, avec un focus sur les workflows vectoriels (DXF & SVG) et les utilitaires de production.

✨ Aperçu des fonctionnalités

• Création Vectorielle DXF : Générez des formes primitives (cercles, rectangles, polygones...) et assemblez-les.
• Manipulation SVG : Effectuez des opérations booléennes (union, différence...), stylisez vos SVG et convertissez-les.
• Clonage & Mosaïques : Créez des grilles et des motifs circulaires complexes, découpez des images en tuiles et réassemblez-les avec des options de fusion avancées.
• Conversion Robuste : Passez facilement d'une image à un SVG (vectorisation) et d'un SVG à une image (rastérisation).
• Utilitaires Puissants : Un sélecteur de fichiers avancé, des sélecteurs de couleurs dynamiques, un générateur de texte complet et des filtres d'image pratiques.
• Interface Améliorée : De nombreux nodes disposent d'une interface utilisateur interactive avec des menus déroulants dynamiques pour une utilisation plus intuitive.

---

🚀 Installation

1. Naviguez vers le dossier custom_nodes de votre installation ComfyUI.
2. Clonez ce dépôt :

   cd ComfyUI/custom_nodes
   git clone https://github.com/orion4d/ComfyUI_DAO_master.git

3. Installez les dépendances : Certains nodes nécessitent des bibliothèques supplémentaires. Installez-les via pip :

   pip install cairosvg potrace ezdxf svgpathtools lxml pyclipper shapely

   • Note : Le node Convert IMG to SVG fonctionne mieux si l'exécutable potrace est installé et accessible dans le PATH de votre système.

---

📚 Documentation des Nodes

📐 DXF : Primitives

Cette catégorie regroupe les nodes fondamentaux pour la création de formes géométriques simples. Ils constituent la base de tout dessin vectoriel. Principe de fonctionnement commun : Chaque node de cette catégorie fonctionne de manière non-destructive. Il prend un objet DXF en entrée, crée une copie de son contenu, y ajoute la nouvelle forme, et retourne un nouvel objet DXF en sortie.

DXF Add Circle

Ajoute un cercle à un document DXF.

• Catégorie : DAO_master/DXF/Primitives
• Entrées :
  • dxf (DXF): Le document de base.
  • cx, cy (FLOAT): Coordonnées du centre.
  • radius (FLOAT): Rayon du cercle.
• Sorties :
  • dxf (DXF): Le nouveau document DXF avec le cercle.

DXF Add Rectangle / DXF Add Rounded Rectangle

Ajoute un rectangle (standard ou aux coins arrondis) à un document DXF.

• Catégorie : DAO_master/DXF/Primitives
• Entrées :
  • dxf (DXF): Le document de base.
  • x, y (FLOAT): Point d'ancrage.
  • width, height (FLOAT): Dimensions.
  • radius (FLOAT): Rayon des coins (pour la version arrondie).
  • centered (BOOLEAN): Si True, (x, y) est le centre ; sinon, c'est le coin inférieur gauche.
• Sorties :
  • dxf (DXF): Le nouveau document DXF avec le rectangle.

DXF Add Polygon / DXF Add Star / DXF Add Triangle

Ajoute une forme polygonale (polygone régulier, étoile ou triangle) à un document DXF.

• Catégorie : DAO_master/DXF/Primitives
• Entrées (Polygone/Étoile) :
  • dxf (DXF): Le document de base.
  • cx, cy (FLOAT): Centre de la forme.
  • outer_radius, inner_radius (FLOAT): Rayons pour définir les sommets.
  • num_sides / num_points (INT): Nombre de côtés ou de pointes.
• Entrées (Triangle) :
  • x1, y1, x2, y2, x3, y3 (FLOAT): Coordonnées des trois sommets.
• Sorties :
  • dxf (DXF): Le nouveau document DXF avec la forme.

DXF Add Line / DXF Add Ellipse

Ajoute une ligne ou une ellipse à un document DXF.

• Catégorie : DAO_master/DXF/Primitives
• Entrées (Ligne) :
  • x1, y1, x2, y2 (FLOAT): Coordonnées des points de départ et d'arrivée.
• Entrées (Ellipse) :
  • cx, cy (FLOAT): Centre de l'ellipse.
  • major_axis_x, major_axis_y (FLOAT): Vecteur de l'axe principal (définit la longueur et l'orientation).
  • ratio (FLOAT): Rapport entre l'axe mineur et l'axe majeur.
• Sorties :
  • dxf (DXF): Le nouveau document DXF avec la forme.

📂 DXF : I/O, Modification et Utilitaires

DXF New / DXF Import / DXF Save

Crée, charge ou sauvegarde des documents DXF.

• Catégorie : DAO_master/DXF, DAO_master/DXF/IO
• Fonctionnalités :
  • New : Crée un document DXF vierge en spécifiant les unités.
  • Import : Charge un fichier .dxf depuis le disque.
  • Save : Sauvegarde un objet DXF en fichier .dxf, avec des options d'horodatage.

DXF Transform

Applique des transformations géométriques (translation, rotation, échelle) à l'ensemble du dessin.

• Catégorie : DAO_master/DXF/Modify
• Entrées :
  • translate_x, translate_y (FLOAT): Déplacement.
  • scale (FLOAT): Facteur d'échelle.
  • rotation_degrees (FLOAT): Angle de rotation.
  • rotation_center (LISTE): Point pivot (object_center ou origin).
• Sorties :
  • dxf (DXF): Un nouveau document avec la géométrie transformée.

DXF Preview

Génère un aperçu visuel (une image) du contenu d'un objet DXF.

• Catégorie : DAO_master/DXF/Utils
• Fonctionnalités : Contrôle total sur la taille, l'épaisseur des traits, les couleurs de remplissage/contour, le fond et la grille. Peut également générer un masque.

DXF Stats

Analyse un document DXF et en extrait des statistiques.

• Catégorie : DAO_master/DXF/Utils
• Sorties :
  • bbox (STRING): La boîte englobante du dessin (min_x, min_y, max_x, max_y).
  • count (INT): Le nombre total d'entités dans le document.

🎨 SVG : Manipulation et Conversion

SVG Boolean

Effectue des opérations booléennes (Pathfinder) entre deux formes SVG.

• Catégorie : DAO_master/SVG
• Entrées : svg_a, svg_b
• Opérations :
  • union: Fusionne les deux formes.
  • difference: Soustrait la forme B de la forme A.
  • intersection: Ne conserve que la zone commune.
  • xor: Ne conserve que les zones non communes.

SVG Style / SVG Preview

Applique des styles ou génère un aperçu d'un SVG.

• Catégorie : DAO_master/SVG
• Fonctionnalités :
  • Style : Permet de définir la couleur de remplissage, la couleur et l'épaisseur du contour.
  • Preview : Utilise CairoSVG pour un rendu de haute qualité avec gestion du ratio d'aspect.

SVG Load / SVG Save / SVG Passthrough

Charge, sauvegarde ou convertit le type de données SVG.

• Catégorie : DAO_master/SVG/IO, DAO_master/SVG/Utils
• Fonctionnalités :
  • Load : Charge un .svg et permet de le redimensionner à la volée.
  • Save : Sauvegarde du texte SVG dans un fichier .svg.
  • Passthrough : Convertit le type SVG_TEXT en STRING pour la compatibilité.

DXF to SVG

Convertit un document DXF en code SVG.

• Catégorie : DAO_master/SVG/Convert
• Description : Transforme la géométrie DXF en un format SVG textuel, en tentant d'assembler intelligemment les segments pour créer des chemins propres. Offre des contrôles sur la qualité des courbes et la mise en page.

Convert SVG → IMG (+colors)

Convertit un SVG en une image rastérisée et extrait les couleurs utilisées.

• Catégorie : DAO_master/SVG/Convert
• Description : Un node de conversion avancé avec deux moteurs de rendu (natif ou cairosvg) pour une compatibilité maximale. Prend uniquement une entrée svg_text.
• Sorties : image, mask, et colors_json (un rapport détaillé des couleurs et formes détectées).

Convert IMG → SVG (1-bit)

Vectorise une image en un SVG monochrome en utilisant Potrace.

• Catégorie : DAO_master/SVG/Convert
• Description : Binarise une image (la transforme en noir et blanc pur) puis utilise l'algorithme de Potrace pour tracer les contours des formes, générant ainsi un SVG.

🖼️ Images : Clones et Mosaïques

Clone Grid (X/Y) / Clone Grid (Path)

Crée une grille de clones à partir d'une image source unique ou de plusieurs images d'un dossier.

• Catégorie : DAO_master/Images/Clone
• Clone Grid (X/Y) : Répète une seule image d'entrée selon une grille.
• Clone Grid (Path) : Remplit la grille en utilisant des images différentes provenant d'un dossier. Permet un ordre aléatoire via shuffle et seed.
• Fonctionnalités communes :
  • Contrôle de la disposition (count, spacing, offset).
  • Décalages alternés pour les lignes/colonnes (row_offset_x, col_offset_y) pour des motifs complexes (briques, quinconce...).
  • Transformation de chaque clone (scale, rotation, opacity).

Clone Circular / Clone Circular (Path)

Arrange des clones en un motif circulaire.

• Catégorie : DAO_master/Images/Clone
• Clone Circular : Répète une seule image d'entrée.
• Clone Circular (Path) : Utilise des images différentes d'un dossier.
• Fonctionnalités communes :
  • Contrôle du rayon, du nombre de clones, des angles de départ/fin.
  • Options pour orienter les clones vers le centre ou les aligner sur un angle fixe.

Mosaic: Tile & Export

Découpe une image source en une grille de tuiles et les exporte en tant que fichiers individuels.

• Catégorie : DAO_master/Images/Mosaic
• Description : Idéal pour préparer des images pour des workflows de type "tiled diffusion".
• Sorties :
  • Un batch d'images contenant toutes les tuiles pour un traitement ultérieur dans ComfyUI.
  • Un dossier de sortie contenant chaque tuile sauvegardée en .png ou .jpg.

Mosaic: Assemble (Batch) / Mosaic: Assemble (Folder)

Réassemble des tuiles pour former une image composite.

• Catégorie : DAO_master/Images/Mosaic
• Assemble (Batch) : Prend un batch d'images en entrée.
• Assemble (Folder) : Charge les tuiles directement depuis un dossier.
• Fonctionnalités communes :
  • Superposition et Fusion : Permet de superposer les tuiles (overlap) et de les fusionner avec des modes de blending avancés (feathering, weighted average...).
  • Disposition : Contrôle de l'espacement (gutter) et de l'ordre d'assemblage (row_major, snake_row...).
  • Ordre par Regex (Folder) : Le mode regex_filename_order permet de replacer les tuiles à leur position exacte en se basant sur leur nom de fichier (ex: tile_r01_c03.png).

🛠️ Utilitaires, Filtres et Générateurs

DAO Hex/RVB Color Picker

Des sélecteurs de couleurs interactifs pour choisir des couleurs à partir de listes personnalisables.

• Catégorie : DAO_master/Color
• 💡 Fonctionnement UI : Créez vos propres listes de couleurs dans les dossiers hexadecimal_List/ ou RGB_List/. Le node affichera des menus déroulants pour choisir le fichier et la couleur. Un bouton ↻ permet de rafraîchir les listes.
• Modes : Manual, Random, Increment, Decrement.

Folder File Pro / Path → Image / Load Image Pro

Nodes avancés pour la gestion des fichiers et le chargement d'images.

• Catégorie : DAO_master/IO
• Folder File Pro : Un explorateur de fichiers avancé avec une UI interactive pour filtrer, trier et sélectionner des fichiers de manière procédurale.
• Path → Image : Prend un chemin de fichier en STRING et charge l'image correspondante.
• Load Image Pro : Un chargeur d'image amélioré avec des options supplémentaires.

DAO Text Maker

Crée une image, un SVG et un masque à partir d'un texte.

• Catégorie : DAO_master/Text
• 💡 Fonctionnement UI : Le champ font_file devient un menu déroulant listant les polices .ttf/.otf que vous placez dans le dossier Fonts/.
• Fonctionnalités : Contrôle total sur la police, la taille, l'alignement, les couleurs de remplissage/contour, le fond, et la sortie (SVG textuel ou vectorisé).

DAO Move

Applique des transformations (déplacement, échelle, rotation) et des symétries à une image.

• Catégorie : DAO_master/Utils
• Description : Permet de manipuler la position, la taille et l'orientation d'une image et de son masque associé, avec un contrôle précis sur le point de pivot.

DAO Blur

Applique un flou gaussien et peut générer une ombre portée.

• Catégorie : DAO_master/Filter
• Description : Floute une image et/ou un masque, et peut générer une image séparée contenant une ombre portée personnalisable (couleur, opacité, décalage).

💡 Guides d'Installation (Potrace & Polices)

🚀 Installer Potrace sur Windows (pour la vectorisation d'images)

Pour utiliser le node Convert IMG to SVG de la manière la plus performante, il est fortement recommandé d'installer l'utilitaire Potrace et de l'ajouter au PATH de votre système. Ce guide vous montrera comment faire, étape par étape.

Étape 1 : Télécharger Potrace

1. Rendez-vous sur la page officielle : http://potrace.sourceforge.net/#downloading
2. Cherchez la section "Windows" et téléchargez la dernière version 64-bit (ex: potrace-1.16.win64-x64.zip).

   Note : Prenez bien la version 64-bit (win64), adaptée à la majorité des ordinateurs modernes.

Étape 2 : Créer un Dossier et Extraire les Fichiers

1. Dans l'Explorateur de Fichiers, allez à la racine de votre disque C:.
2. Créez un nouveau dossier nommé Potrace.
3. Extrayez tous les fichiers de l'archive .zip téléchargée directement dans ce dossier C:\Potrace.

   📁 Votre dossier C:\Potrace doit maintenant contenir potrace.exe et d'autres fichiers.

Étape 3 : Ajouter Potrace au PATH Système

C'est l'étape la plus importante. Elle permet à Windows de trouver potrace.exe depuis n'importe où.

1. Dans le menu Démarrer, cherchez et ouvrez "Modifier les variables d'environnement système".
2. Cliquez sur le bouton "Variables d'environnement...".
3. Dans la section du haut ("Variables utilisateur"), sélectionnez la ligne Path et cliquez sur "Modifier...".
4. Cliquez sur "Nouveau" et collez le chemin de votre dossier : C:\Potrace.
5. Cliquez sur OK sur toutes les fenêtres pour sauvegarder.

Étape 4 : Vérifier l'Installation

1. Ouvrez un NOUVEAU terminal (via cmd dans le menu Démarrer).
2. Tapez potrace --version et appuyez sur Entrée.
3. Si tout est correct, la version de Potrace s'affichera.

   ✅ Félicitations ! Potrace est prêt. Si ComfyUI ne le trouve pas, redémarrez-le.

✍️ Installer des Polices Personnalisées (pour DAO Text Maker)

Le node DAO Text Maker vous permet d'utiliser n'importe quelle police au format .ttf ou .otf. L'installation est très simple.

Étape 1 : Trouver et Télécharger une Police

Choisissez une police sur un des sites recommandés. Cherchez le bouton "Download" pour obtenir un fichier .zip.

• Google Fonts (le plus sûr)
• Fontshare
• Velvetyne
• DaFont (Attention : vérifiez la licence de chaque police !)

Étape 2 : Localiser et Copier la Police

1. Naviguez jusqu'au dossier : ComfyUI/custom_nodes/ComfyUI_DAO_master/Fonts/.
2. Ouvrez le .zip que vous avez téléchargé.
3. Copiez le ou les fichiers .ttf ou .otf directement dans ce dossier Fonts.

Étape 3 : Rafraîchir dans ComfyUI

1. Retournez dans ComfyUI.
2. Sur votre node DAO Text Maker, cliquez sur le bouton de rafraîchissement ↻.
3. Votre nouvelle police apparaîtra dans le menu déroulant font_file.

⚠️ Note sur les Licences

Respectez le travail des créateurs. Les polices de Google Fonts, Fontshare et Velvetyne sont généralement open-source et sûres pour tout usage. Sur DaFont, beaucoup de polices sont "gratuites pour un usage personnel" uniquement. Vérifiez toujours la licence avant utilisation.

---

🌟 Show Your Support

If this project helped you, please consider giving it a ⭐ on GitHub!

Made with ❤️ for the ComfyUI community

by Orion4D