Vision MOD は macOS と Windows で動作するリアルタイム映像シンセサイザーです。モジュラーシンセサイザーの Complex Oscillator——一方のオシレーターでもう一方を整形する仕組み——を映像領域に持ち込みます。Modifier の素材がダイナミクスを与え、Carrier の素材はそのダイナミクスに乗る映像。ある映像素材が別の映像素材を変調し、新しい視聴覚現象が生まれます。
ソース以降の各 station はこの合成された Carrier 映像流に対して動作します。背景除去は素材の起点(Fundamental Vision)でのみ行い、それ以降、内容のない領域は alpha 0 を保持し、下流の各 station はそのピクセルを破棄するため、チェーン全体で被写体の切り抜きが維持されます。

| HUE | HUE カラーホイールパネルを開閉し、UI のアクセントカラーを調整 |
| SIGNAL | SIGNAL フローティングウィンドウを開閉(輪郭プレビュー + 7 本の CV メーター + 音声入力メーター + CV Output ルーティング + LFO) |
| Language | UI 言語を切替(EN/日/中)。ホバー説明も連動し、選択は保存されます |
| SD status | SD サービス状態:起動中は SD Loading、完了後は使用中のアクセラレーションを表示 |
| Outer ring | 外環:ドラッグでアクセントの色相を変更 |
| Centre | 中央:上下ドラッグでアクセントの彩度を変更 |
| Presets | プリセット色相:クリックで Coral/Mint/Sky/Violet を適用 |
| Phase colours | 位相派生カラープレビュー(補色 +180°/三分割 ±120°/類似 ±30°)、参考表示のみ |
パイプラインはメインウィンドウ左側のシグナルフロー一覧で定義します。Fundamental Vision はソースアンカーとしてスロット 1 に固定、それ以外のモジュールはユーザーが追加・並べ替え・bypass・削除を行います。grip アイコンをドラッグして並べ替え、X アイコン(2 クリック確認)で削除、チェックボックスで個別 bypass。同種のモジュールを複数 instance 化でき、各 instance は独立したパラメータで上から下へ直列接続されます。

| Signal Flow | シグナルフロー(Signal Flow):モジュール一覧、上から順に実行。同種のモジュールを複数 instance 化でき、各 instance のパラメータは独立 |
| Drag to reorder | ドラッグ並べ替え:grip アイコンを掴んで上下にドラッグし instance の位置を変更(基礎ビジョンは第一スロット固定) |
| Remove | モジュールを削除:1 回目のクリックで行に「確認?」を表示、同じ X をもう一度クリックで削除。他の場所をクリックまたは Esc で取消 |
| Enable | この instance を有効化:チェックを外すと bypass(信号は次の station へ素通し)。パラメータと順序は維持。例外:Stable Diffusion は解除でモデルを解放、Slow Motion は再チェックで録画をクリアして録り直し |
| Previous module | シグナルフローの前のモジュールパネルへ切替(先頭では末尾へ移動) |
| Next module | シグナルフローの次のモジュールパネルへ切替(末尾では先頭へ移動) |
| Preview | プレビュー:クリックで「現在のモジュールの効果」と「最終出力」を切替。マスクパネルを開いている間はここでマスクを描画 |
+ Module ボタンでモジュールライブラリを開きます。追加できるモジュール:Stable Diffusion(Windows 版は Stream Diffusion)、Minimalize、Chromascope、3D オブジェクト、パーティクル、Flow Warp、Feedback、3D モデル、スローモーション、プラグイン。Stable Diffusion は単一 instance で、チェーンに存在する間は項目がグレー表示になります。基礎ビジョンは固定アンカーで、追加も削除もできません。
| Module item | クリックでこのモジュールをシグナルフローの末尾に追加して有効化。グレー表示は 1 つまでのモジュールが既に存在することを示す |
Fundamental Vision 以降の各 station は同じヘッダーコントロールを共有します:有効チェックボックス、Mix、Brightness、Position / Scale パッド。Mix はその station の dry/wet で、唯一のミックスコントロールです。モジュール内に独自の mix フェーダーはありません。新規追加した instance の Mix は 0 から始まるため、追加した時点では画面は変わらず、Mix を上げると効果が現れます。

