Patches

Um cabo pega algo que a música está fazendo (o grave, a batida, uma subida, um relógio lento, até outra camada) e usa isso para mexer num controle. Patches é onde você faz essas ligações. Pro

Criar um cabo

A janela tem as fontes à esquerda, uma faixa no meio e todos os controles de todas as camadas à direita (mais as cores da cena). Cada fonte e cada controle tem um pequeno círculo, a sua porta.

Arraste do círculo de uma fonte até o círculo de um controle. Um cabo aparece entre eles, na cor da fonte.
Toque no cabo (ou no nome de uma linha) para abrir os ajustes dele: quanto ele move o controle, com que suavidade e com que forma.
Arraste a ponta de um cabo até outro círculo para mudá-lo de lugar.
Para remover um cabo, abra-o e toque na lixeira, depois toque de novo para confirmar. No Mac, selecione-o e pressione Backspace.

Um controle pode receber vários cabos; os efeitos deles se somam. Mantenha pressionado (ou passe o ponteiro sobre) qualquer nome para ver um texto curto de ajuda. Só os controles marcados com "Cable: yes" (cabo: sim) na página Elementos podem ser destinos.

Dica. Os Elementos já reagem à música sozinhos, então raramente é preciso um cabo em cada controle. Um ou dois cabos bem pensados por camada valem mais que dez.

O que um cabo faz

Toque num cabo para ver o pequeno gráfico dele (a fonte em tom apagado, o resultado em tom forte, os últimos 3 segundos) e estes ajustes:

Ajuste	O que faz
Amount	Quanto o cabo move o controle, como fração da faixa inteira do controle, de -1 a 1. Negativo move para baixo. O próprio controle deslizante do controle é o ponto de partida; o cabo soma a ele. (Não aparece para as fontes Numbers e Time, que definem o controle diretamente.)
Smooth	Com que lentidão o controle acompanha, em segundos (0 a 3). 0 acompanha cada salto. Cerca de 0,05 a 0,15 serve para batidas secas, 0,2 a 0,6 para grave e pulsos, 1 a 3 para derivas lentas.
Curve	Muda a forma do sinal de 0 a 1 antes de ele chegar ao controle. Veja abaixo.
In from, In to	A parte da fonte que conta. Valores iguais ou abaixo de In from viram 0; valores iguais ou acima de In to viram 1. Aumente In from para ignorar trechos baixos.
Threshold	Aparece nas curvas Threshold e Gate: o nível (0 a 1) que o sinal precisa passar.

Curvas

Curve	Forma
Linear	O sinal como ele é.
Invert	Invertido (1 menos o sinal): o forte vira fraco.
Ease	Um S suave; mais delicado nas pontas.
Exp	As partes fracas ficam mais fracas: espera e depois salta.
Log	As partes fracas ficam mais fortes: salta e depois se acomoda.
Threshold	Um degrau suave: desligado abaixo do nível, ligado acima.
Gate	0 abaixo do nível; acima, o próprio sinal.

Um controle de cor funciona um pouco diferente. Uma fonte numérica o move ao longo de uma lista de cores: a paleta da própria camada, senão as cores da cena, senão a roda de cores. Amount 1 com o sinal no máximo percorre a lista uma volta inteira; 0,25 anda um quarto do caminho. Uma fonte de cor (veja Cores) puxa o controle em direção àquela cor conforme o Amount. Um interruptor fica ligado enquanto o sinal do cabo está acima da metade.

Todas as fontes

As fontes vêm em grupos, nesta ordem na janela. Todo valor vai de 0 a 1, salvo indicação.

Grupo	O que tem nele
Music	Grave, médio, agudo, nível, energia, ataque, batida, fase da batida, fase do compasso, transição, rarefação.
Bands	Fatias do espectro, do grave mais profundo ao agudo mais alto.
Song structure	Seção, subida, drop, tempo forte, progresso, harmonia, tensão, fundamental do acorde, melodia.
Random	Valores aleatórios suaves ou em degraus.
Colors	A cor da paleta em movimento, uma cor da cena, a cor embaixo de uma camada.
Layer outputs	Sinais que outras camadas publicam, como uma explosão.
Layers below	O quanto as camadas de baixo parecem claras, coloridas ou agitadas.
Numbers	Passos na batida ou no compasso, nas unidades do próprio controle. Você os digita.
Time	Gates, rampas, dentes de serra, triângulos e senoides ao longo dos segundos da música. Você os digita.

