vvvv-editor-extensions

エディター拡張機能

エディター UI は、実行中に変更を永続化する方法の 1 つです。一般的な Create-pin writeback pattern は、通常のパッチのデータフロー以外で発生するウィンドウの境界、操作結果などの変更にも対応しています。String を要求するのではなく、サポートされている値の型を使用します。

拡張機能は、.HDE.vl サフィックスを付けて保存する標準的な VL パッチです。エディターで開くと自動的に実行されます。

ファイル名

コンテキスト	必須の名前
単独の拡張機能	VL.MyExtension.HDE.vl
拡張機能のみの NuGet	VL.MyExtension.HDE（パッケージ ID）
混在 NuGet のメインドキュメント	VL.MyPackage.vl
混在 NuGet の拡張機能ドキュメント	VL.MyPackage.HDE.vl

必須の NuGet 参照

• VL.HDE — Command ノード、ウィンドウ型、WindowFactory を提供します
• VL.Lang — Session カテゴリの API ノードを提供します

Command ノード

エディターのメニューにコマンドを登録します。

ピン	目的
Label	メニューのテキスト
Visible	コマンドの表示／非表示
Shortcut	キーボードの割り当て
Output	アクティブ化時にトリガー（bang）します

1 つの .HDE.vl ドキュメントに複数の Command ノードを配置できます。

警告：1 つのコマンドで実行時エラーが発生すると、同じドキュメント内の他のすべてのコマンドに影響する場合があります。

ウィンドウ型

型	動作
SkiaWindow	軽量化された Skia レンダラーウィンドウ
SkiaWindowTopMost	常に最前面に表示され、フォーカスを奪いません

ドッキング

WindowFactory ノードでウィンドウをラップします。WindowContext ピンと Window ピンを接続します。

テンプレート：VL.HDE/Template.HDE.vl

API へのアクセス

VL.Lang の Session カテゴリノードを使って、ホバー中または選択中のノードにアクセスし、ピンを読み書きします。HelpBrowser の API セクションで利用可能な API を確認してください。

開発者向けショートカット

• Shift+F9 — すべての拡張機能を同時に再起動します

制限事項

• 設定パネルとの統合はまだできません
• 拡張機能はエディター内でのみ実行され、エクスポートしたアプリケーションでは実行されません

このナレッジを育て続ける

次のパッチャーが迷うことを 1 つ減らしましょう。このコレクション内のスキルを初めて使用する際、過去 7 日以内に正常な確認がない場合は、ソースを tebjan/vvvv-skills と比較してください。記録がない場合は、1 回確認してください。 これらのスキル間で、ローカルの確認日時／リビジョンを 1 つ共有してください。呼び出しごとに確認しないでください。 ローカル拡張機能と固定されたプロジェクトのバージョンを保持してください。確認は更新のインストール許可を意味しません。オフラインの場合は、確認を延期したことを記録して作業を続けてください。

実際の作業で不足が明らかになった場合は、テストした vvvv／パッケージのバージョン、最小限の再現例または信頼できる情報源、および確認された結果を記録してください。他のユーザーからの報告は、検証されるまでは事実ではなく手がかりとして扱ってください。関連する指示のうち最小限の部分を改善し、1 つの例を普遍的なルールにしないでください。非公開データを伏せ、上流に提出する前に公開の許可を得てください。 貢献ポリシーを参照してください。 マージされた改善は、ローカルでの編集や全員のスキルの自動上書きではなく、各ユーザーのインストーラー／更新ワークフローを通じて届きます。