Modules procéduraux
Construire, configurer et maintenir les modules procéduraux depuis la banque de recettes.
Le Module Manager réunit la banque de modules et les instances de la scène. Il permet de préparer leur configuration, de les construire et de les modifier depuis la même interface.
Dans le shelf weSkel, cliquez sur l’icône Module Manager.
from weSkel.src.ui import modules
modules.show_dockable(floating=True) # Floating on first opening; Maya may restore a saved dock.# modules.show() # Alternative: standalone floating window.| Repère | Fonction |
|---|---|
| 1 · Scène | Scene Modules liste les instances présentes dans Maya. |
| 2 · Éditeur | Le panneau central suit votre sélection : Create Module depuis la banque, ou les réglages de l’instance choisie dans la scène. |
| 3 · Banque | Module Bank regroupe les modules disponibles pour créer une instance. |
Choisissez une instance pour afficher ses réglages dans le panneau central.
| Repère | Fonction |
|---|---|
| 1 · Actualiser | Relit les modules présents dans la scène. |
| 2 · Filtres | Recherche par Base Name ou définition ; filtres Revision et Side. |
| 3 · Instances | Affiche le nom, la définition, la révision et les côtés de chaque instance. Un clic ouvre son panneau Module Instance. |
| 4 · Sélection | Select in Maya sélectionne la racine de l’instance. Choisir une ligne dans le Manager ne change pas la sélection Maya. |
Choisissez une définition pour préparer une nouvelle instance.
| Repère | Fonction |
|---|---|
| 1 · Filtres | Recherche par définition et filtres Revision / Compatibility. |
| 2 · Domaine | Domain limite la liste à une famille : Body, Facial, Extra, Cloth ou Props. All les réunit. |
| 3 · Modules | Dépliez une catégorie puis sélectionnez un module. Le panneau central passe en mode Create Module. |
| 4 · Description | Résume le module sélectionné. |
En mode Create Module, renseignez Base Name et les réglages. La configuration et l’aperçu se mettent à jour sans créer de nœuds Maya.
Build Module, ou Build Mirrored Pair avec Mirror, construit le plan valide. Un plan invalide bloque le bouton et affiche la cause. La nouvelle instance apparaît dans Scene Modules.
Le mode Module Instance affiche un module déjà construit. Les options dépendent de sa définition et de sa révision.
| Repère | Fonction |
|---|---|
| 1 · Identité | Base Name, définition, Rig Profile et Instance UUID identifient l’instance. Le badge indique la disponibilité du Rebuild. |
| 2 · Configuration | Options du module et design des contrôleurs. Side choisit le côté source ; Mirror prépare la paire L/R lorsque le module le permet. |
| 3 · Aperçu | Module Preview représente le plan : contrôleurs, placers et sorties, selon le module et les côtés activés. |
| 4 · Interface | Resolved Interface, ici déplié, présente les entrées et sorties du plan : Side, Direction, Port, Channels. Lecture seule. |
| 5 · Actions | Rebuild, Duplicate et Delete agissent sur l’instance sélectionnée ; leurs effets sont détaillés plus bas. |
Les réglages proposés varient selon le module. Les couleurs utilisent le picker Chroma.
| Réglage | Rôle |
|---|---|
| Shape / Color | Choisit la forme et la couleur des contrôleurs concernés. |
| Palette | Applique la palette définie par le module lorsqu’il en propose une. |
| Output Color | Règle la couleur des joints de sortie lorsque cette option est disponible. |
| Controller Scale / Line Width / Hide on Playback | Règle l’affichage des contrôleurs : taille, épaisseur des traits et visibilité pendant la lecture, selon les options prises en charge. |
Avant Build, ces réglages appartiennent au plan. Sur une instance existante, certains s’appliquent immédiatement, comme indiqué ci-dessous.
Choisissez l’instance dans Scene Modules. Le panneau central affiche son Base Name, sa définition, son Rig Profile et ses réglages.
| Modification | Application |
|---|---|
| Configuration structurelle | Prépare un nouveau plan. CHANGES PENDING signale les changements à appliquer avec Rebuild. |
| Shape, Color, palette, Output Color | S’applique immédiatement sur une instance compatible, sans Rebuild implicite. Les modifications sont conservées dans la scène. |
| Affichage avancé | S’applique immédiatement si le module le prend en charge ; sinon au prochain Rebuild. |
| Base Name | Saisissez le nouveau nom puis Entrée pour renommer l’instance. La saisie seule ne la renomme pas. |
| État | Signification |
|---|---|
| VALID / INVALID | Le plan peut être construit, ou doit être corrigé. Un ancien aperçu encore visible ne valide pas le nouveau plan. |
| SUPPORTED / LIMITED | Indique la disponibilité du Rebuild pour cette instance. Une action indisponible conserve son diagnostic. |
| CHANGES PENDING | La configuration préparée diffère de celle construite. |
| REBUILDING… / REBUILT / REBUILD FAILED | Progression et résultat du dernier Rebuild de l’instance affichée. En cas d’échec, consultez le diagnostic et ses détails. |
| Action | Effet |
|---|---|
| Rebuild | Reconstruit l’instance depuis le plan courant, après validation. Reste disponible même sans changement de configuration pour reconstruire avec le code courant. Les suppressions de côtés, ports ou éléments de configuration concernés demandent confirmation. |
| Duplicate | Demande un nouveau Base Name, puis construit une instance indépendante. Les connexions externes et le skin existant ne sont pas clonés. |
| Delete | Supprime l’instance après confirmation et contrôle des dépendances. Son squelette de skin détaché est conservé ; des connexions entre modules peuvent bloquer la suppression. |
Build, Rename, Rebuild, Duplicate et Delete vident tout l’historique Undo de Maya avant et après leur exécution, même en cas d’erreur. Enregistrez la scène avant ces actions. Le rafraîchissement et Select in Maya ne vident pas cet historique.