# 플러그인

> nolanlabs에서 영상에는 OFX 효과를, 사운드에는 VST3나 Audio Unit 효과를 쓰는 방법. 앱이 찾는 위치, 추가하는 방법, 실행되지 않는 플러그인.

Page: https://nolanlabs.io/ko/docs/plug-ins

nolanlabs는 다른 편집기가 쓰는 플러그인을 호스팅합니다. 영상에는 OpenFX, 사운드에는 VST3(Mac에서는 Audio Units도)입니다. 종류마다 편집기 옆의 별도 프로그램에서 실행되므로, 플러그인이 충돌하면 편집기가 아니라 그 렌더만 멈춥니다.

## 영상 플러그인 추가하기

Resolve, Nuke, Premiere도 호스팅하는 OFX 이미지 효과입니다. Neat Video, Boris FX, Sapphire, openfx-misc 같은 것들입니다.

1. 시스템의 OFX 폴더에 설치하세요.
2. 클립을 선택하고 인스펙터에서 **플러그인**을 여세요.
3. 편집기가 열려 있는 동안 설치했다면 **다시 찾기**를 누르세요.
4. 항목을 설정하고, 켜거나 끄세요.

| 시스템 | OFX 폴더 |
| --- | --- |
| Mac | `/Library/OFX/Plugins` |
| Windows | `C:\Program Files\Common Files\OFX\Plugins` |

`NOLAN_OFX_PATH`, 그다음 `OFX_PLUGIN_PATH`에 있는 폴더를 먼저 찾습니다.

플러그인은 클립의 다른 어떤 처리보다 먼저 소스 프레임에 적용됩니다. 플러그인이 있는 클립은 CPU로 그려지고, 한 번 만들어지면 렌더 캐시에서 재생됩니다.

### 실행되지 않는 플러그인

플러그인 목록에 쓸 수 없는 이유가 나옵니다.

- **입력이 둘 이상:** 트랜지션, 리타이머, 제너레이터.
- **8비트나 16비트 전용:** float로 동작해야 합니다.
- **OpenGL 전용.**

오버레이나 자체 패널처럼 화면 위 컨트롤이 있는 플러그인도 항목은 인스펙터에서만 받습니다. 라이선스 창을 여는 플러그인은 클릭을 기다리지 않고, 라이선스가 없는 플러그인은 보통 대신 워터마크를 그립니다.

플러그인이 설치되지 않은 곳에서 프로젝트를 열어도 플러그인은 클립에 그대로 남습니다. 그 클립을 렌더하면 실패하고, 어떤 플러그인이 없는지 알려 줍니다.

## 사운드 플러그인 추가하기

1. 사운드 클립을 선택하고 인스펙터에서 **플러그인**을 여세요.
2. 효과를 고르고 항목을 설정하세요.

플러그인은 클립의 사운드가 재생되는 대로, 그 속도로, 역재생이면 거꾸로 적용되며, 클립 자체의 효과, 레벨, 팬, 페이드보다 먼저 적용됩니다. 렌더, 뷰어의 믹스다운, 라우드니스 측정 모두 플러그인을 거칩니다.

| 시스템 | 찾는 위치 |
| --- | --- |
| Mac, VST3 | `~/Library/Audio/Plug-Ins/VST3`, `/Library/Audio/Plug-Ins/VST3` |
| Mac, Audio Units | macOS가 나열하는 것: Apple 자체 플러그인(AUDynamicsProcessor, AUPeakLimiter, AUNBandEQ, AUMatrixReverb 등)과 설치된 모든 플러그인, 버전 2 또는 3 |
| Windows, VST3 | `C:\Program Files\Common Files\VST3`, `%LOCALAPPDATA%\Programs\Common\VST3` |

`NOLAN_VST3_PATH`, 그다음 `VST3_PATH`에 있는 폴더를 먼저 찾습니다.

### 알아 둘 것

- 트랙이나 마스터가 아니라 클립에 들어갑니다.
- 48 kHz 스테레오로 동작합니다.
- 테일은 클립 끝에서 멈춥니다.
- 악기 플러그인은 호스팅하지 않습니다.
- 플러그인 자체 창은 열리지 않으므로, 항목은 인스펙터에서 설정합니다.
- 사이드체인과 MIDI는 없습니다.
- 플러그인이 보고하는 레이턴시는 보정되므로, 사운드는 제자리로 돌아옵니다.

## 찾은 것 확인하기

셸에서 다음 명령으로 찾은 플러그인 목록을, 각각의 항목이나 쓸 수 없는 이유와 함께 볼 수 있습니다.

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

[스크립팅](https://nolanlabs.io/ko/docs/scripting), [사운드](https://nolanlabs.io/ko/docs/sound), [알려진 한계](https://nolanlabs.io/ko/docs/known-limits)를 보세요.
