Pushers

Pushers pilote des correctifs à partir de l’orientation du Driver par rapport à une Reference. Les poses capturées alimentent un RBF quaternion, puis chaque sortie transforme le résultat en déplacement.

Ouvrir l’outil

Dans le shelf weSkel, cliquez sur l’icône Pushers.

Depuis Python

from weSkel.src.ui import pushers

pushers.show_dockable(floating=True)  # Floating on first opening; Maya may restore a saved dock.
# pushers.show()                      # Alternative: standalone floating window.

Vue d’ensemble

weSkel Pushers · thème Poseidon.

Repère	Fonction
1 · Modules	Les Pushers de la scène. Le filtre réduit la liste ; + New module… crée un module.
2 · Module actif	Base Name, côté L / C / R, reader, sorties, poses et réglages du module sélectionné.
3 · Presets	La bibliothèque de presets. La flèche permet de replier le panneau.

Créer un correctif

Étape	Action
1 · Module	Cliquez sur + New module…, choisissez un Base Name et les côtés, puis Create Module.
2 · Reader	Dans Reader Matrices, utilisez Select… pour connecter les plugs matrices Reference et Driver. Le reader mesure leur orientation relative.
3 · Sorties	+ Add outputs… ajoute les directions locales ±X, ±Y, ±Z nécessaires. Sélectionnez une sortie.
4 · Rest	Placez le rig au repos puis Capture Rest : cette relation Reference/Driver devient l’origine des poses.
5 · Pose	Posez le rig, cliquez sur + Capture Pose et nommez la capture. Réglez ensuite les valeurs par sortie dans Pose Value.
6 · Réponse	Testez les poses intermédiaires et ajustez les plages, le remap et l’orientation de la sortie.

Portée	Effet
L / C / R	Choisit le côté actif.
Mirror L/R edits	Étend les éditions compatibles à l’autre côté. Lors d’une capture, chaque côté lit sa propre pose : posez les deux côtés avant de capturer.
Edit all outputs	Activé par défaut : étend notamment Pose Value, plages, remap et orientation à toutes les sorties concernées. Désactivez-le pour régler une seule sortie.

Capturer et ajuster les poses

Poses Output Values · thème Poseidon.

Repère	Fonction
1 · Rest	Capture Rest définit le repos. Recapture Rest le remplace et supprime les poses nommées des côtés concernés, après confirmation ; sorties et connexions du reader sont conservées.
2 · Poses	Une ligne par pose, une colonne par sortie. rest est verrouillé. Sélectionner une ligne affiche la capture ; cela ne replace pas le rig dans cette pose.
3 · Valeur	Pose Value modifie la valeur de la pose pour la sortie sélectionnée, ou toutes les sorties si Edit all outputs est actif.
4 · Actions	+ Capture Pose ajoute une pose. Recapture Pose remplace l’orientation de la pose sélectionnée depuis la scène. Delete Pose la supprime.

Les angles X / Y / Z sous le tableau décrivent l’orientation capturée, relative à Reference et au Rest. Ce ne sont pas les canaux de rotation locaux du Driver. Les poses d’orientation identique ou quasi identique sont refusées.

Régler une sortie

Selected Output · thème Poseidon.

Repère	Fonction
1 · Plages	Input Min / Max définit la plage du résultat RBF ; Output Min / Max, la plage de déplacement après remap.
2 · Remap	Edit Remap Curve règle la réponse entre ces deux plages.
3 · Orientation	0 % suit l’orientation de Reference ; 100 %, celle du Driver. La position de base reste celle du Driver.
4 · Sortie	Published Matrix nomme la matrice de sortie. Create Output Transform et Create Skin Joint ajoutent leurs consommateurs. Capture Default fournit la valeur de repli lors de l’ajout de captures ou de sorties ; il ne remplace pas les valeurs déjà capturées.

Les directions restent locales. Le côté R applique une réflexion de l’axe X, même si Mirror L/R edits est désactivé. Published Matrix reste propre à la sortie sélectionnée.

Réglages RBF

Réglage	Rôle
Radius	Règle l’étendue de réponse du noyau autour des poses ; valeur strictement positive.
Regularization	Stabilise la résolution ; une valeur plus élevée peut éloigner la réponse des valeurs capturées.
Conditioning	Diagnostic de stabilité numérique du système de poses.
Kernel / Normalize	Noyau inverse_quadratic et normalisation imposés.

