プラグインの導入・管理 ​

プラグインは、HarmoFlowに操作パネルや画像フィルターを追加する仕組みです。このページでは受け取ったファイルを使う手順を説明します。自分で作る場合はプラグインを作る、最初から使える色調補正・トーンカーブ・グラデーションマップは標準の調整機能へ進んでください。

まず、ファイルの種類を確認する ​

拡張子が同じ .lua でも、通常のスクリプトとプラグイン用の拡張は別です。 プラグインとして追加するLuaには、パネルを登録する hf.register_panel が必要です。通常のスクリプトを追加画面へ渡しても、期待したプラグインパネルにはなりません。

追加から起動まで ​

1. 上部の「プラグイン(P) → プラグインを追加・閲覧...」を開きます。
2. 「プラグインを追加...」から、配布された .lua または .dll を選びます。
3. ファイルをアプリ側の保存場所にコピーすると、読み込みが始まります。Lua拡張は、描画やほかの処理が終わってから登録されます。「追加しました」と表示されても、Lua拡張機能欄で登録結果を確認してください。
4. 上部の「プラグイン(P)」メニューをもう一度開き、登録された項目を選びます。追加・閲覧画面は管理用、起動はプラグインメニューからです。
5. 小さなテスト用シーンで処理結果を確認します。レイヤーを追加する拡張は、レイヤー一覧に意図した結果ができたかも見てください。

追加したファイルは次回起動時の読み込み対象になります。起動メニューに項目がない場合は、うまく読み込めないときへ進んでください。

現在の実装では、起動時に読み込みを試みるLuaファイルは、ファイル名順で先頭の16個までです。実行中に読み込める拡張は最大32個ですが、すべてを次回起動時にも使う場合は、extensions/ 直下の .lua ファイルを16個以内にしてください。

どこに保存される？ ​

自動追加では、HarmoFlowの実行ファイルと同じ場所にある次のフォルダーへ保存します。プロジェクトフォルダー内に置くものではありません。

HarmoFlowの実行ファイルがあるフォルダー/
├─ extensions/
│  └─ my_panel.lua
└─ plugins/
   └─ my_filter.dll

手動で配置する場合も同じです。起動時の検索対象は、それぞれのフォルダーの直下にあるファイルです。ZIPのまま置いたり、さらに深いサブフォルダーへ入れたりせず、小文字の .lua／.dll にしてください。追加画面からコピーすると拡張子は小文字に揃えられます。

同名ファイルを上書きする操作は、追加画面にはありません。既に同じ名前がある場合は、次の更新手順を使います。

更新・削除する ​

1. シーンを保存して、HarmoFlowを終了します。
2. Lua拡張は extensions/、DLLは plugins/ の対象ファイルを確認します。
3. 更新する場合は旧ファイルを別の場所へバックアップし、新しいファイルに置き換えます。使わなくなった場合は対象フォルダーの外へ移します。
4. HarmoFlowを再起動し、一覧の読み込み状態とメニュー項目を確認します。

実行中の再読み込み・アンロード・削除の専用操作はありません。同じDLLを再度読み込んだり、同じパネルIDのLua拡張を別名で追加したりしても、更新にはなりません。バックアップを .dll／.lua のまま同じフォルダーに残すと起動時の読み込み対象になるため、別の場所へ保管してください。

うまく読み込めないとき ​

不明なDLLを別のサイトから探して追加する前に、配布元の必要条件を確認してください。問題を報告するときは、HarmoFlowとプラグインのバージョン、ファイル名、表示されたエラー、追加した手順を添えると切り分けやすくなります。

次に読む ​

• プラグインを作る：Luaの最小例、DLLの構造、テスト
• 標準の調整機能：色調補正・トーンカーブ・グラデーションマップ
• 設定とLuaスクリプト