Patches

Un cable toma algo que está haciendo la música (el bajo, el beat, una subida, un reloj lento, incluso otra capa) y lo usa para mover una perilla. En Patches es donde los conectas. Pro

Crear un cable

La ventana tiene las fuentes a la izquierda, un carril en el medio y, a la derecha, todas las perillas de todas las capas (más los colores de la escena). Cada fuente y cada perilla tiene un circulito, su puerto.

Arrastra desde el círculo de una fuente hasta el círculo de una perilla. Aparece un cable entre ellos, del color de la fuente.
Toca el cable (o el nombre de una fila) para abrir sus ajustes: cuánto mueve la perilla, con cuánta suavidad y qué forma tiene.
Arrastra el extremo de un cable a otro círculo para moverlo.
Para quitar un cable, ábrelo y toca la papelera, y luego toca otra vez para confirmar. En una Mac, selecciónalo y presiona Backspace.

Una perilla puede recibir varios cables; sus efectos se suman. Mantén presionado (o pasa el puntero sobre) cualquier nombre para ver un breve texto de ayuda. Solo las perillas marcadas "Cable: yes" en la página de Elementos pueden ser destinos.

Consejo. Los Elementos ya reaccionan a la música por sí solos, así que casi nunca necesitas un cable en cada perilla. Uno o dos cables bien pensados por capa valen más que diez.

Qué hace un cable

Toca un cable para ver su pequeña gráfica (la fuente en tenue, el resultado en brillante, los últimos 3 segundos) y estos ajustes:

Ajuste	Qué hace
Amount	Cuánto mueve el cable la perilla, como fracción del rango completo de la perilla, de -1 a 1. Un valor negativo la mueve hacia abajo. El control deslizante de la propia perilla es el punto de partida; el cable se suma a él. (No aparece con las fuentes Numbers y Time, que fijan la perilla directamente).
Smooth	Con cuánta lentitud sigue la perilla, en segundos (0 a 3). Con 0 sigue cada salto. Entre 0.05 y 0.15 va bien para golpes, entre 0.2 y 0.6 para el bajo y los pulsos, y entre 1 y 3 para derivas lentas.
Curve	Cambia la forma de la señal de 0 a 1 antes de que llegue a la perilla. Ver abajo.
In from, In to	La parte de la fuente que cuenta. Los valores iguales o menores que In from pasan a 0; los iguales o mayores que In to pasan a 1. Sube In from para ignorar los pasajes suaves.
Threshold	Aparece con las curvas Threshold y Gate: el nivel (0 a 1) que la señal tiene que superar.

Curvas

Curve	Forma
Linear	La señal tal cual.
Invert	Invertida (1 menos la señal): lo fuerte pasa a ser suave.
Ease	Una S suave; más tranquila en los extremos.
Exp	Las partes suaves se vuelven más suaves: espera y luego salta.
Log	Las partes suaves se vuelven más fuertes: salta y luego se asienta.
Threshold	Un escalón suave: apagado por debajo del nivel, encendido por encima.
Gate	0 por debajo del nivel; por encima, la señal misma.

Una perilla de color funciona un poco distinto. Una fuente numérica la mueve a lo largo de una lista de colores: la paleta propia de la capa; si no tiene, los colores de la escena; y si no, alrededor de la rueda de colores. Con Amount 1 y la señal al máximo, recorre la lista una vuelta completa; con 0.25 avanza un cuarto. Una fuente de color (ver Colors) lleva la perilla hacia ese color según Amount. Un interruptor está encendido mientras la señal del cable supera la mitad.

Todas las fuentes

Las fuentes vienen en grupos, en este orden en la ventana. Todos los valores van de 0 a 1, salvo que se indique otra cosa.

Grupo	Qué contiene
Music	Bajos, medios, agudos, nivel, energía, ataques, beat, fase del beat, fase del compás, transición, música escasa.
Bands	Franjas del espectro, desde el bajo más profundo hasta el agudo más alto.
Song structure	Sección, subida, drop, tiempo fuerte, avance, armonía, tensión, raíz del acorde, melodía.
Random	Valores aleatorios suaves o en escalones.
Colors	El color de la paleta en movimiento, un color de la escena, el color debajo de una capa.
Layer outputs	Señales que publican otras capas, como una ráfaga.
Layers below	Qué tan brillantes, coloridas o movidas se ven las capas de abajo.
Numbers	Pasos con el beat o el compás, en las unidades de la propia perilla. Estos los escribes tú.
Time	Compuertas, rampas, dientes de sierra, triángulos y senoides a lo largo de los segundos de la canción. Estos los escribes tú.

