SFUMIA⚙️ Système de Nodes : Guide Complet
Documentation mise à jour le . Les fonctions disponibles dépendent de votre version et de votre installation.
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.
Anatomie d'un Node
Chaque node est composé de plusieurs éléments :
En-tête
- Icône : identifie visuellement le type de node
- Nom : renommable par double-clic (nécessite le verrouillage)
- Type : affiché en petit à droite du nom
- Badge de statut : En cours / À valider / Terminé / À reprendre (clic pour cycler)
- Cadenas 🔒/🔓 : verrouiller/déverrouiller
- Badge Réseau/Local ☁️/💻 : pour les scènes 3D prises en charge
- Badge ✓ : indique qu'une version est publiée
Contenu
- Chemin du dossier : emplacement sur le disque
- Version : numéro actuel + version publiée
- Auteur : qui a verrouillé le node
- Contenu spécifique : boutons Générer ou Exécuter, aperçu et paramètres (varie par type)
- Section SORTIES : fichiers générés avec aperçu adapté
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, Zones de recadrage et Découpage vidéo ont des ports dynamiques (un par segment/zone)
Créer un Node
- Clic droit sur le canvas : choisissez une catégorie ou recherchez le node par son nom.
- Les catégories IA Image, IA Vidéo et IA 3D distinguent Local et Cloud. Les nodes de fabrication se trouvent dans 3D, puis Blender ou Maya.
- Les variantes compatibles d’une famille sont regroupées : choisissez la version, le modèle ou l’opération dans les propriétés du node.
- Ajoutez et reliez le node. Pour un modèle local absent, ouvrez Modèles locaux · Installation et préparez le composant séparément.
Créer un node ne lance pas de génération. L’état de disponibilité et les conditions d’exécution restent visibles. Le raccourci H crée un Hub à la position du curseur.
Connexions (Edges)
Glissez d’un port de sortie à droite vers un port d’entrée à gauche. Pour un node à plusieurs entrées nommées, choisissez le port correspondant à la donnée.
| Donnée | Exemple de source | Usage |
|---|---|---|
| Image | Import, génération, traitement d’image | Référence, retouche, comparaison, génération compatible |
| Vidéo | Import ou génération vidéo | Lecture, découpe, montage |
| 3D | Modèle importé ou généré | Aperçu et import dans une étape 3D compatible |
| Texte | Prompt ou document compatible | Instruction d’un node doté d’une entrée texte |
| Audio | Import, voix, bruitages ou musique | Écoute, montage et génération compatible |
| Scène native | Modélisation, rig, animation | Étape suivante du pipeline Blender ou Maya |
Les liens entre plans ou projets suivent leurs autorisations. Un Hub transmet la donnée ; les relais utilisent une identité stable de canal, même si deux libellés sont identiques. Les sous-graphes passent par leurs portails.
Clic droit sur une connexion, puis Casser le lien, ou utilisez la liste des connexions du panneau de droite. Retirer une connexion ne supprime pas automatiquement une ancienne publication.
Statut de production
Chaque node a un statut qui indique sa progression. Cliquer sur le badge pour cycler :
| Statut | Couleur | Description |
|---|---|---|
| En cours | ● Orange | Travail en cours : statut par défaut à la création |
| À valider | ● Violet | En attente de validation client/superviseur |
| Terminé | ● Vert | Validé et terminé |
| À reprendre | ● Rouge | Corrections nécessaires : le node a une bordure rouge et une lueur |
Les statuts se synchronisent bidirectionnellement avec ProProd (le système de suivi de production).
Verrouillage
Le système de verrouillage 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, Zones de recadrage) se verrouillent automatiquement quand nécessaire
Versions
Le panneau droit réunit Propriétés en haut et Versions / Publication en bas. Chaque partie défile séparément ; le séparateur horizontal règle leur hauteur. Une version conserve un état de travail, une publication choisit l’état destiné aux étapes suivantes. Les droits disponibles varient selon le type du node.
Chaque node avec un fichier (.blend, .psd, .aep, etc.) permet de conserver des versions :
Créer une version
- Verrouiller le node
- Ajouter un commentaire dans le champ prévu
- Cliquer + Version (ou touche V pour saisir le commentaire)
- Le fichier est copié :
nom_v001.blend,nom_v002.blend...
Publier
- Touche P ou bouton 🚀 Publier
- 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
Réinitialiser
Touche Ctrl + R : Reconstruit la copie locale du node à partir des versions publiées et réimporte ses entrées. Une confirmation précède cette action. La publication et l’historique réseau restent conservés.
Fichiers de sortie
Les nodes qui génèrent des fichiers (IA, import, resize, trim...) ont une section SORTIES en bas du node :
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_IA-Qwen-Edit_001.png, base_IA-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 lot : Verrouiller / Déverrouiller, Publier, Réinitialiser, Supprimer : s'appliquent à tous les nodes sélectionnés
Redimensionner un Node
Glissez la poignée en bas à droite lorsqu’elle est proposée. Le cadre et le contenu suivent la taille autorisée ; l’aperçu conserve ses proportions par défaut. Maj libère temporairement la contrainte des aperçus compatibles.
Les modes détaillé, aperçu et minimal gardent le même node et ses connexions. En mode minimal, le titre et la pastille sont alignés dans l’en-tête, les entrées restent centrées et les couleurs des états sont identiques dans tous les thèmes.
Renommer un Node
Utilisez le nom dans l’en-tête ou les propriétés, avec les droits nécessaires. Pour une scène 3D qui possède déjà des versions, le nom affiché peut changer mais son dossier, ses fichiers et son identité de dépendance restent stables.
Les autres types adaptent leur stockage selon leur fonctionnement. Ne renommez pas leurs dossiers à la main pendant le travail. Les projets ou plans contenant des références natives peuvent refuser un renommage qui romprait les dépendances ; voir le guide 3D.
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 |
Annuler / Rétablir
Ctrl + Z annule une manipulation compatible ; Ctrl + Maj + Z ou Ctrl + Y la rétablit. Les opérations sur le stockage, les versions et les publications disposent de leurs confirmations propres et ne doivent pas être assimilées à un simple déplacement de carte.
En cas d’édition concurrente ou de sauvegarde refusée, relisez l’état courant avant de refaire l’action. L’historique local du canvas ne remplace pas une sauvegarde de l’espace.
Publication en cascade
Touche Ctrl + Shift + R : Publie les scènes 3D prises en charge en amont, du plus lointain jusqu’au node sélectionné. Enregistrez d’abord les scènes dans leur logiciel. Les nodes consommateurs sont ensuite synchronisés avec les publications.