| Mix | ステーションの dry/wet 混合:0 で前段出力を素通し、1 で全効果 |
| Brightness | このステーションの出力輝度ゲイン(0–4、ダブルクリックで 1 に戻る) |
| Position / Scale | 位置/拡大:ドラッグで移動、スクロールで拡大(0.25–4)、ダブルクリックで位置を中央に戻し拡大率を 1 に戻す |
| Mask icon | クリックでこのモジュールのブラシマスクパネルを開く:塗った範囲を除去または保持に設定できます |
各モジュール instance は個別のマスクを持ち、マスクパネルを開いている間にプレビュー上で描画します。マスクは表示されている画面に追従し、出力のアスペクト比を変えても、描いた内容は画面内の同じ相対位置に残ります。描いた内容、モード、ブラシ設定は設定およびプロジェクトファイルに保存されます。
| オフ/削除/保持 | マスクモード(クリックで順に切替):オフ/削除(塗った範囲を除去)/保持(塗った範囲のみ残す)。プレビュー上をドラッグして描画。描いた内容、モード、ブラシ設定は保存され、再起動後やプロジェクトファイルの読み込み後に復元されます |
| 太さ | ブラシの太さ(0.01–0.30)。以降に描くストロークにのみ反映 |
| ぼかし | ブラシ縁のぼかし(0–1)。以降に描くストロークにのみ反映 |
| ノイズ | ブラシのノイズ量(0–1)。以降に描くストロークにのみ反映 |
| 不透明度 | ブラシの不透明度(0.05–1)。以降に描くストロークにのみ反映 |
| クリア | 描いたマスクを消去して未マスク状態に戻す。モードとブラシ設定は維持 |

ソース station。左に Modifier、右に Carrier の 2 スロットが並びます。各スロットにはカメラ、動画ファイル、写真を割り当てられます。Modifier は Color 信号、各モジュールの Displace、Flow Warp の流れ場の元になり、Carrier がチェーンに送られる映像本体です。

| Module | 素材入力モジュール:Modifier(左)が Carrier(右)を変調、Mix で両者を合成 |
| Modifier | Modifier スロット:変調素材。Color CV、粒子 Displace、Flow Warp フロー場のソース |
| Carrier | Carrier スロット:主視覚映像、下流処理チェーンへ流れます |
| Mix | Carrier と Modifier の合成:右へ動かすと Carrier、左で Modifier |
| Brightness | Fundamental Vision の出力輝度(0–1、1 で元の明るさ) |
| Source type | ソース種別:カメラ/動画/写真の三択(動画・写真はドラッグ&ドロップで読み込み) |
| Remove background | 背景除去(3 段階:オフ/人物を残す/反転して背景を残す):MediaPipe が前景マスクを計算し、Modifier と Carrier を合成した後の映像に適用 |
| Flip H | ソース映像を水平反転(左右ミラー);producer 段階で適用、チェーン全体に反映 |
| Flip V | ソース映像を垂直反転(上下ミラー);producer 段階で適用、チェーン全体に反映 |
| Speed | 読み込んだ動画の再生速度(0 停止、1 等速、5 五倍速) |

| Camera | カメラ入力デバイスを選択 |
| Settings icon | クリックでカラー設定パネルを開く(Brightness/Contrast/Saturation、ソフトウェア補正)。Carrier と Modifier は独立設定を保持 |
| 明るさ | 明るさ(ソフトウェア補正、0–1、0.5 で変化なし) |
| コントラスト | コントラスト(ソフトウェア補正、0–1、0.5 で変化なし) |
| 彩度 | 彩度(ソフトウェア補正、0–1、0.5 で変化なし) |

| File path | 読み込み中のファイルパス。ウィンドウへドロップで読み込み(左半分=Modifier、右半分=Carrier) |
動画または写真ファイルが見つからない、または読み取り権限がない場合(ファイルが移動された、別のコンピュータのプロジェクトを開いた等)、コントロールウィンドウにスロット名付きのメッセージが表示されます。ファイルをウィンドウにドロップし直してください。読み取れるようになるとメッセージは消えます。

メインウィンドウのモジュールパネルの下には常に Contour Scanner と CV Generator が表示されます。スキャナーは映像から輪郭を検出し、CV Generator はスキャン・動き・色をモジュレーション信号に変換します。グローバル操作行(PRESET、PLUGINS、OUTPUT、ビジュアル再起動、説明書、ヘルプ)は Contour Scanner パネルの上部にあります。