Music, en vivo

Funcionan con todo: canciones, radio, el micrófono y This Mac.

Fuente	Valor
`bass`	Qué tan fuerte suenan los graves (bombo, bajo). Rápido.
`mid`	Qué tan fuerte suenan los medios (voces, guitarras, teclados).
`treble`	Qué tan fuerte suenan los agudos (platillos, hi-hats, aire).
`level`	El volumen general en este momento, suavizado a lo largo de una décima de segundo, más o menos.
`energy`	El volumen lento, a lo largo de unos 3 segundos: alto en los coros y los drops, bajo en las partes tranquilas. La mejor fuente para cambios grandes y suaves.
`onset`	Picos en los golpes repentinos (batería, punteos, ataques). Para destellos y golpes.
`beat`	1 en el momento en que cae un beat; si no, 0. Dale al cable algo de Smooth (0.1 a 0.3) para que sea un pulso y no un clic.
`beatPhase`	Sube de 0 a 1 a lo largo de cada beat y vuelve a empezar. Pulso constante.
`barPhase`	Sube de 0 a 1 a lo largo de cada compás de cuatro beats. Giros lentos y sincronizados.
`transition`	Sube de 0 a 1 mientras una canción hace el fundido cruzado con la siguiente.
`thin`	0 con la mezcla completa, hasta 1 cuando la música se vacía: se van la batería o el bajo, hay un break, o queda solo una voz y un pad. Lento y suave. Úsalo para abrir una escena cuando la canción se vuelve escasa. Una vez analizada la canción, la lee completa (puede ver venir una parte tranquila); hasta entonces, y en la radio antes de que el análisis la alcance, se basa en el último medio minuto de sonido y solo reacciona después de que la música se vacía. Ve los graves, el volumen y cuántas bandas están activas, así que no nota que se quita un bombo solo mientras sigue un bajo sostenido.

Bands (bandas)

El espectro se divide en 64 bandas: la banda 0 es el bajo más profundo (unos 30 Hz) y la banda 63 el agudo más alto (unos 16 kHz). Una fuente de bandas promedia un tramo de ellas, cada una escalada a su propio rango reciente para que las bandas suaves también se muevan. La ventana ofrece 12 ya listas; para usar otro tramo, pídelo en un archivo de escena (bands:A-B).

Fuente	Abarca
`bands:0-7`	Bajo profundo
`bands:0-3`, `bands:0-15`	Las cuatro bandas más graves, y el cuarto más bajo del espectro
`bands:16-39`	Los medios
`bands:40-63`	Los agudos
`bands:8-15`, `16-23`, `24-31`, `32-39`, `40-47`, `48-55`, `56-63`	Ocho franjas iguales, de grave a agudo

Song structure (estructura de la canción)

Estas necesitan que Nebula sepa cómo está construida la canción: tus propias canciones una vez que Nebula las analizó (ver Cómo escucha Nebula una canción), y las canciones de radio que escuchó por adelantado o que recuerda. Hasta entonces se quedan en 0, y también con el micrófono.

Fuente	Valor
`section`	Qué tan intensa es la parte actual de la canción, acercándose a la siguiente parte a medida que llega. Cambia cuando la canción pasa a una estrofa, un coro o un puente.
`build`	Sube a medida que la música crece hacia un gran momento.
`drop`	Salta cuando una subida se libera en un drop o un gran coro, y luego se desvanece.
`downbeat`	1 en el primer beat de cada compás.
`sectionProgress`	De 0 a 1 a lo largo de la parte actual.
`songProgress`	0 al principio de la canción, 1 al final.
`harmony`	Los acordes más luminosos, de sonido mayor, dan valores altos; los más oscuros, menores, valores bajos.
`tension`	Alto cuando el acorde está lejos de la tonalidad principal de la canción: la música se siente sin resolver.
`chordRoot`	Qué acorde suena, según su nota raíz, de 0 a 1 a lo largo de las doce notas.
`melody`	Qué tan aguda es la melodía cantada o principal, de 0 grave a 1 aguda.
`melodyConfidence`	Qué tan seguro está el análisis de que alguien canta o suena una melodía principal.

Random (aleatorio)