Ajuster le remap

L’éditeur reste ouvert pendant que vous testez le rig. Les modifications sont prévisualisées dans la scène.

Compare Original affiche la courbe initiale ; Return to Edited retrouve les modifications.

Action	Effet
Points	Glissez un point, cliquez-glissez un segment pour en ajouter un, ou utilisez + Add Point. Position, Value et Interpolation permettent une saisie précise ; Delete Point retire le point actif.
Reset Linear	Remplace la courbe en cours par une droite.
Compare Original	Affiche temporairement les courbes initiales. Return to Edited retrouve les modifications.
Apply	Conserve les courbes modifiées.
Cancel / fermeture	Restaure les courbes initiales des cibles encore valides, y compris en fermant le Manager.

Le périmètre est fixé à l’ouverture de l’éditeur. Il faut au moins deux points, avec des positions distinctes et ordonnées entre 0 et 1.

Convertir un sculpt en poids

Pusher Sculpt Baker recherche les poids des influences Pusher capables de reproduire un sculpt dans la pose courante.

Pusher Sculpt Baker · thème Poseidon.

Repère	Fonction
1 · Meshes	Source mesh reçoit les poids. Sculpt target est un duplicata sculpté dans la même pose, avec la même topologie indexée. Renseignez chaque champ avec Use Selected.
2 · Destination	Pusher system et Side choisissent les influences. Avec ngSkinTools, Layer name nomme la nouvelle correction ; Separate layer per influence la répartit en sous-layers.
3 · Précision	Bake tolerance contrôle l’écart entre le résultat prédit et le bake évalué. Allow approximate bake autorise les sculpts non reproductibles exactement. Limit influences per vertex impose un maximum total, au prix possible d’une perte de fidélité.
4 · Actions	Analyze calcule une proposition sans écrire de poids. Consultez le diagnostic, puis Bake Sculpt to Weights pour l’appliquer. Select approximated vertices permet d’inspecter les écarts.

Skin de la source	Résultat
ngSkinTools attaché	Crée un layer de correction ; les layers existants restent conservés. Un nom déjà utilisé bloque le bake.
skinCluster natif	Écrit directement les poids. Aucun layer séparé : les proportions des autres influences sont conservées sur la part restante.
Undo / Redo	Un bake réussi est une commande annulable et rétablissable dans Maya, pour les deux sorties.

Conditions et diagnostics

Le Baker requiert un skin Classic Linear, une normalisation Interactive et une Envelope à 1. Les influences Pusher doivent déjà faire partie du skin. La source ne doit pas contenir de déformation supplémentaire non prise en charge après le skin.

Une analyse devenue obsolète impose Analyze à nouveau. Si des tweaks de la source sont détectés, leur nettoyage demande une action explicite ; il n’est pas effectué silencieusement. La tolérance de bake ne change pas la classification exact/approximatif du sculpt.

Presets

Action	Contenu
Save as preset…	Enregistre les côtés, poses, sorties, remaps, orientations et réglages RBF.
Build selected preset…	Valide le preset puis construit le module. Reconnectez Reference / Driver dans la scène cible : leurs connexions externes ne voyagent pas avec le preset.
Root Path / …	Choisit la bibliothèque. Emplacement par défaut : user_data/pushers/presets.
Delete Preset	Supprime le preset sélectionné de la bibliothèque ; ce n’est pas la suppression du module dans la scène.

Maintenir un module

Action	Conséquence
Rebuild	Ouvre les diagnostics et les contrôles préalables, puis reconstruit explicitement le runtime. Il n’est pas nécessaire après chaque édition courante.
Duplicate	Copie réglages, poses et reader dans un nouveau module avec de nouveaux joints. Skins, poids et consommateurs du module source ne sont pas transférés.
Delete	Supprime le module entier, quel que soit le côté actif. Le squelette de skin détaché et les sources Reference/Driver sont conservés ; des dépendances incompatibles peuvent bloquer l’action.
Undo du Manager	Les éditions de scène du Manager ne créent pas d’entrée Undo. Enregistrez votre scène avant les changements importants. Le Sculpt Baker dispose de sa propre commande Undo/Redo.