Aller au contenu

Unroll

▶Tutoriel vidéo — à venir

Unroll est l'inverse de Compose. Compose cuit vos poses autorées dans un Master Controller ; Unroll prend les poses stockées à l'intérieur d'une MC et les recrée sur la timeline de Harmony sous forme de keyframes.

Unroll

Utilisez-le pour :

  • récupérer des poses perdues de la timeline — voir ci-dessous,
  • remettre sur des frames les poses d'un rig hérité pour pouvoir les éditer,
  • remettre à un animateur une version keyframée d'un rig,
  • fusionner une MC front et une MC back en une seule timeline — quelque chose que le propre unroll de Harmony ne sait pas faire.

La MC composée est une sauvegarde de vos poses

Le premier usage est celui qui sauve une journée de production. Les poses portées par une MC composée sont des copies complètes à l'intérieur de ses fichiers d'état — elles ne dépendent pas des frames de la timeline d'où elles viennent. Donc si ces frames sont supprimées, écrasées, ou perdues dans une mauvaise sauvegarde, la MC garde quand même toutes les poses, et Unroll les remet sur la timeline sous forme de keyframes. Compose les cuit dedans ; Unroll les fait ressortir.

Ce qu'il peut dérouler

MC Affichée comme Les poses viennent de
Une MC composée par ORC ORC composed MC Les propres données de pose et le manifeste d'ORC
Une MC slider Toon Boom Harmony slider MC Les états à l'intérieur de ses fichiers .tbState
Une MC grid Toon Boom Harmony grid MC Les états à l'intérieur de ses fichiers .tbState
Une MC stack / cube Toon Boom Harmony stack MC Les états à l'intérieur de ses fichiers .tbState

Les MC Toon Boom brutes fonctionnent. ORC les reconnaît à leur propre script UI et lit leurs poses via le state manager de Toon Boom.

Où le démarrer

Depuis Portée
Le bouton ⤓ Unroll d'un control Ce control — les deux faces
Clic droit sur un control → ⤓ Unroll Poses… Ce control — les deux faces
Le bouton ⤓ Unroll d'une pose layer Ouvre le dialogue avec seulement cette layer cochée

Le bouton de la layer n'apparaît que sur une layer libre dont la MC a été importée — une layer que vous avez autorée depuis zéro n'a pas de MC à dérouler.

Quand aucune MC n'est chargée, le bouton est grisé, et le tooltip dit pourquoi :

Locked until a Master Controller is loaded for this rig — set the MC in the source bar above.

Front + Back en une seule passe

Avec les deux slots réglés, ORC les déroule fusionnées, en une seule timeline. Le plan s'intitule robin-front-MC + robin-back-MC et chaque avertissement nomme de quelle MC il vient.

Le dialogue

Unroll scope

Un arbre à cocher de ce qu'il faut cuire, dessiné avec les mêmes glyphes que l'Outliner.

Ligne Défaut
Un control Coché. Décocher grise ses enfants.
Front / Back Coché. Chaque side a sa propre portée, pour pouvoir cuire seulement le front.
Une pose layer libre Coché.
Un knob Coché seulement s'il a ses propres targets.
Globals Coché, quand des layers globales existent.

Un knob sans targets est désactivé, et dit pourquoi :

Knob — a dimension, not a pose layer. It has no targets of its own, so there is nothing to unroll here. Checking a layer that rides this knob already unrolls every pose along the knob's dimension.

Sous l'arbre, un compte en direct : Baking 2055 of 2055 pose(s). À zéro, le bouton Unroll se désactive.

Un seul mécanisme couvre chaque cas — cuire la MC entière, un control, une layer, une layer globale, ou un side.

Frame offset

Frame offset s'ajoute à chaque frame source. 0 restaure les poses à leurs frames d'origine ; positif décale tout plus tard, négatif plus tôt.

La table des poses

Table Unroll

Cochez Show poses table pour une ligne par pose :

Colonne Éditable
Src Frame Non — où la pose a été autorée
Dst Frame Oui — où elle sera écrite
Snap Key Non — l'adresse de la pose
Tabs Non — quelles stacks contribuent

Une MC native affiche Src Frame, Dst Frame et Pose Name à la place.

Le texte des lignes est teinté pour vous avertir :

Couleur Signification
Ambre Plus d'une pose atterrit sur cette frame de destination
Rouge La frame de destination est inférieure à 1

Reset Dst remet chaque ligne à Src + offset.

La table est activée par défaut, sauf pour les plans de 500 poses ou plus, où elle s'ouvre désactivée pour la vitesse. Les deux vues sont toujours prêtes, donc basculer est instantané.

Avertissements

Message Signification
466 frame(s) with multiple poses: 51, 52, 53… (+458) Des snaps ultérieurs vont s'empiler sur des antérieurs à ces frames.
N frame(s) ≤ 0 — fix before applying Bloque Unroll jusqu'à correction.

L'exécuter

Un popup de progression rapporte chaque bloc :

Frame 1200 / 2055 — controls=600 · layer writes=205488 · failed=0
Compteur Signifie
controls= États de façade appliqués — un par pose de control
layer writes= Écritures d'attribut individuelles issues des données de pose layer. C'est pourquoi le nombre est élevé.
failed= Écritures qui n'ont trouvé aucun nœud ni colonne

Cancel est armé — cliquez une fois pour armer pendant quatre secondes, encore une fois pour interrompre. La friction est délibérée : interrompre en plein unroll laisse votre timeline partiellement écrite. Cela s'arrête à une limite de bloc (cinquante frames), jamais en pleine écriture.

Tout se déroule dans une seule étape d'annulation Harmony, donc un seul Ctrl+Z annule tout.

Résultat Message
Propre Unroll done — 2055 pose(s), controls=600 · layer writes=205488 · failed=0
Avec échecs Unroll: 2000 OK, 55 failed write(s), 2 failed frame(s) — see log
Annulé Unroll cancelled — 812 pose(s) applied

Ce qu'il écrit

Unroll n'écrit aucun fichier. Toute sa sortie, ce sont des keyframes, des valeurs d'attribut et des expositions de drawing dans votre scène.

Pour chaque frame, il restaure la propre pose du control depuis son fichier d'état — pegs de tête, déformeurs de mâchoire, drawings de lip-sync, exactement comme autorés — puis il écrit les offsets de déformation, longueurs de handle, transformations de peg et expositions de drawing des pose layers directement sur leurs nœuds.

Une MC native n'a pas de telles données, donc elle applique simplement l'état nommé à chaque frame de destination.

Unroll et Compose ensemble

Ce sont deux directions d'une même boucle :

poses autorées  ──Compose──▶  un Master Controller  ──Unroll──▶  keyframes de timeline

Cet aller-retour est ce qui vous permet de prendre une MC construite par quelqu'un d'autre — même une MC Toon Boom brute — de la dérouler en frames, de l'importer dans ORC, de réautorer ce dont vous avez besoin, et de la recomposer.

Voir Re-editing a Composed MC.

Voir aussi