Fuente	Valor
`random:smooth`	Un valor que se desliza hacia uno nuevo al azar en cada beat, sin saltar nunca. La misma canción da los mismos valores.
`random:smooth/bar`	Lo mismo, con un valor nuevo en cada compás.
`random:smooth:7`	Lo mismo con la semilla 7. Otro número da otro patrón. La semilla predeterminada es 1.
`random`	Salta a un valor al azar dentro del rango de la perilla en cada beat. Usa Smooth para suavizar los saltos.
`random/bar`	Lo mismo, en cada compás.

Sin tempo (por ejemplo, con el micrófono), random:smooth sigue a dos valores por segundo.

Numbers (pasos con el beat)

Una fuente Numbers recorre los números que elijas, uno por beat, y pone la perilla directamente en ese número, en las unidades de la propia perilla. Amount no se usa. Escribe la fuente en el cuadro Numbers de la ventana (por ejemplo 1-5:1) y aparece como una fila que puedes conectar.

Sintaxis

Escribes	Qué hace
`1-5:1`	Pasa por 1, 2, 3, 4, 5 y vuelve a 1, uno por beat.
`0-1:0.25`	0, 0.25, 0.5, 0.75, 1, y otra vez.
`1-5:1/bar`	Lo mismo, un paso por compás (cuatro beats) en vez de por beat.
`0-1:random`	Un valor al azar entre 0 y 1 en cada beat (cualquier valor intermedio).
`1-5:1:random`	Un paso al azar en cada beat: solo 1, 2, 3, 4 o 5.
`0-1:random:7`, `1-5:1:random:7`, `random:7`	Lo mismo con la semilla 7: otra semilla, otro patrón. La misma semilla siempre se repite.
`random`	Un valor al azar en todo el rango de la perilla en cada beat.
`0-1:random/bar`	Un valor al azar en cada compás. Agrega `/bar` a cualquiera de ellos.

Detalles: la forma es low-high:step (mínimo-máximo:paso), seguida opcionalmente de :random (pasos al azar), :seed (un número entero) y /bar o /beat. Si escribes el rango al revés (5-1:1), Nebula lo invierte. El paso debe ser mayor que 0 y no dar más de 1000 valores. Una fuente puede tener como máximo 64 caracteres, y los espacios se ignoran.

En la ventana, los Numbers que creaste muestran un Edit y una ×. Edit cambia la fuente y mantiene sus cables en sus perillas; la eliminación quita la fuente y sus cables.

Consejo. Numbers va muy bien para perillas que avanzan en pasos enteros, como la cantidad de emisores, y para cambiar de aspecto en cada compás.

Time (segundos de la canción)

Las fuentes Time cambian a lo largo de los segundos de la canción, no de los beats. También fijan la perilla directamente (Amount no se usa). Escríbelas en el cuadro Time. La ventana te da para empezar 0-1:gate/4s,4s, 0-1:tri/30s y 0-1:ramp/30s.

Forma	Escribes	Qué hace
Compuerta	`gate/3s,7s`	Encendida 3 segundos, apagada 7, y se repite. Dos duraciones: encendida y luego apagada.
Rampa	`ramp/20s`	Se desliza del valor bajo al alto en 20 segundos y se queda ahí. `ramp/0s` es un salto instantáneo.
Diente de sierra	`saw/20s`	Sube de bajo a alto en 20 segundos, vuelve de golpe y se repite.
Triángulo	`tri/30s`	Sube y vuelve a bajar una vez cada 30 segundos, en línea recta.
Senoide	`sine/45s`	El mismo ciclo de subida y bajada, suave en ambos extremos.

Opciones

Un rango. Pon low-high: delante, por ejemplo 0.2-0.8:tri/30s. Sin rango, la fuente usa todo el rango de la perilla. Un rango de alto a bajo, como 1-0:ramp/20s, se respeta, así que va hacia abajo.
Un inicio tardío. Agrega @30s al final, por ejemplo 0-1:gate/3s,7s@30s o ramp/20s@10s. Hasta entonces el valor es el bajo.
Las duraciones van de 0.1 a 3600 segundos, cada una terminada en s. Solo una rampa puede usar 0s.
Un ejemplo completo: 0.3-1:gate/2.5s,12s@45s está apagado (0.3) durante los primeros 45 segundos y luego encendido (1) durante 2.5 segundos de cada 14.5.

Cómo corre el reloj

El tiempo de la canción se detiene cuando la música está en pausa, te sigue cuando saltas por la canción y vuelve a empezar desde 0 con cada canción nueva. Un cambio de escena no lo reinicia.

