Programação Nyquist

Introdução ao Nyquist🔗

Nyquist é um dialeto de Lisp criado por Roger Dannenberg para síntese e processamento de áudio. No Audacity, ele é acessado via Tools > Nyquist Prompt....

Sintaxe Básica🔗

; Comentários começam com ;
; Notação prefixada (polonesa):
(+ 1 2)        ; → 3
(* 3 4)        ; → 12
(sqrt 16)      ; → 4

Variáveis e Sinais🔗

A variável s representa o áudio selecionado:

; Reduz volume pela metade
(mult s 0.5)

; Inverte o áudio
(reverse s)

; Aplica filtro passa-baixa
(lowpass8 s 1000)

Criando um Plugin com Controles🔗

Para criar um plugin que aparece no menu de efeitos:

;nyquist plug-in
;version 3
;type process
;name "Volume Adjust"
;action "Adjusting volume..."
;control level "Volume" float "linear" 1.0 0.0 2.0

(mult s level)

Headers Explicados🔗

Controles de Usuário🔗

;control name "Label" type "unit" default min max

Tipos de controle:

Exemplos Práticos🔗

Gerador de Tom com Fade🔗

;nyquist plug-in
;version 3
;type generate
;name "Tom com Fade"
;action "Gerando tom..."
;control freq "Frequência (Hz)" float "" 440 20 20000
;control dur "Duração (s)" float "" 2 0.1 30
;control amp "Amplitude" float "" 0.5 0.0 1.0

(mult (fmosc (hz-to-step freq) (pwe 1 dur))
      (pwlv 0 0 amp dur 0)
      amp)

Detector de Picos (Análise)🔗

;nyquist plug-in
;version 3
;type analyze
;name "Detector de Picos"
;action "Analisando picos..."

(let ((peak (peak s ny:all)))
  (format nil "Pico: ~a dB" (linear-to-db peak)))

Funções Úteis🔗

Processamento🔗

(lowpass8 s freq)      ; Filtro passa-baixa
(highpass8 s freq)     ; Filtro passa-alta
(scale factor s)       ; Escala o sinal
(reverse s)            ; Inverte o áudio
(s-abs s)              ; Valor absoluto (retifica)
(rms s)                ; Valor RMS
(peak s ny:all)        ; Pico máximo

Geração🔗

(fmosc step fm)        ; Oscilador FM
(osc step)             ; Oscilador simples
(noise duration)       ; Ruído branco
(silence duration)     ; Silêncio

Matemática🔗

(hz-to-step freq)      ; Hz para step MIDI
(step-to-hz step)      ; Step MIDI para Hz
(linear-to-db val)     ; Linear para dB
(db-to-linear db)      ; dB para linear

Referências🔗

• Nyquist Documentation
• Audacity Manual — Nyquist
• Audacity Wiki — Nyquist Plug-ins