Música, ao vivo

Estas funcionam com tudo: músicas, rádio, o microfone e This Mac.

Fonte	Valor
`bass`	O volume da parte grave (bumbo, baixo). Rápido.
`mid`	O volume da parte média (vozes, guitarras, teclados).
`treble`	O volume da parte aguda (pratos, chimbal, brilho).
`level`	O volume geral agora, suavizado ao longo de cerca de um décimo de segundo.
`energy`	Volume lento, ao longo de cerca de 3 segundos: alto em refrões e drops, baixo em partes calmas. A melhor fonte para mudanças grandes e suaves.
`onset`	Picos em ataques repentinos (bateria, cordas beliscadas, ataques). Para flashes e impactos.
`beat`	1 no momento em que cai uma batida, senão 0. Dê ao cabo um pouco de Smooth (0,1 a 0,3) para virar um pulso em vez de um clique.
`beatPhase`	Sobe de 0 a 1 ao longo de cada batida e recomeça. Pulsação constante.
`barPhase`	Sobe de 0 a 1 ao longo de cada compasso de quatro batidas. Giros lentos e sincronizados.
`transition`	Sobe de 0 a 1 enquanto uma música faz crossfade para a próxima.
`thin`	0 com a mixagem cheia, até 1 quando a música fica rala: a bateria ou o baixo saem, uma pausa, ou só uma voz e um pad. Lento e suave. Use para abrir uma cena quando a música fica esparsa. Depois da análise, ele lê a música inteira (consegue ver uma parte calma chegando); até lá, e no rádio antes de a análise alcançar, ele trabalha com o último meio minuto de som e só reage depois que a música fica rala. Ele vê a parte grave, o volume e quantas bandas estão acesas, então não percebe quando só um bumbo sai enquanto um baixo sustentado continua.

Bandas

O espectro é dividido em 64 bandas: a banda 0 é o grave mais profundo (cerca de 30 Hz) e a banda 63 o agudo mais alto (cerca de 16 kHz). Uma fonte de bandas tira a média de uma sequência delas, cada uma ajustada à sua própria faixa recente para que as bandas fracas também se mexam. A janela oferece 12 prontas; para usar outra sequência, peça num arquivo de cena (bands:A-B).

Fonte	Cobre
`bands:0-7`	Grave profundo
`bands:0-3`, `bands:0-15`	As quatro bandas mais graves, e o quarto mais grave do espectro
`bands:16-39`	Os médios
`bands:40-63`	Os agudos
`bands:8-15`, `16-23`, `24-31`, `32-39`, `40-47`, `48-55`, `56-63`	Oito fatias iguais, do grave ao agudo

Estrutura da música

Estas precisam que o Nebula saiba como a música é construída: as suas próprias músicas depois que o Nebula as analisou (veja Como o Nebula ouve uma música), e músicas do rádio que ele ouviu antes ou de que se lembra. Até lá ficam em 0, e com o microfone também.

Fonte	Valor
`section`	A intensidade da parte atual da música, indo aos poucos em direção à próxima parte quando ela se aproxima. Muda quando a música passa para uma estrofe, um refrão ou uma ponte.
`build`	Sobe enquanto a música cresce em direção a um grande momento.
`drop`	Salta quando uma subida se solta num drop ou num grande refrão, e depois diminui.
`downbeat`	1 na primeira batida de cada compasso.
`sectionProgress`	De 0 a 1 ao longo da parte atual.
`songProgress`	0 no começo da música, 1 no fim.
`harmony`	Acordes mais claros, de som maior, dão valores altos; os mais escuros, menores, dão valores baixos.
`tension`	Alto quando o acorde está longe da tonalidade principal da música: a música parece não resolvida.
`chordRoot`	Qual acorde está tocando, pela sua nota fundamental, de 0 a 1 ao longo das doze notas.
`melody`	A altura da melodia cantada ou principal, de 0 (grave) a 1 (aguda).
`melodyConfidence`	O quanto a análise tem certeza de que alguém está cantando ou de que um instrumento principal está tocando.

Aleatório

Fonte	Valor
`random:smooth`	Um valor que desliza até um novo valor aleatório a cada batida, sem nunca saltar. A mesma música dá os mesmos valores.
`random:smooth/bar`	O mesmo, com um valor novo a cada compasso.
`random:smooth:7`	O mesmo com a semente 7. Outro número dá outro padrão. A semente 1 é o padrão.
`random`	Salta para um valor aleatório dentro da faixa do controle a cada batida. Use Smooth para suavizar os saltos.
`random/bar`	O mesmo, a cada compasso.

