vvvv-editor-extensions

Extensions are standard VL patches saved with a .HDE.vl suffix. They run automatically when open in the editor.

File Naming

| Context | Required Name | |---|---| | Standalone extension | VL.MyExtension.HDE.vl | | Extension-only NuGet | VL.MyExtension.HDE (package ID) | | Mixed NuGet main doc | VL.MyPackage.vl | | Mixed NuGet extension doc | VL.MyPackage.HDE.vl |

Required NuGet References

• VL.HDE — provides Command node, window types, WindowFactory
• VL.Lang — provides API nodes under the Session category

Command Node

Registers a command in the editor menu:

| Pin | Purpose | |---|---| | Label | Menu text | | Visible | Show/hide the command | | Shortcut | Keyboard binding | | Output | Triggers (bang) on activation |

Multiple Command nodes can live in one .HDE.vl document.

Warning: A runtime error in one command may affect all others in the same document.

Window Types

| Type | Behavior | |---|---| | SkiaWindow | Slimmed-down Skia renderer window | | SkiaWindowTopMost | Always-on-top, no focus steal |

Docking

Wrap window with WindowFactory node. Connect WindowContext and Window pins.

Template: VL.HDE/Template.HDE.vl

API Access

Access hovered/selected nodes, read/write pins via VL.Lang Session category nodes. Browse available API in the HelpBrowser's API section.

Developer Shortcuts

• Shift+F9 — restarts all extensions simultaneously

Limitations

• Settings panel integration is not yet possible
• Extensions only run in the editor, not in exported applications