⚙️ Système de Nodes — Guide Complet
Le cœur de SFUMIA est un éditeur nodal : chaque étape de production est un node que l'on connecte à d'autres pour former un graphe de pipeline.
Catalogue : les nodes disponibles apparaissent normalement. Les fonctions qui demandent une activation supplémentaire restent visibles mais grisées, avec une explication au clic.
Anatomie d'un Node
Chaque node est composé de plusieurs éléments :
Header (en-tête)
- Icône — identifie visuellement le type de node
- Nom — renommable par double-clic (nécessite le lock)
- Type — affiché en petit à droite du nom
- Badge Pipeline Status — WIP / Review / Done / Retake (clic pour cycler)
- Cadenas 🔒/🔓 — verrouiller/déverrouiller
- Badge Réseau/Local ☁️/💻 — pour les nodes .blend uniquement
- Badge ✓ — indique qu'une version est publiée
Body (contenu)
- Chemin du dossier — emplacement sur le disque
- Version — numéro actuel + version publiée
- Auteur — qui a locké le node
- Contenu spécifique — boutons Run, preview, paramètres (varie par type)
- Section OUTPUT — fichiers générés avec preview adaptée
Ports (entrées/sorties)
- Port d'entrée (gauche) — cercle vide, reçoit des données
- Port de sortie (droite) — cercle plein coloré, envoie des données
- Certains nodes ont des ports nommés (prompt, image_1, image_2, sam, video...)
- Les nodes SAM, Crop Regions et Video Trim ont des ports dynamiques (un par segment/zone)
Créer un Node
- Clic droit sur le canvas → menu contextuel hiérarchique
- Choisir la catégorie (3D, IA, Images, Vidéo, Audio, Utilitaires, Folders)
- Choisir le type de node
- Le node apparaît à la position du clic
Il y a aussi un champ de recherche en haut du menu pour trouver rapidement un type par nom.
Raccourci : Appuyez sur H pour créer un Hub à la position du curseur.
Connexions (Edges)
Les connexions relient les nodes entre eux pour faire circuler les données.
Créer une connexion
- Cliquer-glisser depuis un port de sortie (cercle droit)
- Relâcher sur un port d'entrée (cercle gauche) d'un autre node
- Si vous relâchez sur le corps d'un node avec ports nommés, le premier slot libre est auto-assigné
Types de données transportées
| Type | Exemples de nodes source | Exemples de nodes cible |
|---|
| Image | qwen_edit, flux_klein, img_* | tous les img_*, display |
| Vidéo | wan22, import_video | display_video, video_resize, video_trim |
| Modèle 3D | gs_to_mesh, import_glb | glb_display, nodes .blend |
| Texte (Prompt) | prompt | tous les nodes publiés qui déclarent un slot prompt |
| Audio | import_audio | wan22 (S2V) |
| Fichier Blender | mod, rig, anim, etc. | rig, anim, render, etc. |
Disponibilité : un node grisé ne peut ni créer un job ni consommer de crédits. Cliquez dessus pour connaître la condition manquante.
Connexions spéciales
- Inter-shots — connexions entre nodes de shots différents (tirets)
- Inter-projets — cross-links entre projets différents (couleur teal)
- Hub — point de passage qui transmet les données sans les modifier
- Relay In/Out — connexion sans fil par identifiant de canal stable ; le nom affiché n'est qu'un libellé et peut être dupliqué
Supprimer une connexion
Clic droit sur une edge → "Casser le lien". Ou sélectionner le node et les connexions sont listées dans le panneau de droite avec un bouton ✕.
Pipeline Status
Chaque node a un statut qui indique sa progression. Cliquer sur le badge pour cycler :
| Statut | Couleur | Description |
|---|
| WIP | ● Orange | Travail en cours — statut par défaut à la création |
| Review | ● Violet | En attente de validation client/superviseur |
| Done | ● Teal | Validé et terminé |
| Retake | ● Rouge | Corrections nécessaires — le node a une bordure rouge et un glow |
Les statuts se synchronisent bidirectionnellement avec ProProd (le système de suivi de production).
Verrouillage (Lock)
Le système de lock empêche les modifications concurrentes :
- 🔓 Déverrouillé — les contrôles sont grisés, le node est en lecture seule
- 🔒 Verrouillé — vous avez le contrôle exclusif, votre nom s'affiche
- Cliquer sur le cadenas ou appuyer sur L
- Certains nodes (Import Audio, Crop Regions) s'auto-lockent quand nécessaire
Attention : Un node en mode Local (💻) ne peut pas être déverrouillé. Repassez-le en Réseau (☁️) d'abord avec T.
Versioning
Chaque node avec un fichier (.blend, .psd, .aep, etc.) supporte le versioning :
Créer une version
- Verrouiller le node
- Ajouter un commentaire dans le champ prévu
- Cliquer + Version (ou touche V pour focus)
- Le fichier est copié :
nom_v001.blend, nom_v002.blend...
Publier
- Touche P ou bouton 🚀 Publish
- La version est copiée comme
nom_publish.blend
- C'est cette version qui est liée par les autres nodes
- Un badge ✓ apparaît sur le node
Reset
Touche R — Revient au fichier publié. Utile après des modifications non souhaitées.
Output Files
Les nodes qui génèrent des fichiers (IA, import, resize, trim...) ont une section OUTPUT en bas du node :
Nodes locaux optionnels : installez leurs composants depuis le gestionnaire SFUMIA. Un composant manquant ou altéré est refusé avant le lancement, sans modifier le projet.
Fonctionnalités
- Preview adaptée — Image, Vidéo, Audio (player), 3D (model-viewer), PLY (bouton viewer)
- Refresh ↻ — Rescanner le dossier et renommer les fichiers selon la nomenclature
- Ouvrir 📂 — Ouvrir le dossier dans l'explorateur
- Sélection — Dropdown pour choisir quel fichier est l'output actif
- Auto-sélection — Après chaque génération, le dernier fichier est automatiquement sélectionné
Nomenclature des fichiers
Le Refresh renomme automatiquement les fichiers selon le format :
{shot}_{nom_du_node}_001.ext
{shot}_{nom_du_node}_002.ext
...
Exemple : base_AI-Qwen-Edit_001.png, base_AI-Qwen-Edit_002.png
Sélection Multiple
- Rectangle de sélection — Cliquer-glisser sur le canvas (pas sur un node)
- Shift+clic — Ajouter/retirer un node de la sélection
- Actions en batch : Lock/Unlock, Publish, Reset, Delete — s'appliquent à tous les nodes sélectionnés
Redimensionner un Node
Les nodes redimensionnables ont une poignée en bas à droite (traits diagonaux). Glisser pour redimensionner. La preview s'adapte à la nouvelle taille.
Nodes resizables : ai_image, image_compare, prompt, display, display_video, tous les IA, IMG_*, crop_regions, video_trim, subgraph, import_audio.
Renommer un Node
- Verrouiller le node
- Double-clic sur le nom dans le header
- Saisir le nouveau nom → Entrée
- Le dossier sur disque est renommé automatiquement
- Les fichiers média sont renommés avec le nouveau préfixe
- Si c'est un sous-graphe, tous les dossiers enfants sont mis à jour en cascade
Ouvrir dans Blender / Explorateur
| Action | Raccourci | Description |
|---|
| Ouvrir dans Blender | O | Ouvre le fichier .blend dans Blender |
| Ouvrir (read-only) | Ctrl+O | Ouvre sans verrouiller le node |
| Ouvrir le dossier | E | Ouvre le dossier dans l'Explorateur Windows |
Undo / Redo
- Ctrl+Z — Annuler la dernière action
- Ctrl+Shift+Z ou Ctrl+Y — Rétablir
- L'annulation d'une création de node supprime aussi le node du serveur et son dossier (avec confirmation)
- Les déplacements, renommages, changements de propriétés sont tous annulables
Cascade Publish
Touche C — Publie le node sélectionné puis propage automatiquement la publication à tous les nodes connectés en aval. Utile pour mettre à jour tout le pipeline après une modification en amont.