# Plug-ins

> Use efeitos OFX na imagem e efeitos VST3 ou Audio Unit no som no nolanlabs: onde o app os procura, como adicioná-los e quais não rodam.

Page: https://nolanlabs.io/pt-br/docs/plug-ins

O nolanlabs hospeda os plug-ins que outros editores aceitam: OpenFX para imagem, e VST3 (e, no Mac, Audio Units) para som. Cada tipo roda em um programa próprio ao lado do editor, então um plug-in que trava para aquele render, não o editor.

## Adicione um plug-in de imagem

Estes são os efeitos de imagem OFX que o Resolve, o Nuke e o Premiere também hospedam, como Neat Video, Boris FX, Sapphire e openfx-misc.

1. Instale-o na pasta OFX do seu sistema.
2. Selecione um clipe e abra **Plug-ins** no Inspetor.
3. Se você o instalou com o editor aberto, clique em **Procurar de novo**.
4. Ajuste os campos dele, e ligue-o ou desligue-o.

| Sistema | Pasta OFX |
| --- | --- |
| Mac | `/Library/OFX/Plugins` |
| Windows | `C:\Program Files\Common Files\OFX\Plugins` |

As pastas em `NOLAN_OFX_PATH`, depois em `OFX_PLUGIN_PATH`, são procuradas primeiro.

Um plug-in roda no quadro de origem antes de qualquer outra coisa que o clipe faça. Um clipe com um plug-in é desenhado na CPU e reproduz a partir do cache de render depois que ele é gerado.

### Quais não rodam

A lista de plug-ins diz por que um não pode ser usado.

- **Mais de uma entrada:** transições, retimers e geradores.
- **Só 8 ou 16 bits:** ele precisa trabalhar em float.
- **Só OpenGL.**

Um plug-in com controles próprios na tela, como overlays ou painéis personalizados, pega os campos só do Inspetor. Um plug-in que abre uma janela de licença não espera um clique, e um sem licença costuma desenhar a marca d’água no lugar.

Um projeto aberto onde um plug-in não está instalado o mantém no clipe. Renderizar esse clipe falha e diz qual plug-in está faltando.

## Adicione um plug-in de som

1. Selecione um clipe de som e abra **Plug-ins** no Inspetor.
2. Escolha um efeito e ajuste os campos dele.

Ele roda sobre o som do clipe enquanto reproduz, na velocidade dele e de trás para a frente quando reproduz de trás para a frente, antes dos efeitos, nível, pan e fades do próprio clipe. Os renders, a mixdown do visualizador e as leituras de loudness rodam o plug-in.

| Sistema | Procurado em |
| --- | --- |
| Mac, VST3 | `~/Library/Audio/Plug-Ins/VST3`, `/Library/Audio/Plug-Ins/VST3` |
| Mac, Audio Units | Os que o macOS lista: os da própria Apple (AUDynamicsProcessor, AUPeakLimiter, AUNBandEQ, AUMatrixReverb e outros) e qualquer um instalado, versão 2 ou 3 |
| Windows, VST3 | `C:\Program Files\Common Files\VST3`, `%LOCALAPPDATA%\Programs\Common\VST3` |

As pastas em `NOLAN_VST3_PATH`, depois em `VST3_PATH`, são procuradas primeiro.

### O que esperar

- Eles vão nos clipes, não nas trilhas nem no master.
- Eles trabalham em estéreo a 48 kHz.
- As caudas deles param no fim do clipe.
- Instrumentos não são hospedados.
- As janelas próprias deles não abrem, então você ajusta os campos no Inspetor.
- Não há side chain nem MIDI.
- A latência que um plug-in informa é compensada, então o som volta no lugar.

## Veja o que foi encontrado

Num shell, estes comandos listam o que foi encontrado, com os campos de cada um ou o motivo de não poder ser usado:

```sh
nolan-cli plugins
nolan-cli sound-plugins
```

Veja [Scripts](https://nolanlabs.io/pt-br/docs/scripting), [Som](https://nolanlabs.io/pt-br/docs/sound) e [Limites conhecidos](https://nolanlabs.io/pt-br/docs/known-limits).
