267 lines
5.3 KiB
Markdown
267 lines
5.3 KiB
Markdown
# FX Automation Applied
|
|
|
|
## Resumen de Automatizacion de FX Implementada
|
|
|
|
**Sprint:** Granular v0.1.40
|
|
**Tareas:** T072-T077
|
|
**Modulo:** Integrado en `server.py`
|
|
|
|
---
|
|
|
|
## Resumen Ejecutivo
|
|
|
|
Se implemento automatizacion de FX para transiciones dinamicas en secciones de tracks reggaeton, incluyendo filter sweeps, reverb tails, pitch risers y micro-timing.
|
|
|
|
---
|
|
|
|
## FX Implementados
|
|
|
|
### T072: Filter Sweep Automation
|
|
|
|
```python
|
|
def apply_filter_sweep(
|
|
track_index: int,
|
|
section_start_bar: int,
|
|
section_end_bar: int,
|
|
sweep_type: str = "highpass_up"
|
|
) -> str:
|
|
```
|
|
|
|
**Tipos de sweep:**
|
|
- `highpass_up`: Sube filtro de graves antes del drop
|
|
- `lowpass_down`: Baja filtro de agudos para breaks
|
|
|
|
**Uso tipico:**
|
|
- 8 bars antes del drop: low-cut sube de 80Hz a 1.2kHz
|
|
- Snap al drop: filtro regresa a 80Hz instantaneamente
|
|
|
|
---
|
|
|
|
### T073: Reverb Tail Automation
|
|
|
|
```python
|
|
def apply_reverb_tail_automation(
|
|
track_index: int,
|
|
section_start_bar: int,
|
|
section_end_bar: int
|
|
) -> str:
|
|
```
|
|
|
|
**Patron de reverb:**
|
|
- Reverb 0% -> 40% -> 0% para crear espacio en breaks
|
|
- Automatizacion de reverb send steerable
|
|
|
|
**Uso tipico:**
|
|
- Breaks atmos: reverb sube al inicio, baja antes del build
|
|
- Vocals: reverb swell antes del drop
|
|
|
|
---
|
|
|
|
### T074: Pitch Riser Automation
|
|
|
|
```python
|
|
def apply_pitch_riser(
|
|
track_index: int,
|
|
start_bar: int,
|
|
end_bar: int,
|
|
start_semitones: float = 0,
|
|
end_semitones: float = 12
|
|
) -> str:
|
|
```
|
|
|
|
**Configuracion:**
|
|
- Pitch inicial: 0 semitonos
|
|
- Pitch final: +12 semitonos (1 octava arriba)
|
|
|
|
**Uso tipico:**
|
|
- Sintetizadores de textura antes del drop
|
|
- Noise sweeps con pitch rise
|
|
- Snare rolls con pitch creciente
|
|
|
|
---
|
|
|
|
### T075: Micro-Timing Push
|
|
|
|
```python
|
|
def apply_micro_timing_push(
|
|
track_index: int,
|
|
kick_offset_ms: float = -5,
|
|
bass_offset_ms: float = 8,
|
|
apply_to_clips: bool = True
|
|
) -> str:
|
|
```
|
|
|
|
**Offsets tipicos:**
|
|
- Kick: -5ms (adelantado, "push")
|
|
- Bass: +8ms (atrasado, "siente")
|
|
|
|
**Efecto:**
|
|
- Crea groove organico tipo hardware
|
|
- Evita rigidez de cuantizacion perfecta
|
|
|
|
---
|
|
|
|
### T076: Groove Template Application
|
|
|
|
```python
|
|
def apply_groove_template(
|
|
section: str,
|
|
template_name: str = "tech_house_drop"
|
|
) -> str:
|
|
```
|
|
|
|
**Templates disponibles:**
|
|
- `tech_house_drop`: Groove apretado, sidechain pronunciado
|
|
- `tech_house_break`: Mas swing, espaciado
|
|
- `deep_house_drop`: Groove suelto, shuffle suave
|
|
- `techno_minimal`: Preciso, casi straight
|
|
|
|
---
|
|
|
|
### T077: Transition FX Injection
|
|
|
|
```python
|
|
def inject_transition_fx_detailed(
|
|
fx_type: str,
|
|
position_bar: int,
|
|
intensity: str = "medium"
|
|
) -> str:
|
|
```
|
|
|
|
**Tipos de FX:**
|
|
- `riser`: Ascenso de tension
|
|
- `crash`: Impacto en transicion
|
|
- `snare_roll`: Rollde snare crescendo
|
|
- `noise_sweep`: Barrido de ruido blanco
|
|
- `reverse`: Reverb inverso
|
|
|
|
---
|
|
|
|
## Integracion con Estructura Reggaeton
|
|
|
|
### Intro (0-32 beats)
|
|
- Sin FX automation
|
|
- Layer basico: kick, hat, bass
|
|
|
|
### Build A (32-64 beats)
|
|
- Filter sweep: highpass up desde bar 56
|
|
- Pitch riser: +6 semitonos en ultimos 8 bars
|
|
- Reverb tail creciendo
|
|
|
|
### Drop A (64-128 beats)
|
|
- Snap de filtros al inicio
|
|
- Micro-timing: kick -5ms, bass +8ms
|
|
- Groove template: tech_house_drop
|
|
|
|
### Break (128-160 beats)
|
|
- Reverb swell: 0% -> 40% -> 0%
|
|
- Filter sweep: lowpass down
|
|
- FX: reverse reverb antes del build
|
|
|
|
### Build B (160-192 beats)
|
|
- Pitch riser: +12 semitonos
|
|
- Noise sweep
|
|
- Snare roll crescendo
|
|
|
|
### Drop B (192-256 beats)
|
|
- Snap de filtros
|
|
- Groove template aplicado
|
|
- Maximum energy
|
|
|
|
### Outro (256-288 beats)
|
|
- Filter sweep: lowpass down
|
|
- Fade de elementos
|
|
|
|
---
|
|
|
|
## Ejemplos de Uso
|
|
|
|
### Filter Sweep Pre-Drop
|
|
|
|
```python
|
|
# Aplicar filter sweep 8 bars antes del drop
|
|
result = apply_filter_sweep(
|
|
track_index=6, # Synth track
|
|
section_start_bar=56, # Bar 56 de 64
|
|
section_end_bar=64,
|
|
sweep_type="highpass_up"
|
|
)
|
|
```
|
|
|
|
### Reverb Tail en Break
|
|
|
|
```python
|
|
# Reverb automation en break
|
|
result = apply_reverb_tail_automation(
|
|
track_index=8, # Atmos track
|
|
section_start_bar=128,
|
|
section_end_bar=160
|
|
)
|
|
```
|
|
|
|
### Pitch Riser en Build
|
|
|
|
```python
|
|
# Pitch riser 1 octava en build B
|
|
result = apply_pitch_riser(
|
|
track_index=6, # Synth track
|
|
start_bar=160,
|
|
end_bar=192,
|
|
start_semitones=0,
|
|
end_semitones=12
|
|
)
|
|
```
|
|
|
|
---
|
|
|
|
## Parametros por Defecto
|
|
|
|
| FX | Parametro | Valor Default |
|
|
|----|-----------|---------------|
|
|
| Filter sweep | Frecuencia inicio | 80 Hz |
|
|
| Filter sweep | Frecuencia fin | 1.2 kHz |
|
|
| Reverb tail | Wet % inicio | 0% |
|
|
| Reverb tail | Wet % peak | 40% |
|
|
| Pitch riser | Semitonos inicio | 0 |
|
|
| Pitch riser | Semitonos fin | +12 |
|
|
| Micro-timing | Kick offset | -5 ms |
|
|
| Micro-timing | Bass offset | +8 ms |
|
|
|
|
---
|
|
|
|
## Validacion
|
|
|
|
### Checklist de FX
|
|
|
|
- [ ] Filter sweep sube antes del drop
|
|
- [ ] Reverb swell en breaks
|
|
- [ ] Pitch riser en builds
|
|
- [ ] Micro-timing en drops
|
|
- [ ] Transition FX en puntos clave
|
|
|
|
### Tests
|
|
|
|
```powershell
|
|
python -m pytest "tests/test_fx_automation.py" -v
|
|
```
|
|
|
|
---
|
|
|
|
## Limitaciones
|
|
|
|
1. **Solo MIDI tracks**: La automatizacion de audio requiere clips existentes
|
|
2. **Timing preciso**: Los FX dependen de estructura correcta
|
|
3. **Dispositivos**: Solo funciona con dispositivos que exponen parametros
|
|
|
|
---
|
|
|
|
## Roadmap
|
|
|
|
- [ ] T078: Automatizacion de compresor sidechain
|
|
- [ ] T079: Automatizacion de EQ dinamico
|
|
- [ ] T080: Morphing de presets
|
|
|
|
---
|
|
|
|
*Maintained by: AbletonMCP-AI Team*
|
|
*Last updated: 2026-04-05* |