Unroll¶
Unroll é o inverso de Compose. Compose assa suas poses autoradas em um Master Controller; Unroll pega as poses guardadas dentro de um MC e as recria na timeline do Harmony como keyframes.
Use para:
- recuperar poses que você perdeu da timeline — veja abaixo,
- trazer de volta as poses de um rig herdado para frames, para você poder editá-las,
- entregar a um animador uma versão com keyframes de um rig,
- mesclar um MC front e um back em uma única timeline — algo que o próprio unroll do Harmony não consegue fazer.
O MC composto é um backup das suas poses
O primeiro uso é o que salva um dia de produção. As poses que um MC composto carrega são cópias completas dentro dos arquivos de estado dele — elas não dependem dos frames da timeline de onde vieram. Então, se esses frames forem apagados, sobrescritos, ou perdidos por um save ruim, o MC ainda guarda cada pose, e o Unroll as coloca de volta na timeline como keyframes. Compose as assa; Unroll as tira de lá.
O que ele pode desenrolar¶
| MC | Aparece como | As poses vêm de |
|---|---|---|
| Um MC composto pelo ORC | ORC composed MC |
Os dados de pose e o manifest do próprio ORC |
| Um MC de slider do Toon Boom | Harmony slider MC |
Os estados dentro dos arquivos .tbState dele |
| Um MC de grid do Toon Boom | Harmony grid MC |
Os estados dentro dos arquivos .tbState dele |
| Um MC de stack / cube do Toon Boom | Harmony stack MC |
Os estados dentro dos arquivos .tbState dele |
MCs puros do Toon Boom funcionam. O ORC os reconhece pelo próprio script de UI e lê suas poses através do gerenciador de estados do Toon Boom.
Onde iniciar¶
| A partir de | Escopo |
|---|---|
O botão ⤓ Unroll de um control |
Aquele control — as duas faces |
Clique direito em um control → ⤓ Unroll Poses… |
Aquele control — as duas faces |
O botão ⤓ Unroll de uma pose layer |
Abre o diálogo com só aquela layer marcada |
O botão da layer só aparece em uma layer livre cujo MC foi importado — uma layer que você autorou do zero não tem MC para desenrolar.
Quando nenhum MC está carregado, o botão fica acinzentado, e o tooltip diz o motivo:
Locked until a Master Controller is loaded for this rig — set the MC in the source bar above.
Front + Back em uma só passada
Com os dois slots definidos, o ORC os desenrola mesclados, em uma única timeline. O plano é intitulado robin-front-MC + robin-back-MC e cada aviso nomeia de qual MC ele veio.
O diálogo¶
Unroll scope¶
Uma árvore marcável do que assar, desenhada com os mesmos glifos do Outliner.
| Linha | Padrão |
|---|---|
| Um control | Marcado. Desmarcar acinzenta seus filhos. |
Front / Back |
Marcado. Cada side tem escopo independente, então você pode assar só o front. |
| Uma pose layer livre | Marcado. |
| Um knob | Marcado só se ele tiver targets próprios. |
Globals |
Marcado, quando existem layers globais. |
Um knob sem targets fica desativado, e diz o motivo:
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.
Abaixo da árvore, uma contagem ao vivo: Baking 2055 of 2055 pose(s). Em zero, o botão Unroll desativa.
Um único mecanismo cobre todos os casos — assar o MC inteiro, um control, uma layer, uma layer global, ou um side.
Frame offset¶
Frame offset é somado a cada frame de origem. 0 restaura as poses em seus frames originais; positivo desloca tudo para mais tarde, negativo para mais cedo.
A tabela de poses¶
Marque Show poses table para uma linha por pose:
| Coluna | Editável |
|---|---|
Src Frame |
Não — onde a pose foi autorada |
Dst Frame |
Sim — onde ela será escrita |
Snap Key |
Não — o endereço da pose |
Tabs |
Não — quais stacks contribuem |
Um MC nativo mostra Src Frame, Dst Frame e Pose Name em vez disso.
O texto da linha é tingido para avisar você:
| Cor | Significado |
|---|---|
| Âmbar | Mais de uma pose cai neste frame de destino |
| Vermelho | O frame de destino está abaixo de 1 |
Reset Dst devolve cada linha para Src + offset.
A tabela vem ligada por padrão, exceto em planos de 500 poses ou mais, onde ela abre desligada para agilizar. As duas visões estão sempre prontas, então alternar é instantâneo.
Avisos¶
| Mensagem | Significado |
|---|---|
| 466 frame(s) with multiple poses: 51, 52, 53… (+458) | Snaps mais tarde vão se empilhar sobre os anteriores nesses frames. |
| N frame(s) ≤ 0 — fix before applying | Bloqueia o Unroll até ser corrigido. |
Executando¶
Um popup de progresso reporta cada bloco:
Frame 1200 / 2055 — controls=600 · layer writes=205488 · failed=0
| Contador | Significa |
|---|---|
controls= |
Estados de fachada aplicados — um por pose de control |
layer writes= |
Escritas individuais de atributo a partir dos dados de pose layer. É por isso que o número é grande. |
failed= |
Escritas que não encontraram nó ou coluna |
Cancel vem armado — clique uma vez para armar por quatro segundos, de novo para abortar. O atrito é deliberado: abortar no meio do unroll deixa sua timeline parcialmente escrita. Ele para em um limite de bloco (cinquenta frames), nunca no meio de uma escrita.
Tudo roda dentro de um único passo de undo do Harmony, então um único Ctrl+Z desfaz tudo.
| Resultado | Mensagem |
|---|---|
| Limpo | Unroll done — 2055 pose(s), controls=600 · layer writes=205488 · failed=0 |
| Com falhas | Unroll: 2000 OK, 55 failed write(s), 2 failed frame(s) — see log |
| Cancelado | Unroll cancelled — 812 pose(s) applied |
O que ele escreve¶
Unroll não escreve arquivos. Sua saída inteira é keyframes, valores de atributo e exposições de drawing na sua cena.
Para cada frame, ele restaura a pose própria do control a partir do arquivo de estado — pegs da cabeça, deformadores de mandíbula, drawings de lip-sync, exatamente como autorados — e então escreve os offsets de deform, comprimentos de handle, transformações de peg e exposições de drawing das pose layers diretamente nos nós delas.
Um MC nativo não tem esses dados, então ele simplesmente aplica o estado nomeado em cada frame de destino.
Unroll e Compose juntos¶
São duas direções de um mesmo laço:
poses autoradas ──Compose──▶ um Master Controller ──Unroll──▶ keyframes na timeline
Essa ida e volta é o que permite pegar um MC que outra pessoa construiu — até um puro do Toon Boom — desenrolá-lo em frames, importá-lo no ORC, reautorar o que for preciso, e compô-lo de volta.
Veja Reeditando um MC Composto.
Relacionado¶
- Compose
- Reeditando um MC Composto
- Controls
- Widget Editor — restilizando um MC nativo sem convertê-lo