| Module | 輪郭スキャナーモジュール:映像から輪郭を検出し、SEQ 信号と輪郭オーバーレイを生成 |
| Preview | 輪郭プレビュー:輪郭線+走査点+ドラッグ可能な走査範囲円(ROI) |
| Scan ROI | 走査範囲円:中心をドラッグで走査アンカー移動、縁をドラッグで走査範囲を調整 |
| Threshold | 輪郭エッジ検出の閾値:高いほど強いエッジのみ残します |
| Smoothing | 輪郭の時間方向スムージング:値は新しいフレームの比重。低いほど変化が遅く安定し、100 でスムージングなし |
| Stillness | Stillness:輪郭の更新ゲート(エッジ検出の閾値ではありません):画面がこの値(%)を超えて変化したときだけ輪郭を再検出します。高いほど輪郭は静止したまま保たれ CPU/GPU の負荷も下がり、低いほど反応が速くなり、0 ではほぼ毎フレーム再計算します |
| Contour Lock | 現在の輪郭を固定:再検出を停止し、固定した輪郭に沿って走査を続けます。固定中は Threshold、Smoothing、Stillness がグレー表示になり操作できません |
| Mix | 輪郭オーバーレイの合成比率 |
| Module | CV Generator:映像からモジュレーション信号を生成(輪郭 SEQ、Movement、Color) |
| Scan Time | 輪郭走査周期:走査が一巡する時間(0.1-300 秒)。トラック上の白線が現在の走査位置 |
| Smooth | SEQ と Movement 信号の平滑度 |
| Gain | Movement 信号のゲイン(ソース:最終出力画面) |
| Foreground | 前景閾値:アルファがこの値を超えるピクセルのみ Movement と Color CV に算入します |
入力映像を AI 生成映像に変換します。macOS は Stable Diffusion 1.5 + ControlNet + Hyper-SD15 1-step LoRA(Metal)、Windows は Stream Diffusion(CUDA / TensorRT)で実行します。チェーン内の Stable Diffusion は 1 つのみ。dry/wet は station の Mix で制御し、Enable が未チェックの間は Mix が 0 に固定されるため、チェーンに空の AI フレームが流れることはありません。

| Enable | Stable Diffusion を有効化:モデルを読み込み、前のモジュールの出力をリアルタイムで AI 生成映像に変換。解除で解放。チェックするたびに Mix は 0 から始まるため、効果を見るには Mix を上げてください。prompt は保持されます |
| Grayscale | AI 出力をグレースケールに強制します |
| Likeness | AI 出力が前のモジュールの出力映像の構造に沿う度合い(高い=入力映像に近い) |
| Preset | 内蔵スタイルプロンプトを切替(29 種の画風/質感) |
| Prompt | AI 生成のテキストプロンプト(望む画風を記述) |
| LoRA | LoRA ファイル(.safetensors)を選択して Stable Diffusion(Windows 版は Stream Diffusion)に適用 |
| LoRA X | 選択中の LoRA ファイルを解除し、LoRA を使用しない |
| Status | SD サービス状態:起動中は SD Loading、完了後は使用中のアクセラレーションを表示 |
Enable をオフにして再度オンにしたとき、再起動後、LOAD 後のいずれもプロンプトは保持されます。再起動後と LOAD 後、Stable Diffusion は常にオフになり、オンにしたとき Mix は 0 から始まります。LoRA ファイルが見つからない、または読み取り権限がない場合、LoRA 行にメッセージが表示され、その LoRA なしで生成されます。ファイルを選び直すとメッセージは消えます。
映像に 8 層を重ね、各層が 1 つの音声入力に対応します。Base Hue が開始色相、Hue Spread が各層の色相分布を決めます。Curve と Angle は第一層を設定し、それぞれの Spread が層ごとの増減量です。層は前のモジュールの出力の明るさで分けられ、画面を等分するものではありません。Level 1 から 8 は各層の明るさで、0 の層は外れます。dry/wet は station の Mix で制御します。

| Enable | Chromascope カラー効果を有効化 |
| Audio | Chromascope 波形の倍率(0 から 5):0 で線なし、3 までは倍率のみ、3 から 5 は波形全体を持ち上げ線が太くなります |
| Base Hue | Chromascope 基準色相 |
| Hue Spread | Chromascope 八層間の色相の広がり:第 k 層の色相 = 基準色相 + 広がり × k / 有効層数 |
| Curve | Chromascope 第一層の波形の曲がり具合;大きいほど線がまばらになり中央で曲がります |
| Curve Spread | Chromascope 層ごとの曲がり具合の増減(正負):第 k 層 = カーブ + k × この値 |
| Angle | Chromascope 第一層の波形の向きの角度(0 から 360 度) |
| Angle Spread | Chromascope 層ごとの角度の増加量:第 k 層 = 角度 + k × この値 |
| Level 1 to 8 | Chromascope この層の明るさ(同じ番号の音声入力に対応)。層は前のモジュールの出力の明るさで分けられ、画面を等分するものではありません。0 でこの層を外し、残りの層で明るさの範囲を分け直します |
追跡したシード点から映像をポリゴンに再構成します。Mode で Triangle(Delaunay メッシュ)、Cell(Voronoi)、Square(Quadtree 矩形)を選択。Fill でポリゴン塗りつぶしとエッジのみのワイヤーフレームを切り替えます。ポリゴンの色はチェーン入力からサンプリングし、Modifier はシード点の変位にのみ使われます。