Sem andamento (por exemplo, com o microfone), random:smooth continua a dois valores por segundo.

Numbers (passos na batida)

Uma fonte Numbers percorre números que você escolhe, um por batida, e coloca o controle diretamente nesse número, nas unidades do próprio controle. O Amount não é usado. Digite a fonte na caixa Numbers da janela (por exemplo 1-5:1) e ela aparece como uma linha que você pode ligar.

Sintaxe

Você digita	O que faz
`1-5:1`	Passos 1, 2, 3, 4, 5, depois volta para 1, um por batida.
`0-1:0.25`	0; 0,25; 0,5; 0,75; 1; e de novo.
`1-5:1/bar`	O mesmo, um passo por compasso (quatro batidas) em vez de por batida.
`0-1:random`	Um valor aleatório entre 0 e 1 a cada batida (qualquer valor no meio).
`1-5:1:random`	Um passo aleatório a cada batida: só 1, 2, 3, 4 ou 5.
`0-1:random:7`, `1-5:1:random:7`, `random:7`	O mesmo com a semente 7: outra semente, outro padrão. A mesma semente sempre se repete.
`random`	Um valor aleatório em toda a faixa do controle a cada batida.
`0-1:random/bar`	Um valor aleatório a cada compasso. Acrescente `/bar` a qualquer um deles.

Detalhes: a forma é low-high:step (mínimo-máximo:passo), opcionalmente seguida de :random (passos aleatórios), :seed (a semente, um número inteiro) e /bar ou /beat. Se você escrever a faixa ao contrário (5-1:1), o Nebula a inverte. O passo precisa ser maior que 0 e gerar no máximo 1000 valores. Uma fonte pode ter no máximo 64 caracteres, e os espaços são ignorados.

Na janela, as fontes Numbers que você criou mostram um Edit e um ×. Edit muda a fonte e mantém os cabos dela nos seus controles; o botão de apagar remove a fonte e os cabos dela.

Dica. Numbers são ótimas para controles que andam em passos inteiros, como o número de emissores, e para trocar um visual a cada compasso.

Time (segundos da música)

As fontes Time mudam ao longo dos segundos do tempo da música, não das batidas. Elas também definem o controle diretamente (o Amount não é usado). Digite-as na caixa Time. A janela já começa com 0-1:gate/4s,4s, 0-1:tri/30s e 0-1:ramp/30s.

Forma	Você digita	O que faz
Gate	`gate/3s,7s`	Ligado por 3 segundos, desligado por 7, repetindo. Duas durações: ligado, depois desligado.
Ramp (rampa)	`ramp/20s`	Desliza do valor mínimo ao máximo em 20 segundos e fica lá. `ramp/0s` é um salto instantâneo.
Saw (dente de serra)	`saw/20s`	Sobe do mínimo ao máximo em 20 segundos, volta de uma vez e repete.
Triangle (triângulo)	`tri/30s`	Sobe e desce uma vez a cada 30 segundos, em linhas retas.
Sine (senoide)	`sine/45s`	O mesmo ciclo de subir e descer, suave nas duas pontas.

Opções

Uma faixa. Coloque low-high: (mínimo-máximo) na frente, por exemplo 0.2-0.8:tri/30s. Sem ela, a fonte usa a faixa inteira do controle. Uma faixa do maior para o menor, como 1-0:ramp/20s, é mantida, então ela corre para baixo.
Um começo atrasado. Acrescente @30s no fim, por exemplo 0-1:gate/3s,7s@30s ou ramp/20s@10s. Até lá, o valor é o mínimo.
As durações vão de 0,1 a 3600 segundos, cada uma terminando em s. Só uma rampa pode usar 0s.
Um exemplo completo: 0.3-1:gate/2.5s,12s@45s fica desligado (0,3) nos primeiros 45 segundos e depois ligado (1) por 2,5 segundos a cada 14,5.

Como o relógio anda

O tempo da música fica parado quando a música está pausada, acompanha você quando você pula pela música e recomeça do 0 a cada música nova. Uma troca de cena não o reinicia.

Dica. As fontes Time são boas para cenas lentas: faça uma camada aparecer aos poucos ao longo de um minuto com ramp/60s, deixe uma cor derivar com tri/90s ou faça uma camada piscar por alguns segundos a cada meio minuto com um gate.

