Skin Influences per Vertex

Ouvrir le diagnostic

Dans le Script Editor Python de Maya 2026.3 :

from weSkel.src.tools.skinning import show_skin_influences_per_vertex

show_skin_influences_per_vertex()

Pour une fenêtre dockable, flottante à la première ouverture :

from weSkel.src.ui.skinning import skin_influences_per_vertex as ui

ui.show_dockable(floating=True)

Avec floating=True (défaut), Maya utilise son état mémorisé ou démarre flottant à la première ouverture. ui.close() conserve ses préférences ; ui.reset_dockable_state() les réinitialise explicitement. Chaque ouverture remplace l’instance précédente. Le lanceur public équivalent est weSkel.src.tools.skinning.show_skin_influences_per_vertex_dockable().

Capturer puis analyser

Étape	Action	Périmètre
1	Sélectionner des meshes et/ou vertices, puis Use Selection.	Capture leur union sans doublons et lance le calcul.
2	Lire le tableau, trié du plus grand au plus petit nombre d’influences.	Compte les poids strictement positifs pour chaque vertex capturé.
3	Choisir View : tous les meshes ou un seul.	Filtre le résultat existant sans relire Maya ; les pourcentages suivent cette vue.
4	Sélectionner des groupes à examiner.	Les actions du tableau changent la sélection Maya, sans remplacer le périmètre capturé.
5	Après modification des poids, cliquer Refresh.	Relit le même périmètre explicite. Pour en changer, utiliser Use Selection.

Les résultats sont un instantané : une modification de scène ne déclenche pas de recalcul automatique. Le résumé rappelle les sources et réglages du dernier calcul. Modifier un réglage invalide le tableau jusqu’au prochain Refresh.

Réglages de comptage

Réglage	Valeur initiale	Effet
Rounding filter	Désactivé	Simule un arrondi au pas positif saisi ; à 0.001, un poids de 0.0005 reste compté.
Respect Post normalization	Activé	Tient compte du mode natif Post en mémoire. Désactivé, compte les poids bruts. Sans mesh en mode Post, le résumé indique que le réglage est sans effet.
Résumé d’arrondi	Visible lorsque l’arrondi est actif	Compte les vertices ayant moins d’influences après arrondi, depuis le même lot de poids et sans seconde lecture Maya.

La lecture du skinCluster inclut la sortie composée et filtrée de ngSkinTools2 lorsque ses données sont attachées. L’outil ne modifie ni les données natives ni les layers ngSkinTools2.

Sélectionner les résultats

Commande	Résultat dans Maya
Select vertices d’une ligne	Sélectionne le groupe correspondant dans la vue affichée.
Select rows	Sélectionne l’union des lignes choisies avec Ctrl/Shift.
Select ≥ N	Sélectionne tous les groupes dont le nombre atteint ou dépasse le seuil : 7 inclut 7, 8 et au-delà.
Select affected vertices	Avec un arrondi actif, sélectionne les vertices ayant perdu des influences dans le comptage simulé, pour la vue affichée.

Les actions de sélection prennent en charge Undo/Redo. Sans correspondance pour le seuil dans la vue, la sélection Maya est vidée. Le bouton des vertices affectés reste désactivé sans résultat valide ou sans vertex affecté. L’identité et la topologie des sources sont contrôlées avant sélection.

Exporter et interrompre

Action / information	Contenu
Copy JSON	Copie le diagnostic de la vue affichée ; même sérialisation que l’export JSON.
Export → JSON (défaut)	Schéma versionné, résumé, réglages, sources et indices des vertices par groupe et affectés par l’arrondi.
Identités JSON	mesh_uuid identifie la shape analysée ; skin_cluster_uuid conserve la source au moment du calcul, indépendamment des renommages.
Export → CSV	UTF-8 avec BOM, séparateur virgule, une ligne par groupe avec périmètre, réglages et heure du calcul.
Progression / Cancel	Annulation entre les lots ; aucun résultat partiel n’est publié.
Temps Total	Inclut les vérifications et, pour Use Selection, la capture.

La taille initiale est de 650 × 600 pour garder au moins huit lignes visibles ; une taille déjà mémorisée par Maya reste prioritaire.

Résoudre un refus

Diagnostic	Vérification
Mesh sans skin ou résolution ambiguë	Contrôler le mesh et le skinCluster réellement visés.
Topologie incompatible	Refaire une capture cohérente avec le skin ; ne pas réutiliser des indices périmés.
Poids invalides	Examiner les données signalées avant un nouveau calcul.
Mauvais checkout chargé	Vérifier weSkel.__file__ ; après changement de checkout, relancer Maya si le package était chargé ailleurs.