| Enable | Minimalize を有効化:前のモジュールの出力を seed 点で多角形(Voronoi/Delaunay/Quadtree)に再分割 |
| Density | seed 点の上限数(0-500)。数値が大きいほど多角形が細かくなる |
| Mode | 分割トポロジー:Triangle(Delaunay 三角網)/Cell(Voronoi 細胞)/Square(Quadtree 矩形) |
| Fill | 塗りつぶし切替:オンで Fill Sat の彩度で多角形を塗りつぶし、オフでは輪郭線のみ(ワイヤフレーム) |
| Displace | seed 点を Modifier 映像の R/G チャンネルで 2D 変位(Image Displace 例外経路:Modifier は変位ベクトル源として作用、テクスチャ採色はしない)。0 で無効、大きいほど多角形の揺らぎが強くなる |
| Smooth | seed 点の時間平滑:高い値は LK 追跡のジッターを抑えるが、映像変化への応答が遅くなります |
| Line Color | 多角形の輪郭線の色:Line Sat が 0(デフォルト)のときは 0 から 0.5 で黒から白へ変化し、0.5 以上はすべて白。Line Sat が 0 より大きいときは 0 で黒、0.5 でその色相、1 で白 |
| Line Width | 多角形の輪郭線の太さ(0–5、0 で線を描かない) |
| Line Sat | 輪郭線の彩度(0 で黒/グレー、1 で純色相) |
| Fill Sat | 塗りつぶしの彩度(Fill オフ時は視覚的に無効) |
レイマーチングで描画し、チェーン入力をテクスチャとして貼る 3D オブジェクト。Shape は 5 つのプリミティブ間をモーフィング。Distort、Repeat、Spacing、Jitter、Smooth で形状を整え、Zoom、Pan、Tilt でカメラを動かします。Displace は Modifier の輝度で表面を押し出します。

| Enable | 3D Object を有効化:SDF レイマーチによる立体オブジェクト描画 |
| RESET | 3D Object の全パラメータをデフォルトに戻し、変調を切断します |
| Shape | 3D オブジェクト形状:5 種のプリミティブ(球/箱/トーラス/八面体/ジャイロイド)間でモーフ |
| Size | 3D オブジェクトの全体サイズ |
| Distort | ドメインワープ(sin ドメイン変形)の強さ。デフォルトは 0(オフ)、フェーダーの下限は 0.01 |
| Displace | Modifier 映像の輝度で 3D オブジェクト表面を変位(0 で無効、大きいほど凹凸が深い) |
| Repeat | ドメインリピート:空間内で配列複製する量。デフォルトは 0(オフ)、フェーダーの下限は 0.01 |
| Spacing | 複製配列の間隔 |
| Jitter | 配列のジッター量 |
| Smooth | 融合の滑らかさ(0–5):0 は単一形状。0 より大きいと第二の小球が加わり主形状と融合、大きいほど滑らか |
| Zoom | カメラからオブジェクトまでの距離(2–10) |
| Pan | カメラの水平周回角 |
| Tilt | カメラの俯仰角 |
チェーン入力をテクスチャとして貼った 3D メッシュを描画します。メッシュは選択した OBJ ファイル、または 100 種の内蔵プリセット形状から読み込みます。チェーン内に複数の 3D モデルを置き、それぞれ別のメッシュを持てます。Rotate Y と Rotate X はカメラがモデルの周りを周回し、Rotate Z は画面内で回転、Scale はカメラ距離を設定します。Rotate X / Y / Z、Scale、Displace、Wireframe はモジュレーション可能です。



