Chroma

Ouvrir Chroma

Dans le Script Editor Python de Maya 2026.3 :

from weSkel.src.ui import chroma

chroma.show_dockable(floating=True)

chroma.show() ouvre une fenêtre flottante. show_dockable() utilise l’état Maya mémorisé ou démarre flottant par défaut. chroma.close() ferme l’outil ; chroma.reset_dockable_state() efface explicitement l’état de docking mémorisé.

Appliquer une couleur

Étape	Action	Effet
1	Sélectionner les objets dans Maya.	Chroma résout les cibles compatibles pour chaque opération.
2	Activer Viewport, Outliner, ou les deux.	Viewport est actif par défaut ; Outliner est initialement désactivé.
3	Choisir une couleur dans Picker ou une palette.	Un clic change la couleur courante sans modifier Maya.
4	Cliquer Apply Color.	Applique la couleur à la sélection actuelle pour les opérations actives. Un double-clic sur un swatch applique aussi la couleur.
5	Lire le statut.	Il distingue les cibles traitées, ignorées, bloquées et en échec. Une réussite partielle reste visible.

Cliquer la couleur courante ouvre le sélecteur avancé HEX/RGB/HSV. Son bouton Apply valide la couleur locale du picker ; il faut ensuite Apply Color dans Chroma pour colorer la scène.

Quelle sélection est coloriée ?

Sélection Maya	Viewport	Outliner
Transform avec curves ou meshes directs	Shapes compatibles non intermédiaires, directement enfants.	Transform sélectionné.
Transform sans shape compatible	Aucune cible Viewport.	Transform sélectionné.
Joint	Shapes compatibles directes lorsqu’il en possède ; sinon le joint.	Joint sélectionné.
Shape curve ou mesh	Shape sélectionnée, hors intermédiaire.	Son parent immédiat.
Composants d’une curve ou d’un mesh	Shape entière, sans couleur par composant.	Parent immédiat de la shape.
Node non DAG ou type non supporté	Ignoré avec diagnostic.	Selon la compatibilité DAG ; les nodes non DAG ne sont pas des cibles.

L’outil ne parcourt pas récursivement les descendants d’un groupe. Les cibles communes sont dédupliquées.

Lire, réinitialiser et annuler

Commande / état	Comportement
Get Color	Lit la sélection et les opérations actives ; ne modifie pas Maya.
Couleur unique	Met à jour la couleur courante.
mixed colors	Plusieurs couleurs existent ; aucune moyenne n’est inventée.
Viewport / Outliner conflict	Les deux opérations actives ne concordent pas.
empty	Aucune couleur exploitable pour le périmètre demandé.
Reset	Rétablit l’état de couleur par défaut sur les cibles compatibles.
Undo / Redo Maya	Annule ou réapplique l’édition de scène Apply/Reset dans une seule opération.

Les canaux protégés ou cibles incompatibles sont signalés. Vérifier le statut avant de conclure que toute la sélection a été modifiée.

Gérer les palettes

Ouvrir Manage… depuis la liste des palettes.

Action	Résultat
Sélectionner une palette Factory · Read-only	Consultation ; la ressource livrée avec weSkel reste protégée.
＋ New Palette	Crée une palette personnalisée, éventuellement à partir d’une palette existante.
Renommer, ajouter/éditer/supprimer ou réordonner les swatches d’une palette custom	Enregistre les modifications de la bibliothèque utilisateur.
Delete sur une palette custom	Supprime son fichier après confirmation.
Reload	Relit la bibliothèque depuis les fichiers.
Invalid custom file	Conserve le fichier et expose son diagnostic ; l’édition est bloquée.

Ces écritures de fichiers ne relèvent pas de l’Undo de scène Maya. Les palettes custom sont enregistrées par défaut dans user_data/chroma/palettes, les palettes factory sous src/resources/chroma/palettes.