Dépannage¶
La plupart des problèmes avec OTS sont l'une de trois choses : rien n'était sélectionné, les noms ne correspondent pas, ou la range était mauvaise. Cette page parcourt les symptômes dans l'ordre où vous risquez de les rencontrer.
La fenêtre ne s'ouvre pas¶
Rien ne se passe quand vous lancez le script.
C'est presque toujours Python. Harmony lance les scripts utilisateur via un Python 3.9 système présent dans le PATH, et un interpréteur 3.10 ou plus récent est silencieusement ignoré — pas d'erreur, pas de fenêtre.
Installez Python 3.9 64 bits, cochez Add Python to PATH, et redémarrez Harmony.
Une fenêtre d'erreur mentionnant un chemin. Le dossier harmony/ n'est pas là où le launcher l'attend. Ce doit être un dossier nommé octoTransformSync à l'intérieur de votre répertoire <version>-scripts. Voir Installation.
Le bouton de shelf ne fait rien, ou signale une erreur d'import. Maya ne trouve pas OTS dans son path Python. Relancez l'installeur par glisser-déposer — il réécrit l'entrée userSetup.py et rafraîchit le bouton de shelf sur place.
Pas d'onglet OTS dans la sidebar. L'add-on n'est pas activé. Vérifiez Edit → Preferences → Add-ons, cherchez Octo Transform Sync, et cochez-le. Puis appuyez sur N dans la vue 3D.
La liste d'export est vide¶
Vous avez appuyé sur + et rien n'est apparu. Rien d'éligible n'était sélectionné dans la scène. Sélectionnez d'abord les pegs / joints / armature, puis appuyez sur +.
Dans Blender, la boîte Scene selection en haut du panneau vous dit exactement ce qu'OTS peut voir — si elle affiche « Select an armature in the viewport », vous avez votre réponse.
Une partie de la sélection est apparue, mais pas tout. OTS ne scanne que les éléments qu'il peut exporter de façon utile. Les effets, les composites et les autres nœuds non-transform ne sont pas des transforms et ne suivent pas.
Tout est ambre à l'import¶
C'est normal sur une scène vide. Ambre veut dire « aucune cible trouvée dans cette scène » — et il n'y a encore rien à trouver. Appuyez sur Create Rig, pas sur Apply.
Voir L'arbre de correspondance.
Certaines lignes sont ambre¶
La ligne de la caméra est ambre. Attendu. Sur un import neuf, il n'y a aucun joint ni bone portant le nom de la caméra — c'est pour ça que les caméras sont comptées séparément dans la ligne de résumé. Create Cameras s'en charge.
Quelques lignes nommées sont ambre. Les noms diffèrent entre les deux scènes. Corrigez ça en :
- Double-cliquant la cellule Target path et en tapant le bon chemin, ou
- Renommant dans votre scène et en appuyant à nouveau sur Browse…, ou
- Décochant la ligne si vous n'en voulez pas.
La plupart des lignes sont ambre. Vous appliquez probablement un fichier à la mauvaise scène, ou bien vous voulez Create Rig plutôt qu'Apply.
Les lignes sont restées ambre après Create Rig¶
Attendu. La liste affiche l'état de correspondance du moment où vous avez fait Browse ; construire le rig ne la repeint pas. Appuyez de nouveau sur Browse… sur le même fichier pour relancer la correspondance.
Le rig lui-même va bien — vérifiez votre scène, pas la liste.
L'animation est fausse¶
Rien n'a bougé après Apply. Apply n'écrit que sur les lignes à la fois correspondues et cochées. Cherchez les lignes ambre et les cases décochées.
Le plan est coupé trop court. La range d'export ne couvrait pas toute l'action. Réexportez avec Scene range.
Ça bouge, mais la rotation est fausse. Vérifiez d'abord que vous n'êtes pas devant une scène Maya en Z-up, où les handles par key sont simplifiés. Si ce sont les valeurs elles-mêmes qui sont fausses, et non la forme de la courbe, c'est un bug qui mérite d'être signalé — joignez le fichier, les versions des deux applications, et ce que la rotation aurait dû être.
Un bone est au bon endroit mais pas ses enfants. Vous avez exporté une chain partielle et le parent par rapport auquel elle a été rendue relative n'est pas dans le fichier. Exportez la chain depuis un ancêtre commun vers le bas.
Les courbes sont arrivées en escalier. Les keys sources étaient en stepped, ou la rotation a voyagé sous forme de quaternion — auquel cas le type d'interpolation voyage quand même mais pas les handles par key, par conception. Voir Format de fichier.
Quelque chose à propos du fichier¶
« Unsupported version N ». Le fichier a été écrit par un autre build d'OTS. Il n'y a pas de migration ascendante, par conception ; réexportez depuis l'application source.
« Missing 'pegs' key » ou une erreur de format. Vous avez chargé un .pvt dans le tab .anm, ou l'inverse. Les sélecteurs de fichiers filtrent par extension, donc ça veut généralement dire que le fichier a été renommé.
Le fichier est énorme. Une large range de frames sur un gros rig. Resserrez la range — seules les frames keyées plus les bornes de la range sont échantillonnées, mais cent pegs sur mille frames, ça fait quand même beaucoup de keys.
Caméras¶
La caméra ne bouge pas. Dans un .anm, le mouvement vit sur le peg de la caméra. Assurez-vous que cette ligne était cochée et que vous avez aussi lancé Create Rig ou Apply — Create Cameras seul construit l'optique, pas le mouvement.
Le cadrage est trop serré. Vérifiez le sensor / film fit dans l'application cible : il doit être vertical. Un fit automatique ou horizontal réinterprète le FOV par rapport au mauvais axe et donne l'impression que tout est zoomé.
La caméra pointe dans la mauvaise direction. La visée inter-applications est best-effort. Vérifiez d'abord le roll, puis l'inclinaison. Les caméras Blender portent une correction de +90° en X par convention — si une caméra a fait un aller-retour via un fichier édité à la main, cette correction peut finir appliquée deux fois.
Voir Caméras.
Rigs¶
Deux personnages sont arrivés en un seul. Ils partageaient un tag de rig à l'export. Donnez à chaque chain root son propre nom dans la colonne Rig et réexportez.
Je n'arrive pas à découper cette chain. C'est correct — une chain connectée ne peut jamais être découpée entre plusieurs rigs, parce qu'un bone dans une armature différente de celle de son parent n'a pas de parent. Fusionner des roots déconnectés est autorisé ; découper une chain connectée ne l'est pas. Voir Rigs & multi-rig.
Camera_1 et Camera_2 ont été interverties. Elles ne devraient pas — les chains de caméra sont triées par nom avant d'être numérotées, précisément pour que les numéros soient stables d'une session à l'autre. Si elles ont vraiment été interverties, c'est que les chains ont été renommées.
Spécificités de Harmony¶
Un peg a perdu son 3D path après Apply. Délibéré, et documenté : appliquer une animation délie les colonnes 3D-path et quaternion-path et écrit des courbes bezier à canaux séparés. Les valeurs sont bonnes ; le mode de création, lui, a disparu. Appliquez plutôt sur un résultat de Create Rig si vous devez garder le peg d'origine intact.
Un fichier qui échoue proprement dans Maya échoue bizarrement dans Harmony. Les readers de Harmony ne font pas la même validation stricte, donc un mauvais fichier se manifeste différemment là-bas. Réexportez depuis la source.
Voir Dans Harmony.
Toujours bloqué¶
Incluez ceci dans un rapport et le diagnostic sera bien plus rapide :
- Les deux applications et leurs versions
- Quelle direction et quel format
- La ligne de résumé de la page d'import, mot pour mot
- Le fichier lui-même — c'est du JSON petit et lisible, et ça suffit généralement à trouver le problème