| Enable | 3D モデルを有効化:読み込んだ OBJ ファイルまたは内蔵形状の 3D モデルを表示 |
| RESET | 3D モデルの全パラメータをデフォルトに戻し、読み込んだモデル(OBJ ファイルと内蔵形状)を外して変調を切断します |
| Rotate Y | カメラがモデルの周りを水平に周回する角度(0–360°) |
| Rotate X | カメラがモデルの周りを垂直に周回する角度(0–360°) |
| Rotate Z | 画面内での回転(ロール)の角度(0–360°) |
| Scale | 画面上のモデルの大きさ(0.1–5):実際にはカメラ距離(1.2 ÷ この値)を設定。大きいほどカメラが近づき、モデルが大きく見える |
| Displace | Modifier 映像の輝度でメッシュ頂点を法線方向に変位(0 で無効、大きいほど凹凸が深い) |
| Wireframe | ワイヤフレーム混合:0 でソリッド、1 で純ワイヤフレーム、中間値は両者の混合 |
| OBJ File | OBJ ファイル(.obj)を選択して 3D モデルを読み込み。クリアで削除 |
| Preset | 内蔵形状(100 種)を 3D モデルとして選択。No Preset で選択解除 |
| Preset: No Preset | No Preset:内蔵形状の選択を解除 |
| Preset: shape | この内蔵形状をモデルとして使用。読み込み済みの OBJ ファイルは置き換えられます |
チェーン入力をサンプリングして 3D パーティクル場にします。Density、Size、Jitter、Shape がパーティクルを定義し、Depth Mix と Displace が z 軸方向に動かし、Zoom は場全体を z 軸方向に前後移動(Depth Mix が 0 のときは見た目に変化なし)、Scale X / Y / Z は場を拡大縮小します。

| Enable | Particle 粒子レンダリングを有効化 |
| RESET | Particle のパラメータと視点をデフォルトに戻し、変調を切断。Displace、Mix、Brightness と位置は変わりません |
| Density | 粒子の密度(サンプリングされる粒子数) |
| Size | 粒子のサイズ |
| Jitter | 粒子位置のジッター量 |
| Shape | 粒子の形状:7 種の形(円/四角/三角/六角形/ひし形/星/リング)の間でモーフ。1 にすると粒子ごとにランダムな形になる |
| Depth Mix | 深度が粒子の z 軸分布に与える影響度 |
| Displace | Modifier 素材の輝度で粒子を z 軸方向に変位させる強さ |
| Zoom | 粒子フィールドを Z 軸方向に前後移動(-1〜1):正の値でカメラに近づき、負の値で遠ざかる。Depth Mix が 0 のときは見た目に変化なし |
| Scale X | 粒子フィールドの X 軸スケール(負値で反転) |
| Scale Y | 粒子フィールドの Y 軸スケール(負値で反転) |
| Scale Z | 粒子フィールドの Z 軸スケール(負値で反転) |
Modifier から計算したオプティカルフローに沿って映像を変位させます。

| Enable | Flow Warp オプティカルフロー効果を有効化(フロー場は Modifier 素材から計算) |
| Strength | オプティカルフロー変位効果の強さ |
| Direction | 変位方向(順方向/逆方向/双方向) |
| Direction: Forward | Forward:検出した動きの方向に沿って映像を押し流す |
| Direction: Reverse | Reverse:検出した動きと逆方向に映像を押し流す |
| Direction: Bidirectional | Bidirectional:順方向と逆方向の結果を半分ずつ混ぜる |
| Accumulate | 蓄積量(0–0.95):前フレームの結果と混ぜる割合。大きいほど残像が長くなります |
| Preset | オプティカルフロー演算プリセット(Ultrafast/Fast/Medium):Ultrafast が最速で最も粗い。Flow Warp が複数ある場合は、シグナルフローで最初のものの設定を使用 |
| Preset: Ultrafast | Ultrafast:オプティカルフローの計算が最も速く、最も粗い |
| Preset: Fast | Fast:オプティカルフロー計算の速度と精度が中間 |
| Preset: Medium | Medium:オプティカルフローの計算が最も遅く、最も精細 |
出力を自身にフィードバックして残像を作ります。

| Enable | Feedback 映像フィードバック効果を有効化 |
| Smooth | スムーズ量:前フレームと混ぜる割合。大きいほど残像が長い。Bright も 0 のときに限り、0 で残像なし |
| Bright | 明部ゲイン(0–1):0 で増光なし。0.5 未満は残像の明るさに上限あり、0.5 以上は明部がフレームごとに明るくなり白に達する |
| Chroma | 色収差量(0–0.005):赤チャンネルを左、青チャンネルを右へずらす距離。0 でオフ |
| Diffuse | 拡散(0–1):フィードバック映像のぼかし量。0 でぼかしなし、大きいほど残像がにじむ |
入力映像を 30 fps で録画し続け、直近の Buffer 秒数分を保持して遅い速度でループ再生します。Buffer から換算したフレーム数が変わったとき、または station をオフ・オンしたときに録画をクリアして録り直します。録画済みのフレームは設定にもプロジェクトファイルにも保存されません。

