Hierarquia e Agregador de Irmãos

A árvore que você constrói no Outliner não é só uma lista de importação — é a rede de nodes do Harmony que o OVB escreve no Apply. Pegs, groups e composites viram nodes reais, conectados do jeito que um rigger os conectaria.

Os blocos de construção

	Node	No que se torna
	Drawing	um Read node com suas art layers
	Peg	uma alça de transform que alimenta o(s) drawing(s) abaixo dele. Escala / offset do drawing inteiro andam aqui (o gizmo verde).
	Group	um super-node que envolve seu conteúdo (seu próprio MPI → distribuidor → composite → MPO)
	Composite	mescla as saídas dos seus irmãos

Marque Peg, Group ou Composite no Inspector de um drawing para emiti-los em volta dele; desmarque Drawing para um container puro. O ícone da linha compõe as partes que estão ligadas — peg sobre drawing, group, drawing, composite — então você lê a pilha direto da árvore. Group Order decide se o peg fica fora do group e o comanda (Parent: ) ou dentro dele (Child: ); o vocabulário completo está na legenda de ícones.

Aninhe um drawing sob um peg para que o peg o transforme; envolva um galho em um group para contê-lo; solte um composite para mesclar um conjunto de irmãos.

Agregação de irmãos

Quando vários nodes ficam lado a lado, o OVB os conecta por ordem de pintura, não ao acaso:

• Porta 0 = trás, porta N = frente. O irmão não-bypass mais novo/mais à direita cai atrás; o próprio drawing do agregador é conectado por último = frente.
• Um composite sem peg/group abre um bloco que consome os irmãos normais mais novos depois dele — então [A, C(comp), B, Cc] faz C agregar B e Cc, enquanto A chega ao composite principal sozinho.
• Nodes Bypass (a caixa Bypass composite do drawing) nunca são consumidos — eles sobem direto para o composite pai.

É o mesmo modelo "Shameless family tree" que as outras ferramentas Octo usam — um graph previsível e rigável em vez de uma pilha chapada.

Groups conectam limpo

Um group é construído como: um peg externo (fora) → o group, e dentro: Multi-Port-In → distribuidor → seu conteúdo → Composite interno → Multi-Port-Out. O OVB cuida das partes chatas para que o resultado fique correto:

• A porta de entrada do group é criada antes de o peg externo ser conectado, para que o peg de fato conecte.
• O peg distribuidor descartável é removido depois da conexão (o MPI alimenta o conteúdo diretamente).
• O composite perdido que o Harmony cria automaticamente em um drawing movido é limpo, então você fica com exatamente um composite interno.

Excluir mantém os filhos

Remova um node pai e seus filhos são elevados ao avô — o graph se reorganiza em vez de perder o galho. Veja Outliner.

O composite principal nunca se move

O OVB posiciona tudo o que adiciona acima do composite principal existente da sua cena e conecta as saídas de nível superior sobreviventes nele — seu comp fica exatamente onde está.