Nós de estrutura e o Wide Bus¶

▶Vídeo tutorial — em breve

Um slot pode construir quatro nós de hierarquia ao redor do seu drawing. Esta página é sobre o que cada um faz, como são ordenados, e — a parte que decide se o seu Node View é legível — onde o OSA os coloca.

Os quatro componentes¶

Peg — P

O transform. Nomeado <name>-P. Carrega Position (Separate / 3D Path), Scale (Separate / Locked), Enable 3D e Exclude AutoPivot.
Group — G

O escopo. Nomeado <name>-G. Um group é o que faz de um slot uma unidade autocontida — tudo que está dentro dele está dentro dele.
Composite — C

O ponto de agregação. Nomeado <name>-C. Carrega o composite mode e a Order dele.
Backdrop — BD

O retângulo do Node View em volta do galho, com cor e nota. Puramente organizacional — e a coisa que o motor de layout dimensiona de dentro para fora.

Peg Order: pai ou filho¶

Peg e Group podem trocar de lugar, e o combo Order no bloco Peg decide qual:

Order	Resultado	Lê-se como
`Outside Group`	Peg → Group → conteúdo	o peg move o grupo inteiro
`Inside Group`	Group → Peg → conteúdo	o peg move o conteúdo, dentro do escopo do grupo

A coluna Details sempre reflete a escolha que você fez: (Peg > Group > Read) ou (Group > Peg > Read).

Composite Order e modo¶

O bloco Composite carrega a mesma escolha de Order (Inside Group / Outside Group) e, mais importante, o composite mode:

Modo	O que faz
`As Bitmap`	achata as entradas dele num bitmap
`As Seamless Bitmap`	o mesmo, sem os artefatos de emenda em artes adjacentes
`As Vector`	mantém os dados vetoriais através do composite
`Pass Through`	não compõe — passa as entradas para cima

Estes escrevem keywords, não índices

O mapeamento entre estes rótulos e os valores guardados pelo Harmony foi medido numa instalação do Harmony 24, não chutado — três das quatro entradas no mapa que toda ferramenta carregava estavam erradas (As Vector escrevia o valor do Seamless; Pass Through escrevia o valor do Vector). Se um composite algum dia se comportar como um modo diferente do rótulo dele, essa é a classe de bug a suspeitar, e o OSA está do lado medido dela.

Duas hierarquias, em paralelo¶

O Node View carrega dois grafos ao mesmo tempo, e o OSA os dispõe como dois:

Hierarquia	Cor	Conecta	Regra
Input / Transform	🟢 verde	Peg → filhos	indentação significa filho
Output / Composite	🔵 azul	Comp → irmãos abaixo	um comp agrega os irmãos abaixo dele

São separados porque um peg pode dirigir várias composições distintas. Transformação e composição não são a mesma árvore, e desenhá-las como uma só é o que torna grafos feitos à mão ilegíveis.

O que um composite agrega¶

Se um comp coleta filhos ou irmãos depende de uma coisa só: se o slot tem um green container para criar escopo.

O slot tem	O comp agrega
`C` sozinho	irmãos abaixo
`D-C`	irmãos abaixo
`BD-C`, `BD-D-C`	irmãos abaixo — um backdrop é visual
`P-C`, `G-C`, `P-D-C`, `BD-P-C`	filhos

Só P e G são green containers. Um backdrop desenha uma caixa; ele não possui conexão nenhuma, então nunca muda quem agrega o quê.

Quando um comp encontra outro comp no mesmo nível, o bloco atual é descarregado — essa é a fronteira do bloco.

Regras completas, com o fluxo e a ordem das portas: Agregação e o sibling aggregator.

O Wide Bus¶

O OSA não larga nós onde o Harmony bem entender. Ele trata o Node View como uma matriz lógica e pré-aloca espaço, para o grafo fluir da esquerda para a direita em vez de se amontoar.

Fileira	Ocupante
Fileira de cima	master pegs / master groups / master drawings — o que o super node tiver
Fileira do meio	o chão de fábrica: drawings, groups e mini-nós, lado a lado
Embaixo	composites, deslocados abaixo do que quer que agreguem
Faixa de FX	cinco vagas reservadas (`OP`, `CUT`, `BLD`, `GLW`, `BLR`) sob composites que são filhos diretos do backdrop ou do próprio super node

Como a faixa de FX é reservada em vez de alocada sob demanda, adicionar um efeito depois não empurra o resto do grafo para o lado.

O backdrop expansível¶

Um backdrop nasce com uma largura mínima de três colunas de nó, e mantém de propósito espaço vazio tático entre o último nó de conteúdo e o composite final. Essa folga não é desleixo — é onde você arrasta um nó novo depois sem quebrar o layout.

Matryoshka: backdrops aninhados¶

Backdrops podem conter backdrops, e o dimensionamento é calculado de baixo para cima, de dentro para fora.

Constante	Valor	É
`COL_WIDTH`	200 px	uma coluna
`ROW_HEIGHT`	80 px	uma fileira
`PAD_SIDE`	50 px	padding lateral do backdrop, de cada lado
`PAD_TOP`	100 px	espaço para o cabeçalho do backdrop
`PAD_BOTTOM`	150 px	espaço para o comp e a área de FX
`GAP`	20 px	espaço entre irmãos

Largura

uma folha (drawing ou peg sem backdrop) é 1 coluna;
um backdrop aninhado é sum(children) + gaps + 2 × PAD_SIDE, arredondado para cima em colunas inteiras;
um backdrop pai usa a mesma fórmula sobre as larguras calculadas dos filhos.

Altura

uma folha são 2 fileiras (fileira do peg + fileira do drawing);
um backdrop é PAD_TOP + max(children heights) + PAD_BOTTOM.

A regra fundamental: um backdrop aninhado nunca herda a largura do pai. Cada um mede o próprio conteúdo, e o pai se adapta aos filhos. É isso que faz uma cena profundamente aninhada sair com tudo visível em vez de cortado ou sobreposto.

Root-BD  (computed last)
├── Nested-BD-A  (4 cols)
│   ├── D1  (1 col)
│   └── D2  (1 col)          → inner 2 cols + gap → 4 with padding
├── Nested-BD-B  (6 cols)
│   ├── Sub-BD  (3 cols)
│   │   └── D3  (1 col)
│   └── D4  (1 col)          → inner 5 cols + gap → 6 with padding
└── Sibling-Peg (2 cols)

Root inner = 4 + 6 + 2 + gaps = 14 cols
Root total = max(14, MIN_WIDTH) + padding

Cor e nota do backdrop¶

O bloco Backdrop carrega um nome, uma amostra de cor e uma nota. A cor é a única coisa no Node View que sobrevive a uma reabertura e a uma entrega — use-a para a leitura que você quer que um estranho tenha em três segundos.