| Enable | スローモーションを有効化:前のモジュールの出力を録画し、減速してループ再生。オフ→オンで録画をクリアして録り直し |
| RESET | スローモーションの全パラメータをデフォルトに戻し、変調を切断。Buffer から換算したフレーム数が変わる場合のみ録画内容をクリアします |
| Speed | 再生速度(0.05–1、1 = 原速):映像は固定 30fps で録画し、30 × この値の速度で再生。0.25 = 4 倍スローモーション。直近に録画したセグメント内をループ再生 |
| Buffer | セグメント長(0.5–15 秒):30fps で録画を続け、直近 N 秒を保持してループ再生。この値から換算したフレーム数が変わったとき、または本モジュールをオフ→オンしたときにクリアして録り直し。大きいほど VRAM 使用量が増加 |
| Blend | フレーム補間:隣接する 2 枚の録画フレーム間を補間し、スローモーションを滑らかに保つ。オフではコマ飛び再生になる |
サードパーティの fragment shader を station として実行します。プラグインは単一の .wgsl ファイルで、プラグインフォルダ(既定 ~/.visionmod/plugins/、最上位のみ)から読み込みます。フォルダはメインウィンドウの PLUGINS 行で選択し、変更時に自動で再スキャンされます。Plugin パネルにはプラグインを選ぶドロップダウンがあります。「自動」はリスト内で最初に正常に動作するプラグインを使い、コンパイルに失敗したプラグインは状態付きで表示されますが選択できません。その下に内蔵の Displace フェーダー(Modifier 映像で入力映像を変位、0 でオフ)と、選択したプラグインが宣言したパラメータのフェーダーが並びます。使えるプラグインがない場合、station は映像をそのまま通過させます。

| Enable | プラグインモジュールを有効化:選択したプラグインが前のモジュールの出力を処理。プラグインが使えない場合は映像をそのまま通過 |
| RESET | プラグインのパラメータをデフォルトに戻し、すべての変調を切断。プラグインの選択は維持 |
| 自動(最初の利用可能なプラグイン) | リスト内で最初に正常に動作するプラグインを自動で使用 |
| Displace | Modifier 映像で入力映像を変位させる(0 でオフ) |
メタデータはファイル先頭の //! コメント行ブロックに記述します。api と name.en は必須。name.zh、name.ja、author、description、url、param 行は任意です。解析は //! コメントでない最初の行で停止します。プラグイン id はファイル名の小文字なので、ファイル名を変えると別のプラグインとして扱われます。
Contour Scanner パネル上部の操作行はプログラム全体に作用します。



