Ir para o conteúdo

Unroll

Tutorial em vídeo — em breve

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.

Unroll

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.

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

Tabela de Unroll

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