Cores

Fonte	Valor
`colour:scene`	A cor da paleta em movimento: a cor em que todo visual no modo paleta está agora.
`colour:scene:3`	A cor 3 da cena (a numeração começa em 1 e vai até 12), incluindo qualquer cabo ligado a ela.
`below:2:rgb`	A cor média de tudo o que está embaixo da camada 2.

Ligada a um controle de cor, uma fonte de cor puxa o controle em direção àquela cor conforme o Amount. Ligada a qualquer outro controle, ela dá a luminosidade da cor.

Saídas de camada e camadas abaixo

Saídas de camada. Alguns Elementos publicam um sinal, como o burst de Fireflies. Ele aparece listado sob o Elemento na página Elementos. Num arquivo de cena, ele é layer:<number>:<output>, contando as camadas a partir do topo, começando em 0. Ligue layer:1:burst ao brilho de outra camada e ela pisca junto com o enxame.

Camadas abaixo. Estas olham o que as camadas embaixo de uma camada produzem:

Fonte	Valor
`below:<n>:brightness`	O quanto as camadas embaixo da camada n parecem claras.
`below:<n>:colour`	O quanto elas são coloridas.
`below:<n>:motion`	O quanto elas estão mudando.
`below:<n>:0.5,0.5`	O brilho num ponto da imagem (x depois y, de 0 a 1; 0,0 é o canto superior esquerdo). A janela oferece o centro.

A camada de baixo não tem nada embaixo dela, então não tem fontes Layers below.

A conta

Para um controle numérico:

knob = base + amount × shaped value × (knob max − knob min)

O resultado fica dentro da faixa do controle. Base é onde você colocou o próprio controle deslizante do controle, e shaped value (valor moldado) é a fonte depois de In from / In to e da curva. Então um controle que deve subir com a música precisa de uma base baixa o bastante para deixar espaço: Pin height vai de 0 a 2, então uma base de 0,6 e um Amount de 0,4 podem subir até 1,4. Vários cabos num controle se somam.

As fontes Numbers e Time pulam essa conta: elas colocam o controle diretamente no valor delas.

Receitas

Pontos de partida; ajuste a gosto. "Ligar" quer dizer arrastar da fonte até o controle.

Objetivo	Fonte → controle	Ajustes
Crescer com o grave	`bass` → um controle de tamanho ou altura	Amount 0,15 a 0,3, Smooth 0,25
Flash nos ataques	`onset` → brilho ou luminosidade	Amount 0,2, Smooth 0,1, Curve Gate, Threshold 0,3
Elevar no refrão	`energy` (ou `section`) → brilho ou densidade	Amount 0,3, Smooth 2, In from 0,3, In to 0,9
Subida e drop	`build` → um controle de velocidade ou de giro; `drop` → um controle de explosão ou de ondulação	Build: Amount 0,4, Smooth 0,5. Drop: Amount 0,5, Smooth 0,2
Cor conforme o clima	`harmony` → o Color shift da cena	Amount 0,3, Smooth 3. Acordes menores deslizam a paleta para um lado, maiores para o outro.
Vida lenta em músicas calmas	`random:smooth/bar` → um controle de deriva ou de giro	Amount 0,15, Smooth 2
Trocar um visual a cada compasso	`1-4:1/bar` → um controle com passos inteiros	Amount não se aplica
Fazer uma camada aparecer ao longo de um minuto	`0-1:ramp/60s` → um controle de uma camada que funcione como opacidade, como o brilho	Amount não se aplica
Um brilho por 3 segundos a cada 30	`0-1:gate/3s,27s` → brilho	Smooth 0,5 para suavizar as bordas

Num arquivo de cena

As cenas são salvas como arquivos .nebula, e os cabos são escritos neles como texto. Isso é útil se você pede para um assistente de IA escrever uma cena para você, ou se edita uma à mão. Um cabo fica assim:

{ "source": "bass", "target": { "layer": 0, "key": "height" },
  "amount": 0.25, "smooth": 0.2, "curve": "ease", "range": [0.1, 0.8], "threshold": 0.5 }

target.layer conta as camadas a partir do topo (0 é a camada de cima), ou é "scene" para as cores da cena (shift, speed, colour1 e assim por diante). range é o mesmo que In from e In to. Os nomes das fontes são os desta página. Um cabo cuja fonte não pode ser lida, ou cuja camada ou controle não existe, é ignorado sem mensagem. Veja Cenas › O arquivo .nebula.