Pushers

Ouvrir le Manager

Dans le Script Editor Python de Maya 2026.3 :

from weSkel.src.ui import pushers

pushers.show_dockable(floating=True)

pushers.show() ouvre une fenêtre flottante. show_dockable() démarre flottant par défaut ou restaure l’état Maya mémorisé. pushers.close_dockable() ferme le dock ; pushers.reset_dockable_state() efface son état mémorisé.

Créer et régler un correctif

Étape	Action	Repère
1	Choisir la création d’un module dans la liste de scène.	Donner un Base Name et choisir les côtés proposés par le dialogue.
2	Connecter Reference et Driver.	Choisir leurs véritables plugs matriciels dans le sélecteur ; le reader utilise leur relation.
3	Poser le rig au repos puis Capture Rest.	Définit l’orientation de référence du reader.
4	Ajouter et sélectionner une sortie.	Choisir sa direction, ses plages et ses options de transform/joint.
5	Poser le Driver puis + Capture Pose.	Capture la pose quaternion avec les valeurs de sortie voulues.
6	Sélectionner une pose et une sortie, puis ajuster Pose Value.	Édite la valeur pour cette pose sur les sorties visées par Edit all outputs.
7	Tester les poses intermédiaires et ajuster le remap.	Vérifier le résultat sur le rig, au-delà des seules poses capturées.

Un module peut exister avec des sources reader incomplètes ; les diagnostics du runtime restent à résoudre avant de considérer le comportement comme prêt.

Recapture Rest remplace le repos et efface toutes les poses nommées des côtés concernés après confirmation. Les définitions de sorties et connexions reader sont conservées.

Côtés, sorties et portée des éditions

Réglage	Sens
Boutons L / C / R	Choisissent le côté actif ; les valeurs persistées sont l, c, r.
Mirror L/R edits	Étend les éditions latérales compatibles au côté opposé ; ce n’est pas le miroir géométrique du côté droit.
Directions posX, negX, posY, negY, posZ, negZ	Directions canoniques locales. Le runtime applique la convention de réflexion du côté droit, même sur un module droit seul.
Edit all outputs, actif par défaut	Étend Pose Value, remap, ranges, orientation et options de création aux sorties des côtés concernés ; les champs d’identité restent propres à la sortie sélectionnée.
Recapture Pose	Remplace la capture de la pose sélectionnée et met à jour le solver.
Delete Pose	Supprime la pose sélectionnée, avec la portée indiquée par l’interface.

Le miroir d’édition et les transformations du runtime ont des contrats séparés. Après une correction de code concernant un graphe déjà construit, une simple réouverture de l’UI ne remplace pas un Rebuild explicite.

Lire l’orientation capturée

Sélectionner une pose affiche son nom et ses angles X / Y / Z, colorés par axe, sous le tableau des poses.

Information	Signification
Source	Quaternion stocké de la pose : orientation du Driver relative à Reference et au Rest capturé.
Affichage	Représentation Euler d’ordre XYZ en degrés, arrondie au dixième.
Lecture	Aucun nouvel échantillonnage de la scène ; déplacer le Driver ne modifie pas la capture affichée. Utiliser Recapture Pose pour actualiser cette capture.
Aucune pose sélectionnée	Le texte d’aide du workflow revient.

Ces angles servent à lire la pose stockée ; ils ne constituent pas un éditeur de rotations ni une mesure des channels locaux du Driver.

Ajuster le remap

Edit Remap Curve ouvre un éditeur non modal avec aperçu live : la scène reste accessible pour tester la réponse.

Commande	Effet
Ajouter/déplacer/supprimer un point	Prévisualise la courbe sur le périmètre capturé à l’ouverture du dialogue.
Reset Linear	Propose une courbe linéaire dans cet aperçu.
Compare Original	Affiche les courbes d’ouverture de chaque cible ; un second clic revient aux éditions.
Apply	Conserve les courbes éditées.
Cancel / fermeture du dialogue ou du Manager	Restaure les courbes d’ouverture sur les cibles encore valides.

Les positions sont uniques, ordonnées entre 0 et 1, avec au moins deux points. L’interpolation suit les modes natifs du remap Maya. Changer ensuite la sélection, le côté ou la portée du Manager ne redirige pas l’éditeur déjà ouvert. Cancel concerne ces courbes : il n’annule pas les autres actions indépendantes effectuées dans la scène pendant l’aperçu.

Lifecycle et Undo

Action	Garantie et limite
Rebuild	Inspecte le runtime, effectue un préflight en lecture seule, puis reconstruit par génération temporaire ; un refus de préflight ne répare pas implicitement la scène.
Duplicate	Copie réglages, poses, design et sources/valeurs reader dans un nouveau runtime avec de nouveaux joints. Les skins, poids et consommateurs existants restent associés à la source.
Delete	Supprime le module entier, indépendamment du côté actif et de Mirror ; conserve le squelette de skin détaché et les objets sources Reference/Driver. Les éléments étrangers ou consommateurs externes incompatibles provoquent un refus.
Runtime legacy incompatible	Lire le diagnostic et le contrat de version ; les actions courantes ne constituent pas une migration automatique.
Undo Maya	Les commandes d’édition de scène Pushers ne créent pas d’entrée Undo et préservent l’historique préexistant. Enregistrer la scène avant les changements importants.

Presets

Action	Données
Save As Preset	Sérialise la spec complète : côtés, poses, sorties, remaps, blends et paramètres RBF.
Build Selected Preset	Valide le JSON avant toute mutation, puis utilise le même builder que la création manuelle.
Connexions Reference/Driver	Les rôles sont conservés ; les câbles vers des nodes Maya externes ne sont pas des données portables du preset. Reconnecter les sources dans la scène cible.
Stockage	Par défaut user_data/pushers/presets ; le Manager permet de choisir une racine de presets.

Les anciens champs TAR Degrees, Driver Axis et Invert sont refusés.