Unroll¶
Unroll es el inverso de Compose. Compose hornea tus poses autoradas dentro de un Master Controller; Unroll toma las poses guardadas dentro de un MC y las recrea en la timeline de Harmony como keyframes.
Úsalo para:
- recuperar poses que perdiste de la timeline — ver abajo,
- traer de vuelta a frames las poses de un rig heredado para poder editarlas,
- entregarle a un animador una versión keyframeada de un rig,
- fusionar un MC front y un MC back en una sola timeline — algo que el propio unroll de Harmony no puede hacer.
El MC compuesto es un respaldo de tus poses
El primer uso es el que salva un día de producción. Las poses que lleva un MC compuesto son copias completas dentro de sus archivos de estado — no dependen de los frames de la timeline de donde vinieron. Así que si esos frames se borran, se sobrescriben, o se pierden en un mal guardado, el MC igual conserva cada pose, y Unroll las pone de vuelta en la timeline como keyframes. Compose las hornea adentro; Unroll las saca.
Qué puede desenrollar¶
| MC | Se muestra como | Las poses vienen de |
|---|---|---|
| Un MC compuesto por ORC | ORC composed MC |
Los propios datos de pose y el manifiesto de ORC |
| Un MC slider de Toon Boom | Harmony slider MC |
Los estados dentro de sus archivos .tbState |
| Un MC grid de Toon Boom | Harmony grid MC |
Los estados dentro de sus archivos .tbState |
| Un MC stack / cube de Toon Boom | Harmony stack MC |
Los estados dentro de sus archivos .tbState |
Los MC de Toon Boom puros funcionan. ORC los reconoce por su propio script de UI y lee sus poses a través del state manager de Toon Boom.
Dónde iniciarlo¶
| Desde | Alcance |
|---|---|
El botón ⤓ Unroll de un control |
Ese control — ambas caras |
Clic derecho en un control → ⤓ Unroll Poses… |
Ese control — ambas caras |
El botón ⤓ Unroll de una pose layer |
Abre el diálogo con solo esa layer marcada |
El botón de la layer solo aparece en una layer libre cuyo MC fue importado — una layer que autoraste desde cero no tiene MC que desenrollar.
Cuando no hay ningún MC cargado, el botón aparece en gris, y el tooltip dice por qué:
Locked until a Master Controller is loaded for this rig — set the MC in the source bar above.
Front + Back en una sola pasada
Con ambos slots configurados, ORC los desenrolla fusionados, en una sola timeline. El plan se titula robin-front-MC + robin-back-MC y cada advertencia indica de qué MC viene.
El diálogo¶
Unroll scope¶
Un árbol marcable de lo que se va a hornear, dibujado con los mismos glifos que el Outliner.
| Fila | Por defecto |
|---|---|
| Un control | Marcado. Desmarcarlo pone en gris a sus hijos. |
Front / Back |
Marcado. Cada side tiene su propio alcance, así que puedes hornear solo el front. |
| Una pose layer libre | Marcado. |
| Un knob | Marcado solo si tiene targets propios. |
Globals |
Marcado, cuando existen layers globales. |
Un knob sin targets está deshabilitado, y dice por qué:
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.
Debajo del árbol, un conteo en vivo: Baking 2055 of 2055 pose(s). En cero, el botón Unroll se deshabilita.
Un solo mecanismo cubre cada caso — hornear todo el MC, un control, una layer, una layer global, o un side.
Frame offset¶
Frame offset se suma a cada frame de origen. 0 restaura las poses en sus frames originales; un valor positivo desplaza todo más adelante, uno negativo más atrás.
La tabla de poses¶
Marca Show poses table para ver una fila por pose:
| Columna | Editable |
|---|---|
Src Frame |
No — dónde se autoró la pose |
Dst Frame |
Sí — dónde se va a escribir |
Snap Key |
No — la dirección de la pose |
Tabs |
No — qué stacks contribuyen |
Un MC nativo muestra Src Frame, Dst Frame y Pose Name en su lugar.
El texto de las filas se tiñe para avisarte:
| Color | Significado |
|---|---|
| Ámbar | Más de una pose cae en este frame de destino |
| Rojo | El frame de destino está por debajo de 1 |
Reset Dst devuelve cada fila a Src + offset.
La tabla viene activada por defecto, excepto en planes de 500 poses o más, donde se abre desactivada por velocidad. Ambas vistas están siempre listas, así que alternar es instantáneo.
Advertencias¶
| Mensaje | Significado |
|---|---|
| 466 frame(s) with multiple poses: 51, 52, 53… (+458) | Snaps posteriores se van a apilar sobre anteriores en esos frames. |
| N frame(s) ≤ 0 — fix before applying | Bloquea Unroll hasta que se corrija. |
Ejecutarlo¶
Una ventana de progreso reporta cada bloque:
Frame 1200 / 2055 — controls=600 · layer writes=205488 · failed=0
| Contador | Significa |
|---|---|
controls= |
Estados de fachada aplicados — uno por pose de control |
layer writes= |
Escrituras individuales de atributo desde datos de pose layer. Por eso el número es grande. |
failed= |
Escrituras que no encontraron ningún nodo o columna |
Cancel está armado — haz clic una vez para armarlo durante cuatro segundos, otra vez para abortar. La fricción es deliberada: abortar a mitad de un unroll deja tu timeline parcialmente escrita. Se detiene en un límite de bloque (cincuenta frames), nunca a mitad de una escritura.
Todo corre dentro de un solo paso de deshacer de Harmony, así que un solo Ctrl+Z lo revierte todo.
| Resultado | Mensaje |
|---|---|
| Limpio | Unroll done — 2055 pose(s), controls=600 · layer writes=205488 · failed=0 |
| Con fallos | Unroll: 2000 OK, 55 failed write(s), 2 failed frame(s) — see log |
| Cancelado | Unroll cancelled — 812 pose(s) applied |
Qué escribe¶
Unroll no escribe ningún archivo. Toda su salida son keyframes, valores de atributo y exposiciones de drawing en tu escena.
Para cada frame restaura la propia pose del control desde su archivo de estado — pegs de cabeza, deformadores de mandíbula, drawings de lip-sync, exactamente como fueron autorados — y luego escribe los offsets de deformación, longitudes de handle, transformaciones de peg y exposiciones de drawing de las pose layers directamente sobre sus nodos.
Un MC nativo no tiene esos datos, así que simplemente aplica el estado nombrado en cada frame de destino.
Unroll y Compose juntos¶
Son dos direcciones de un mismo ciclo:
poses autoradas ──Compose──▶ un Master Controller ──Unroll──▶ keyframes de timeline
Ese viaje de ida y vuelta es lo que te permite tomar un MC que construyó otra persona — incluso uno de Toon Boom puro — desenrollarlo a frames, importarlo a ORC, reautorar lo que necesites, y volver a componerlo.
Relacionado¶
- Compose
- Re-editing a Composed MC
- Controls
- Widget Editor — restilizar un MC nativo sin convertirlo

