Update: 2024-09-28
ParallelDetune は 8 つのピッチシフタを並列につないだエフェクタです。モノラルの音に薄くかけてコーラスのようにパンを左右に広げることもできます。
full
- VST 3 をダウンロード (github.com) macOS
- VST 3 をダウンロード (github.com) full
パッケージには次のビルドが含まれています。
Linux ビルドは Ubuntu 24.04 でビルドしています。もし Ubuntu 24.04 以外のディストリビューションを使っているときは、プラグインが読み込まれないなどの不具合が起こることがあります。この場合はビルド手順に沿ってソースコードからビルドしてください。
macOS で使用するときは macOS
パッケージのダウンロードを推奨します。また Apple Developer Program
に加入していないので、インストール時に Gatekeeper
を迂回するように設定する必要があります。詳細は
インストール -> macOS
の節を参照してください。
何かあれば GitHub
のリポジトリに issue を作るか ryukau@gmail.com
までお気軽にどうぞ。
paypal.me/ryukau から開発資金を投げ銭することもできます。
名前が .vst3
で終わるディレクトリを OS
ごとに決められた位置に配置してください。
/Program Files/Common Files/VST3/
に配置します。$HOME/.vst3/
に配置します。/Library/Audio/Plug-ins/VST3/
あるいは
/Users/$USERNAME/Library/Audio/Plug-ins/VST3/
に配置します。DAW によっては上記とは別に VST3 をインストールできるディレクトリを提供していることがあります。詳しくは利用している DAW のマニュアルを参照してください。
注意: プリセットの無いプラグインもあります。
プリセットはページの最上部のリンクからダウンロードできるプラグインパッケージに含まれています。以下はプリセットのインストール手順です。
presets
ディレクトリ内の Uhhyou
ディレクトリを OS ごとに決められたディレクトリに配置。以下は OS ごとのプリセットの配置先の一覧です。
/Users/$USERNAME/Documents/VST3 Presets
$HOME/.vst3/presets
/Users/$USERNAME/Library/Audio/Presets
プリセットディレクトリの名前はプラグインと同じである必要があります。配置先のディレクトリが無いときは作成してください。
プラグインが DAW に認識されないときは C++ redistributable
をインストールしてみてください。インストーラは次のリンクからダウンロードできます。ファイル名は
vc_redist.x64.exe
です。
Ubuntu 24.04 では次のパッケージのインストールが必要です。
sudo apt install libxcb-cursor0 libxkbcommon-x11-0
もし DAW がプラグインを認識しないときは、下のリンクの
Package Requirements
を参考にして VST3
に必要なパッケージがすべてインストールされているか確認してください。
REAPER の Linux 版がプラグインを認識しないときは
~/.config/REAPER/reaper-vstplugins64.ini
を削除して
REAPER を再起動してみてください。
重要: full
パッケージは動作未確認です。以下のファイルは codesign
されていないので削除する必要があるかもしれません。
Contents/Resources/Documentation
Contents/x86_64-linux
Contents/x86_64-win
macOS
パッケージでは上記のファイルの削除は不要です。また、すべてのパッケージは
codesign
コマンドの ad-hoc signing
の状態になっています。
プラグインの初回起動時に「破損している」という趣旨のメッセージが表示されることがあります。この場合は、ターミナルを開いて、解凍した
.vst3
ディレクトリに次のコマンドのどちらか、あるいは両方を適用してみてください。
/path/to/PluginName.vst3
の部分はインストールしたプラグインのパスに置き換えてください。
xattr -rd com.apple.quarantine /path/to/PluginName.vst3
xattr -rc /path/to/PluginName.vst3
プラグインは署名されていない (unsigned) 、または公証されていない (un-notarized) アプリケーションとして認識されることがあります。この場合は、警告メッセージが表示された後に、システム環境設定を開いて「セキュリティとプライバシー」 → 「一般」の「このまま開く」ボタンを押してください。以下にリンクした Apple 公式のヘルプページにスクリーンショット付きで同じ手順が掲載されています。「ノータリゼーションを受けていない App や未確認の開発元の App を開きたい場合」を参照してください。
ここまでの手順を経てまだ動かないときはインストール先を
/Library/Audio/Plug-ins/VST3/
あるいは
/Users/$USERNAME/Library/Audio/Plug-ins/VST3/
のいずれか使っていなかったほうに変えてみてください。
上記の方法がすべて上手くいかなかったときは以下の手順を試してみてください。
sudo spctl --master-disable
を実行。上記の手順を実行するとシステムのセキュリティが弱くなるので注意してください。元に戻すには以下の手順を実行してください。
sudo spctl --master-enable
を実行。codesign
の適用注意 この節の内容は macOS
パッケージには関連しないと考えられますが未検証です。 (GitHub の
issue)
full
パッケージを利用する場合は以下のコマンドを適用することで利用できるかもしれません。
sudo codesign --force --deep -s - /path/to/PluginName.vst3
codesign
の利用には Xcode
のインストールが必要となるかもしれません。
初回設定時は手動で次のファイルを作成してください。
/Users/ユーザ名/AppData/Roaming/UhhyouPlugins/style/style.json
。$XDG_CONFIG_HOME/UhhyouPlugins/style/style.json
。
$XDG_CONFIG_HOME
が空のときは
$HOME/.config/UhhyouPlugins/style/style.json
。/Users/$USERNAME/Library/Preferences/UhhyouPlugins/style/style.json
。プラグインのウィンドウを開くたびに style.json
が読み込まれて更新されます。
既存の色のテーマを次のリンクに掲載しています。
style.json
にコピペして使ってください。
style.json
の設定例です。
{
"fontFamily": "Tinos",
"fontBold": true,
"fontItalic": true,
"foreground": "#000000",
"foregroundButtonOn": "#000000",
"foregroundInactive": "#8a8a8a",
"background": "#ffffff",
"boxBackground": "#ffffff",
"border": "#000000",
"borderCheckbox": "#000000",
"borderLabel": "#000000",
"unfocused": "#dddddd",
"highlightMain": "#0ba4f1",
"highlightAccent": "#13c136",
"highlightButton": "#fcc04f",
"highlightWarning": "#fc8080",
"overlay": "#00000088",
"overlayHighlight": "#00ff0033"
}
以下はフォントオプションの一覧です。
fontFamily
: フォントファミリ名。fontBold
: ボールドスタイル (太字) を
true
で有効、 false
で無効。fontItalic
: イタリックスタイル (斜体) を
true
で有効、 false
で無効。カスタムフォントを使用するには、プラグインディレクトリの
*.vst3/Contents/Resources/Fonts
に *.ttf
ファイルを配置します。
注意: fontFamily
、
fontBold
、 fontItalic
で設定したフォントファミリ名とスタイルの組み合わせが
*.vst3/Contents/Resources/Fonts
以下のいずれかの
*.ttf
ファイルに含まれていないときは VSTGUI
が指定するデフォルトフォントが使用されます。
fontFamily
が長さ 0 の文字列 ""
のときはフォールバックとして "Tinos"
に設定されます。長さが 1
以上かつ、存在しないフォントファミリ名が指定されると VSTGUI
が指定するデフォルトフォントが使用されます。
ボールドあるいはイタリック以外のスタイルは VSTGUI がサポートしていないので動作確認していません。該当する例としては Noto フォントの Demi Light や、 Roboto フォントの Thin や Black などがあります。
16 進数カラーコードを使っています。
プラグインはカラーコードの 1 文字目を無視します。よって
?102938
や \n11335577
も有効なカラーコードです。
2 文字目以降のカラーコードの値に 0-9a-f
以外の文字を使わないでください。
以下は設定できる色の一覧です。設定に抜けがあるとデフォルトの色が使われます。
foreground
: 文字の色。foregroundButtonOn
:
オンになっているボタンの文字の色。 foreground
か
boxBackground
のいずれかと同じ値にすることを推奨します。foregroundInactive
:
非アクティブなタブの文字の色。background
: 背景色。boxBackground
: 矩形の UI 部品の内側の背景色。border
: 縁の色。borderCheckbox
: チェックボックスの縁の色。borderLabel
:
パラメータセクションのラベルの左右の直線の色。unfocused
:
つまみがフォーカスされていないときの色。highlightMain
:
フォーカスされたときの色。スライダの値の表示にも使用されます。highlightAccent
:
フォーカスされたときの色。一部のプラグインをカラフルにするために使用されます。highlightButton
:
ボタンがフォーカスされたときの色。highlightWarning
: 変更に注意を要する UI
がフォーカスされたときの色。overlay
: オーバーレイの色。overlayHighlight
:
フォーカスを示すオーバーレイの色。パラメータが割り当てられているコントロールの上で 右クリック すると、 DAW から提供されるコンテキストメニューが開きます。
つまみと数値スライダでは次の操作ができます。
青い縦棒が並んだコントロール (BarBox) ではショートカットが使えます。ショートカットは BarBox を左クリックしてフォーカスすると有効になります。フォーカス後にマウスカーソルを BarBox の領域外に移動させると、ショートカットが一時的に無効になります。ショートカットによって変更されるパラメータはカーソルの位置によって変更できます。
左下のプラグイン名をクリックすると、よく使いそうな一部のショートカットを見ることができます。利用できる全てのショートカットを次の表に掲載しています。
入力 | 操作 |
---|---|
左ドラッグ | 値の変更 |
Shift + 左ドラッグ | 値の変更 (スナップ) |
Ctrl + 左ドラッグ | デフォルト値にリセット |
Ctrl + Shift + 左ドラッグ | 値の変更 (フレーム間の補間が無効) |
ホイールドラッグ | 直線の描画 |
Shift + ホイールドラッグ | 1 つのバーを編集 |
Ctrl + ホイールドラッグ | デフォルト値にリセット |
Ctrl + Shift + ホイールドラッグ | ロックの切り替え |
a | 符号を交互に入れ替え |
d | すべての値をデフォルト値にリセット |
D | 最小値・中央値・最大値の切り替え |
e | 低域の強調 |
E | 高域の強調 |
f | ローパスフィルタ |
F | ハイパスフィルタ |
i | 値の反転 (最小値を保存) |
I | 値の反転 (最小値を 0 に設定) |
l | マウスカーソル下のバーのロックの切り替え |
L | 全てのバーのロックを切り替え |
n | 最大値を 1 に正規化 (最小値を保存) |
N | 最大値を 1 に正規化 (最小値を 0 に設定) |
p | ランダムに並べ替え |
r | ランダマイズ |
R | まばらなランダマイズ |
s | 降順にソート |
S | 昇順にソート |
t | 少しだけランダマイズ (ランダムウォーク) |
T | 少しだけランダマイズ (0 に収束) |
z | アンドゥ |
Z | リドゥ |
, (Comma) | 左に回転 |
. (Period) | 右に回転 |
1 | すべての値を低減 |
2-4 | インデックスが 2n-4n の値を低減 |
5-9 | インデックスが 2n-5n の値をホールド |
Shift + 左ドラッグ のスナップは一部の BarBox だけで有効になっています。特定の BarBox にスナップを追加したいという要望があれば、気軽に GitHub のリポジトリに issue を開いてください。
Shift + ホイールドラッグ による 1 つのバーを編集は、マウスホイールが押された時点でカーソルの下にあるバーだけを編集します。マウスホイールが押されている間はカーソルの左右の位置に関わらず、選択したバーのみを編集できます。
Ctrl + Shift + ホイールドラッグ によるロックの切り替えでは、マウスホイールが押された時点でカーソルの下にあるバーの反対の状態が残り全てに適用されます。例えばカーソルの下のバーがアクティブだったときはロックに切り替えます。
いくつかの BarBox の下にはスクロールバーがついています。細かい調整を行うときはスクロールバーの左右のハンドルを 左ドラッグ で動かすことで表示範囲を変更できます。スクロールバーでは次の操作が行えます。
図が小さいときはブラウザのショートカット Ctrl + マウスホイール や、右クリックから「画像だけを表示」などで拡大できます。
図で示されているのは大まかな信号の流れです。実装と厳密に対応しているわけではないので注意してください。
ParallelDetune はノートイベントによってピッチシフトの量を制御することができます。
角かっこ [] で囲まれているのは単位です。以下は ParallelDetune のパラメータで使われている単位の一覧です。
バイパスした入力信号のゲインです。
ParallelDetune を通過した信号のゲインです。
ピッチシフタの出力をフィードバックするときのゲインです。
フィードバック経路のハイパスあるいはローパスフィルタのカットオフ周波数です。
ピッチシフタのバッファの長さです。表示されている値は大まかな目安です。
Delay Time
の値はピッチシフトがかかっていないときだけ正確です。ピッチが変更されるとバッファを読み取る速度が変わるので、表示されている値とディレイ時間が一致しなくなります。
数値スライダの右のつまみで LFO をかけることができます。
すべてのピッチシフタで共通して使われるシフト量です。
すべてのピッチをまとめて変更するときに便利です。
数値スライダの右のつまみで LFO をかけることができます。
ピッチシフタの出力を左右に広げて配置する割合です。
Pan. Spread
が 0.0
のとき、左右のチャネルは独立して処理されます。
Pan. Spread
が 1.0
のときはピッチシフタのインデックスごとに左右の信号を加算した上で、インデックスの低いほうから高いほうに向かって、左から右にパンを振ります。
数値スライダの右のつまみで LFO
をかけると音を回すことができます。ただし Pan. Spread
の
LFO の波形はサイン波に固定されています。
トレモロと組み合わせることで左右の広がり方に変化をつけることができます。
各ピッチシフタの出力にトレモロをかけるパラメータです。
Tremolo Lean
が 12 時を指しているか、
Tremolo Mix
が左いっぱいのときにトレモロは無効となります。
Tremolo Lean
を左いっぱいか右いっぱいに設定した上で、
Tremolo Mix
を右いっぱいにするとトレモロをかけた出力のみになります。
Pan. Spread
が 0.0 でないときは
Tremolo Lean
の値によって左あるいは右に音が偏ります。
ピッチシフトの量です。
大きく音を変えるときは Pitch Shift
、少しだけデチューンを行うときは Fine Tuning
が使えます。
Pitch Shift
は ± 1 オクターブ、 Fine Tuning
は ± 10 セントの幅で調節できます。
各ピッチシフタのゲインです。
各ピッチシフタのバッファの長さを Delay Time
から相対的に変更する量です。
各ピッチシフタのハイパスあるいはローパスフィルタのカットオフ周波数を
HP
あるいは LP
の値から相対的に変更する量です。
ステレオチャンネル間で LFO の位相をずらす量です。
LFO の位相に加算される値です。
Rate
を左いっぱいに回して LFO の位相を止めているときに
Phase
の値を変更することで、 LFO
の位相を制御することができます。また Smoothing
の値によって Phase
を動かしたときの応答速度を変えることができます。
チェックを入れるとテンポ同期を有効にします。また同期間隔が変わったときに再生開始時点から導かれる位相へと同期します。
チェックが外れているときは 120 BPM に同期した状態と同じになります。ただし、同期間隔が変わったときに位相を調整しなくなります。
テンポ同期が有効な時の同期間隔を表す分数の分子です。
1/1
のときに 1 小節、 4/4拍子であれば 1/4
のときに 1 拍で LFO が 1 周します。 Rate
が乗算されて周期が変わる点に注意してください。
以下は同期間隔の計算式です。
syncInterval = (Rate) * (Tempo Upper) / (Tempo Lower);
テンポ同期が有効な時の同期間隔を表す分数の分母です。
Rate
が乗算されて周期が変わる点に注意してください。
同期間隔に乗算される係数です。
Tempo Upper
と Tempo Lower
を変えずに LFO
の同期間隔を変えたいときに使えます。
LFO の波形の補間方法です。
Step
: ホールド。Linear
: 線形補間。PCHIP
: 単調な 3 次補間。Step
を選ぶと LFO をシーケンサのように使えます。
Linear
は PCHIP
と似たような音になりますが、計算がすこし速いです。デフォルトの
PCHIP
はサンプル間をだいたい滑らかに補間します。
LFO の波形です。
パラメータのスムーシング時間です。
例えば Smoothing
の値を 0.01
と短くするとパラメータの変更がほぼ瞬時に適用されます。ただし
Smoothing
の値を小さくするとパラメータ変更時のポップノイズが目立つようになります。逆に
Smoothing
の値を 1.0
などと長くするとパラメータの値がゆっくりと切り替わるようになります。
style.json
によりプラグインがクラッシュするバグを修正。foregroundInactive
の色を変更。processContext
が nullptr
であるために
Audacity で音が正しく出力されなかったバグを修正。ParallelDetune のライセンスは GPLv3 です。 GPLv3 の詳細と、利用したライブラリのライセンスは次のリンクにまとめています。
リンクが切れているときは ryukau@gmail.com
にメールを送ってください。
VST is a trademark of Steinberg Media Technologies GmbH, registered in Europe and other countries.