Consejo. Las fuentes Time van bien para escenas lentas: haz aparecer una capa poco a poco en un minuto con ramp/60s, deja que un color derive con tri/90s, o haz destellar una capa unos segundos cada medio minuto con una compuerta.

Colors (colores)

Fuente	Valor
`colour:scene`	El color de la paleta en movimiento: el color en el que está ahora mismo cada visual en modo paleta.
`colour:scene:3`	El color 3 de la escena (la numeración empieza en 1, hasta 12), incluido cualquier cable que tenga.
`below:2:rgb`	El color promedio de todo lo que hay debajo de la capa 2.

En una perilla de color, una fuente de color lleva la perilla hacia ese color según Amount. En cualquier otra perilla da la luminosidad del color.

Layer outputs y Layers below

Layer outputs (salidas de capa). Algunos Elementos publican una señal, como el burst de Fireflies. Aparece debajo del Elemento en la página de Elementos. En un archivo de escena es layer:<number>:<output>, contando las capas desde arriba y empezando en 0. Conecta layer:1:burst al brillo de otra capa y destellará con el enjambre.

Layers below (capas de abajo). Estas miran lo que producen las capas que hay debajo de una capa:

Fuente	Valor
`below:<n>:brightness`	Qué tan brillantes se ven las capas debajo de la capa n.
`below:<n>:colour`	Qué tan coloridas son.
`below:<n>:motion`	Cuánto están cambiando.
`below:<n>:0.5,0.5`	El brillo en un punto de la imagen (x y luego y, de 0 a 1; 0,0 es la esquina superior izquierda). La ventana ofrece el centro.

La capa de abajo no tiene nada debajo, así que no tiene fuentes Layers below.

Las cuentas

Para una perilla numérica:

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

El resultado se mantiene dentro del rango de la perilla. Base es donde pones el control deslizante de la propia perilla, y shaped value (valor con forma) es la fuente después de In from / In to y de la curva. Así que una perilla que debe subir con la música necesita una base lo bastante baja para dejar espacio: Pin height va de 0 a 2, así que con una base de 0.6 y un amount de 0.4 puede subir hasta 1.4. Varios cables en una perilla se suman.

Las fuentes Numbers y Time se saltan esto: ponen la perilla directamente en su valor.

Recetas

Puntos de partida; ajústalos a tu gusto. "Conectar" significa arrastrar desde la fuente hasta la perilla.

Objetivo	Fuente → perilla	Ajustes
Crecer con el bajo	`bass` → una perilla de tamaño o de altura	Amount 0.15 a 0.3, Smooth 0.25
Destello en los golpes	`onset` → glow o brillo	Amount 0.2, Smooth 0.1, Curve Gate, Threshold 0.3
Impulso en el coro	`energy` (o `section`) → brillo o densidad	Amount 0.3, Smooth 2, In from 0.3, In to 0.9
Subida y drop	`build` → una perilla de velocidad o de remolino; `drop` → una perilla de ráfaga o de ondas	Build: Amount 0.4, Smooth 0.5. Drop: Amount 0.5, Smooth 0.2
Color según el ánimo	`harmony` → el Color shift de la escena	Amount 0.3, Smooth 3. Los acordes menores deslizan la paleta hacia un lado y los mayores hacia el otro.
Vida lenta en canciones tranquilas	`random:smooth/bar` → una perilla de deriva o de remolino	Amount 0.15, Smooth 2
Cambiar de aspecto en cada compás	`1-4:1/bar` → una perilla de pasos enteros	Amount no se aplica
Hacer aparecer una capa en un minuto	`0-1:ramp/60s` → una perilla que funcione como la opacidad de la capa, como el brillo	Amount no se aplica
Un resplandor de 3 segundos cada 30	`0-1:gate/3s,27s` → glow	Smooth 0.5 para suavizar los bordes

En un archivo de escena

Las escenas se guardan como archivos .nebula, y los cables se escriben en ellos como texto. Esto es útil si dejas que un asistente de IA escriba una escena por ti, o si editas una a mano. Un cable se ve así:

{ "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 cuenta las capas desde arriba (0 es la capa de arriba), o es "scene" para los colores de la escena (shift, speed, colour1, etc.). range equivale a In from e In to. Los nombres de las fuentes son los de esta página. Un cable cuya fuente no se puede leer, o cuya capa o perilla no existe, se omite sin ningún mensaje. Consulta Escenas › El archivo .nebula.