Ensamblar¶
Assemble es el único verbo destructivo de OSA. Todo lo anterior es un plan; este es el momento en que el plan se vuelve una escena de Harmony.
Qué hace¶
En una sola pasada, recorriendo el árbol de staging:
- Crea los nodos — pegs, groups, composites, backdrops, reads, efectos, generadores.
- Conecta los puertos — la jerarquía verde de transformación y la azul de composición, las dos.
- Escribe los atributos — modos de composite, alineación, alpha, blend modes, valores de efecto, z-depths.
- Importa el arte — a elementos y exposiciones, art layer por art layer, frame por frame.
- Distribuye el grafo — la rejilla del Wide Bus, con los backdrops medidos de dentro hacia fuera.
- Aplana las pilas — reescribe el árbol de staging con la forma que la escena puede almacenar de verdad (mira Original Bitmap).
Antes de pulsarlo¶
El botón Assemble vive abajo a la derecha, junto a Cancel, y está condicionado: cuando la barra de feedback muestra un error bloqueante, el botón queda deshabilitado. OSA no te deja ensamblar un árbol que sabe que está mal.
La barra de feedback encima lleva los motivos del bloqueo en color, así que la respuesta a "¿por qué está gris el botón?" siempre está en pantalla.
El informe¶
Assemble informa de lo que la escena rechazó, no de lo que hizo. Un informe que grita en cada construcción es ruido de fondo, así que la distinción es deliberada:
| Marca | Significado |
|---|---|
| FALHA (fallo) | se pidió algo y no ocurrió |
| nota (nota) | ocurrió, solo que no como se pidió |
Cada línea nombra el tipo, el sujeto y dónde ocurrió:
FALHA import-failed sky: source file not found [Top/BG/sky]
nota degraded can: vector track skipped in Original Bitmap
El vocabulario completo es cerrado — todo fallo tiene uno de estos tipos:
| Tipo | Significa |
|---|---|
no-bridge |
Harmony está ahí y el puente de scripts nunca se abrió |
import-failed |
el arte nunca llegó al disco |
no-artwork |
no había nada que llevar (una nota) |
element-swap |
un drawing en Original Bitmap se quedó como TVG |
unresolved |
no hay columna ni elemento para el nodo |
drawing-failed |
Drawing.create fue rechazado |
exposure-failed |
column.setEntry fue rechazado |
utransform |
una conversión fue rechazada o no produjo nada |
node-failed |
la creación del nodo fue rechazada |
plan-error |
una excepción al confirmar un plan |
phase-error |
una excepción en toda una fase |
format-mismatch |
la extensión miente sobre el contenido del archivo |
degraded |
hecho, pero no como se pidió (una nota) |
cancelled |
interrumpiste la construcción |
unaddressable |
un nodo afirma existir pero no puede decir dónde |
Cancelar¶
Cancel detiene la construcción. No deshace lo ya escrito.
Assemble no es una transacción
El undo de Harmony acumula toda la construcción en una sola escritura, así que cancelar a medias deja los nodos ya creados. Eso es una propiedad del anfitrión, no una elección — y por eso el paso de aplanado solo toca los drawings cuyas fuentes realmente aterrizaron: tras un cancel, tu árbol de staging sigue describiendo todo lo que no llegó.
Si una construcción sale mal, la recuperación honesta es el undo del propio Harmony, y luego arreglar el árbol y ensamblar otra vez.
Reensamblar¶
Puedes ensamblar el mismo árbol otra vez. Los nodos que ya existen en la escena se editan donde están — renombrados, re-atribuidos, nunca duplicados y nunca movidos — y después el slot vuelve a marcarse como existente, así que la siguiente pulsación es otra actualización.
Un nodo que dice existir pero no puede decir dónde se informa como unaddressable en vez de reconstruirse, porque reconstruirlo significaría tener dos.
Hay una página entera sobre esto, incluido por qué la raíz del árbol no es Top para una cadena importada: Reeditar una escena ensamblada.
Generate + Assemble¶
El botón Generate Magnet Tree + Assemble de la barra de Staging hace los dos pasos en una pulsación: crea un super node por cada magnet activo y los ensambla directamente en el Node View.
Es autónomo — sin arte, sin staging, sin nada arrastrado. En una escena vacía construye la jerarquía de destino él solo, que es la manera de entregar una escena vacía ya montada a quien empieza el plano.
Lo que construye sale de la receta del Magnet Generator del Preference Set activo: qué magnets existen, cuáles están activos, su orden, los componentes con los que nace cada uno y su color de backdrop. Cambiar de preference set cambia el resultado entero, así que mira primero el combo de la barra superior. Mira Magnets.
Después de la construcción¶
El árbol de staging se reescribe para coincidir con la escena: las pilas se aplanan, las pistas que aterrizaron se colapsan en su capa, y cada fila aplanada conserva su procedencia — de dónde vino el arte, su tipo, su miniatura.
El slot sigue aceptando nuevas pistas después. El aplanado no es el final, es la base: la siguiente composición compone encima de lo que ahora está en la escena.