# プラグイン

> nolanlabs で、映像に OFX エフェクト、音声に VST3 や Audio Unit エフェクトを使う方法です。アプリが探す場所、追加の仕方、動かないもの。

Page: https://nolanlabs.io/ja/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 で描かれ、一度作られるとレンダーキャッシュから再生されます。

### 動かないもの

プラグインの一覧に、使えない理由が表示されます。

- **入力が2つ以上**：トランジション、リタイマー、ジェネレーター。
- **8 ビットまたは 16 ビットのみ**：浮動小数点で動く必要があります。
- **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/ja/docs/scripting)、[サウンド](https://nolanlabs.io/ja/docs/sound)、[既知の制限](https://nolanlabs.io/ja/docs/known-limits)を参照してください。
