# 🎨 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 : ```sh 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 : ```sh 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](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**](https://fonts.google.com/) (le plus sûr) > * [**Fontshare**](https://www.fontshare.com/) > * [**Velvetyne**](https://velvetyne.fr/) > * [**DaFont**](https://www.dafont.com/fr/) (**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

SVG Passthrough (Text vers String)

Inputs (1)

Outputs (1)