Dépannage¶

▶Video tutorial — coming soon

Survolez-le d'abord

La règle d'ORC est que l'infobulle d'un control désactivé est la raison de sa désactivation. Un bouton Compose grisé, un Paste refusé, un scope indisponible — chacun nomme sa propre solution. La majeure partie de cette page n'est utile que quand il n'y a rien à survoler.

Le log¶

%APPDATA%\OctoRigComposer\orc.log

Joignez-le quand vous contactez le support (? → Report a bug… pré-remplit votre version et l'identifiant machine).

Le système de licence tient un log séparé, orc_python_debug.log, dans votre dossier temp système.

Ça ne se lance pas¶

Message	Cause
Octo Rig Composer could not start: Python bridge unavailable.	Le dossier est manquant, mal nommé, ou dans le mauvais dossier `<version>-scripts`. La boîte affiche le chemin attendu — le dossier doit s'appeler exactement `octoRigComposer`.
Octo Rig Composer failed to launch.	Python a levé une exception au démarrage. Lisez `orc.log`.
La boîte d'activation s'ouvre et la fermer ferme ORC	L'essai a expiré. Voir Licensing.

Compose¶

Il est grisé¶

Survolez-le. L'infobulle est la raison, et elle est toujours actionnable — voir Compose.

Les trois cas courants :

	Solution
Enter a name for the Master Controller first.	Tapez un nom.
…has no keys yet. Stamp a snap with F6 or delete the empty layer.	Une layer vide bloque. Keyez-la ou supprimez-la.
…is keyed but has no targets.	Une layer qui ne bouge rien ne peut pas être livrée.

Il refuse catégoriquement, en rouge¶

Deux conflits ne peuvent pas être composés, et la ligne fautive de l'Outliner s'allume en rouge :

	Solution
Conflit de knob — deux extra knobs sur le même nœud et le même canal	Ils ne peuvent pas s'additionner. Donnez-en un à un canal différent, ou fusionnez-les.
Conflit de drawing — un nœud READ remplacé par deux layers sœurs	Un remplacement de drawing est discret. Déplacez-en une plus profond dans la hiérarchie, ou abandonnez-la.

Il affiche CONFIRM?¶

Un avertissement, pas un bloqueur. Lisez la liste à côté et cliquez à nouveau dans les cinq secondes, ou laissez expirer.

Il a fini « avec des avertissements »¶

Le MC existe et fonctionne. Une étape non fatale a rencontré un problème — lisez le panneau de log, ou orc.log.

F6 ne fait rien¶

Trois possibilités :

Le curseur n'est sur rien de keyable. F6 se déclenche selon ce que la souris survole. Placez-la sur la grid.
C'est un extrême partagé — « This extreme is shared from the Front (read-only) — author it on the Front face. »
C'est un knob. Un knob n'autore aucune frame.

Compose est lent¶

Chaque dimension multiplie les poses. Un control 5 × 3 avec une layer 3 × 3 et un knob à 13 positions fait 1 755 poses adressables, et Compose lit chacune de celles qui sont keyées.

Gardez le même dossier de sortie entre les composes — le cache incrémental y vit et c'est ce qui rend un recompose rapide.
Utilisez le filtre de canaux statiques de l'entonnoir, ou activez Auto-filter static channels at Compose, pour que les canaux qui ne changent jamais ne soient pas écrits.
Vérifiez la profondeur d'historique : chaque entrée est un instantané complet du rig.

Le rig, après compose¶

Son visibility group est probablement No Group. Un widget sans groupe ne répond à rien, All compris. Donnez-lui un groupe.

Une checkbox éteint quelque chose mais ne le rallume plus¶

Corrigé en v1.0.0. Si vous voyez ça sur un rig composé par une build plus ancienne, recomposez.

Un œil louche, ou les pupilles dérivent¶

Invert R est désactivé. Activé par défaut, il compense le peg de l'œil droit miroité pour que les deux iris se suivent ensemble.
Ou les baselines du peg sont périmées : appuyez sur ⟳ dans la barre d'outils Values du look-at pour les relire.

La valeur d'un driver s'emballe¶

C'est la signature classique de l'emballement additif. Vérifiez son Blend : additive est prévu pour un canal qu'un autre auteur écrit déjà, et ne s'applique que là où il y a réellement un recouvrement.

Le rig a des poses mais rien ne bouge¶

Vérifiez les targets de la layer, et la colonne Side. Une ligne affichant un side hérité n'a peut-être jamais été validée — repick le side explicitement. Sur un rig mirroré, un Both hérité fait la moyenne gauche-droite et peut s'annuler jusqu'à la pose de repos.

Réouverture¶

Mon MC composé ne se rouvre pas¶

Si le log dit « not ORC-readable — treating as regular MC. Recompose to enable re-edit », c'est qu'il a été composé avant qu'ORC ne déplace ses données sur le disque. Recomposez-le avec la version actuelle.

Il dit que le MC est déjà importé¶

'robin-MC' is already imported — remove it first to re-import. Importer deux fois dupliquerait ses targets et piloterait le même nœud deux fois.

Mon MC importé a disparu et le rig s'est quand même ouvert¶

C'est voulu. Un MC importé est un accélérateur, pas une dépendance — ORC fusionne ses frames dans la layer et compose nativement :

2 imported MC(s) not found in this scene - composing natively from 528 frame(s)

Vos targets sont intactes.

Le rig composé n'a plus de poses après avoir déplacé la scène¶

Le MC lit ses fichiers d'état depuis le disque. Déplacez le dossier de sortie avec la scène — le chemin est stocké relativement à la scène, donc déplacer la paire ensemble est sûr.

Presets¶

Appliquer un preset a créé un deuxième control¶

C'est Add as new control — le comportement par défaut sûr quand le preset correspondait à un control qui avait déjà des poses autorées. Si vous vouliez écraser, annulez et choisissez Replace.

Une section est grisée dans la boîte de dialogue Pose Presets¶

Le preset ne la contient pas. Resauvegardez le preset avec cette section cochée.

Un grid preset a fait tomber la plupart des positions de mon knob¶

Knob reaches 1 of 18 positions — 17 will not be imported (ORC never resizes a shared knob).

Un knob est une layer séparée que d'autres layers montent. Redimensionnez le knob délibérément, puis réappliquez.

Undo¶

Ctrl+Z n'a pas annulé ce que j'attendais¶

ORC regroupe délibérément : un geste, un glissement de slider, et un remplissage en masse sont chacun une seule entrée. Utilisez le panneau History pour voir les vraies étapes et cliquer pour y sauter.

Ctrl+Z n'a rien fait du tout¶

ORC n'écoute que quand sa fenêtre est active, donc un Ctrl+Z dans le Camera View de Harmony ne l'atteint jamais. Dans un champ de texte, il annule votre saisie à la place.

L'undo n'a pas changé ma scène Harmony¶

Correct — l'undo n'écrit jamais dans votre scène. Compose est la seule chose qui le fait.

Performance¶

Symptôme	Regardez
Lent avec une énorme liste de targets	Normal — les lignes se construisent paresseusement à mesure que vous défilez. Un repeuplement en masse se fige derrière un instantané de l'ancienne liste plutôt que de se vider.
Mémoire qui grimpe sur une longue session	Profondeur d'historique. Chaque entrée est un instantané complet ; les plus anciennes sont abandonnées au-delà d'un plafond dur, quel que soit le réglage.
Une grid est difficile à cliquer	32 par côté est le plafond délibéré. Sur des grids denses, naviguez avec les flèches et les barres de règle.

Toujours bloqué¶

? → Report a bug… ouvre le formulaire de support avec votre version, votre plateforme et l'identifiant machine déjà remplis. Joignez orc.log et, si vous le pouvez, indiquez à quelle adresse de snap c'est arrivé — R1C3, UR0C4:P1LR1C2 — parce que c'est ainsi qu'ORC nomme où.