| PRESET | SAVE は現在の全パラメータと MIDI 割り当てを現在のプロジェクトファイルに上書き保存します。プロジェクトファイルがまだない場合、またはファイルが移動された・書き込めない場合は、別名保存の画面が開きます。SAVE AS は名前を付けた .json ファイルに保存します。LOAD は .json ファイルを読み込みます。読み込みは現在の全パラメータと MIDI 割り当てを上書きするため、先に「上書き読込 / キャンセル」の確認が表示されます(Esc でもキャンセル可)。下の行には現在のプロジェクトファイル名、ない場合は「プロジェクトファイル未保存」が表示されます。最後に保存または読み込んだファイルが現在のプロジェクトファイルになります。 |
| PLUGINS | FOLDER でフォルダピッカーを開きプラグインフォルダを指定。DEFAULT で既定フォルダに戻ります。RESCAN はプラグインの追加・編集後に再スキャンします。2 行目に使用中のフォルダ、ない場合は「利用できるフォルダなし」と表示されます。 |
| OUTPUT + WINDOW | 出力ウィンドウを追加。出力ウィンドウ内:ウィンドウ枠をドラッグで切り抜き範囲を変更、映像上をドラッグで移動、ピンチまたは Ctrl+スクロールで拡大縮小、ダブルクリックでフルスクリーン切替、Shift+ダブルクリックで全体表示に戻す |
| メイン出力ウィンドウ | メイン出力ウィンドウ:画面をドラッグでウィンドウを移動、右下隅をドラッグでサイズ変更、ダブルクリックでフルスクリーン切替 |
| ビジュアル再起動 | ビジュアル再起動:メイン映像が固まったときにクリック。描画リソースを再構築し、カメラを再起動し、Minimalize の内部状態をリセットします |
| 説明書 | 公式サイトのオンライン説明書(madzine.work)を既定のブラウザで開く |
| Help (i) | Help モード切替:オンにすると、コントロールにカーソルを合わせたとき現在の言語の説明をカーソル横に表示。オフでは表示しません |
| 閉じる | このメッセージを閉じる |
プロジェクトファイルには、全モジュールの全パラメータ、MIDI 割り当て、ブラシマスク(描いた内容、モード、ブラシ設定)、各ウィンドウの位置・サイズ・フルスクリーン状態、選択中のモジュール、プレビュー切替、ヘルプモードのオン/オフが含まれます。LOAD はファイル内のすべてを適用します(言語、配色、オーディオデバイス、MIDI 出力、カメラ、出力ウィンドウ、プラグインフォルダを含む)。ウィンドウ位置が接続中のディスプレイ内にない場合は既定の位置に戻ります。MIDI 割り当てを含まない旧プロジェクトファイルを読み込んだ場合、現在の割り当ては変更されません。
保存されないもの:Slow Motion の録画済みフレーム。再起動後と LOAD 後、SIGNAL ウィンドウは常に閉じ、Stable Diffusion は常にオフになります。
LOAD がファイルを適用する前に、現在の設定が設定フォルダ(~/.visionmod)に app_state.backup-<数字>.json として自動でバックアップされます。直近 5 件のバックアップが保持され、バックアップは LOAD でそのまま開けます。新しいバージョンの Vision MOD で保存されたファイルは開けません。アプリの更新を促すメッセージが表示され、現在の設定はそのまま残ります。保存に成功すると、プロジェクトファイル名の行に「保存しました:」とファイル名が短時間表示されます。保存または読み込みに失敗した場合は、その行の下に理由付きのメッセージが表示されます。
トップバーの SIGNAL トグルでフローティングウィンドウを開きます。左列にプレビューと 7 本の CV メーター(Sequence 1 / 2、Movement、Color R / G / B / Saturation)。右列に Audio Inputs、CV Output、LFO があります。

プログラム起動時、SIGNAL ウィンドウは常に閉じた状態です。ウィンドウの位置とサイズは記憶されます。オーディオ入力または出力で None を選んだ場合、再起動後も None のままです。
| Module | CV Meter:映像から生成した 7 本のモジュレーション信号を表示(輪郭 SEQ 1/2、Movement、Color R/G/B/Sat) |
| Sequence 1 | SEQ1 シーケンス信号:輪郭上を動く走査点とアンカーの水平距離(0-10V、平滑済み)。塗りが現在の出力値 |
| Sequence 2 | SEQ2 シーケンス信号:輪郭上を動く走査点とアンカーの垂直距離(0-10V、平滑済み)。塗りが現在の出力値 |
| Movement | Movement エネルギー:最終出力画面のフレーム間輝度差の平均 ×Gain(0-10V、平滑済み) |
| Color Red | Modifier 映像の平均赤量(0-10V)。モジュレーションソース/CV 出力に使用可 |
| Color Green | Modifier 映像の平均緑量(0-10V)。モジュレーションソース/CV 出力に使用可 |
| Color Blue | Modifier 映像の平均青量(0-10V)。モジュレーションソース/CV 出力に使用可 |
| Color Saturation | Modifier 映像の平均彩度(HSV S、0-10V)。モジュレーションソース/CV 出力に使用可 |
| Module | Audio Inputs:8 トラックの音声入力レベル(RMS)をモジュレーションソースに |
| Device | オーディオ入出力デバイスの選択 |
| Channel | このトラックが入力デバイスのどのチャンネルを読むか |
| Meter | このトラックの入力レベルメーター(ピーク)。上端の色線は同番号の Chromascope チャンネル色に対応 |
Output ドロップダウンでオーディオ出力デバイスと MIDI 出力ポートをまとめて選択します。各ルートでソース信号、オーディオ出力チャンネル、MIDI CC 番号を選びます。
| Module | CV Output:モジュレーション信号をオーディオ出力チャンネル(ch3 以降)と MIDI デバイスへ送出 |
| Output | CV 信号の出力先:Audio Output でオーディオ出力デバイス、MIDI Output で MIDI 出力デバイスを選択。両方同時に使用可能。None を選ぶとその側には送出しません |
| Source | モジュレーション信号のルート元;オーディオ出力チャンネルと MIDI デバイス(ルートごとの CC#、14bit)へ同時に出力 |
| Ch | この CV 信号を音声出力デバイスのどのチャンネルへ送るか(MIDI 側は右の CC# で指定)。使用できるチャンネルは 3 からデバイスのチャンネル数まで。3 未満またはデバイスのチャンネル数を超えるルートは出力されません |
| CC | このルートの MIDI CC 番号(0-127)。14bit で送出(MSB=CC、LSB=CC+32)、CC>95 は 7bit に降格 |
| No output device | 出力デバイス未選択時、CV は音声出力チャンネルへ送出されません。走査とメーターは動作を続けます |
| LFO 1 to 4 | LFO:内蔵の低周波オシレーター 4 基。それぞれ波形とレートを設定でき、モジュレーションソースとして使えます |
| Waveform | LFO 波形:クリックで Sine/Triangle/Square/Saw を順に切替 |
| Rate | LFO レート(0.01–20 Hz):上下ドラッグで調整、ダブルクリックでキーボード入力 |
モジュレーション可能なフェーダーはラベル左に小さな点があります。左クリックで接続のオン/オフ、右クリックでポップアップを開き、グリッドから Source を 1 つ選んで Amount を設定します。Amount はバイポーラ(-1〜1、中心 0)で、ソースはパラメータをどちらの方向にも動かせます。各パラメータは 1 本の接続を保持します。


| Modulation dot | モジュレーションドット:左クリックでこのパラメータの変調を接続/切断(新規接続の量は 0)、右クリックでソースと量の設定を開く |
| Source | モジュレーションソース:このパラメータを変調する信号をクリックで選択 |
| Amount | モジュレーション量(-1〜1):0 で変調なし、負の値は反転。ダブルクリックで 0 に戻る |
| Sequence 1 / 2 | 輪郭スキャン信号。 |
| Audio Input 1 to 8 RMS | 8 トラックの音声入力レベル。 |
| Movement | 最終出力映像の動きエネルギー。 |
| Color Red / Green / Blue / Saturation | Modifier フレームの平均色。 |
| LFO 1 to 4 | SIGNAL ウィンドウで設定する内蔵 LFO。 |
MIDI 対応フェーダーは値の右にバインディング点があります。右クリックして MIDI Learn を選び、MIDI 機器のコントロールを動かすとバインドされ、点がアクセント色になります。同じメニューにバインド済みのチャンネルと CC が表示され、Clear Binding も選べます。コントロール待ちの間は、メニューに「MIDI Learn をキャンセル」も表示されます。学習対象は 7-bit Control Change のみです。モジュールを削除すると、そのモジュールのバインドも削除されます。MIDI 割り当てはプロジェクトファイルに保存され、LOAD は現在の割り当てをファイル内の割り当てに置き換えます。

| MIDI Learn | MIDI Learn:クリック後に MIDI コントローラーのノブやフェーダーを動かすと、次に受信した CC がこのパラメータに割り当てられる |
| Clear Binding | Clear Binding:このパラメータの MIDI 割り当てを解除 |
Mac App Store 版は、1 回限りの購入が完了するまで出力画面の中央に半透明の VISION MOD 透かしを表示します。購入行は PRESET の上にあります。

| 透かしを削除 | 一度の購入で出力画面の透かしを恒久的に削除します。価格は地域に応じて App Store が表示します。購入後は「購入済み:透かしは表示されません」と表示されます。購入が承認待ちの場合、承認されると自動的に透かしが消えます。 |
| 購入を復元 | 購入済みの場合(再インストールや別の Mac など)、同じ Apple アカウントで購入を復元します。再度課金されません。 |
| 旧設定をインポート | 旧 DMG 版で保存されたパラメータ、モジュール、MIDI 割り当て、プラグイン、配色(~/.visionmod と ~/.config/visionmod)をインポートします。開いたウィンドウでホームフォルダ、またはこの 2 つのフォルダのいずれかを選択します。インポートは現在の全パラメータと MIDI 割り当てを上書きするため、先に「上書きインポート / キャンセル」の確認が表示されます(Esc でもキャンセル可)。インポート前に現在の設定がバックアップされます。インポート後すぐに適用され、再起動は不要です。新しいバージョンの Vision MOD で保存された設定はインポートされません。 |