Back to Details

vvvv-editor-extensions

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Editor Extensions

编辑器扩展

Extensions are standard VL patches saved with a 
.HDE.vl
suffix. They run automatically when open in the editor.
扩展是保存为
.HDE.vl
后缀的标准VL补丁。它们在编辑器中打开时会自动运行。

File Naming

文件命名规则

ContextRequired 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
场景要求的名称
独立扩展
VL.MyExtension.HDE.vl
仅包含扩展的NuGet
VL.MyExtension.HDE
（包ID）
混合NuGet主文档
VL.MyPackage.vl
混合NuGet扩展文档
VL.MyPackage.HDE.vl

Required NuGet References

必需的NuGet引用

  • VL.HDE — provides 
    Command
    node, window types, 
    WindowFactory
  • VL.Lang — provides API nodes under the 
    Session
    category
  • VL.HDE — 提供
    Command
    节点、窗口类型、
    WindowFactory
  • VL.Lang — 在
    Session
    分类下提供API节点

Command Node

Command节点

Registers a command in the editor menu:
PinPurpose
Label
Menu text
Visible
Show/hide the command
Shortcut
Keyboard binding
OutputTriggers (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.
在编辑器菜单中注册命令：
引脚用途
Label
菜单文本
Visible
显示/隐藏命令
Shortcut
键盘绑定
输出激活时触发（bang信号）
一个
.HDE.vl
文档中可以包含多个
Command
节点。
注意：单个命令中的运行时错误可能会影响同一文档中的其他所有命令。

Window Types

窗口类型

TypeBehavior
SkiaWindow
Slimmed-down Skia renderer window
SkiaWindowTopMost
Always-on-top, no focus steal
类型行为
SkiaWindow
轻量级Skia渲染器窗口
SkiaWindowTopMost
始终置顶，不会窃取焦点

Docking

停靠功能

Wrap window with 
WindowFactory
node. Connect 
WindowContext
and 
Window
pins.
Template: 
VL.HDE/Template.HDE.vl
使用
WindowFactory
节点包裹窗口。连接
WindowContext
和
Window
引脚。
模板：
VL.HDE/Template.HDE.vl

API Access

API访问

Access hovered/selected nodes, read/write pins via 
VL.Lang
Session
category nodes. Browse available API in the HelpBrowser's 
API
section.
通过
VL.Lang
的
Session
分类节点访问悬停/选中的节点，读取/写入引脚。可在HelpBrowser的
API
部分浏览可用API。

Developer Shortcuts

开发者快捷键

  • Shift+F9 — restarts all extensions simultaneously
  • Shift+F9 — 同时重启所有扩展

Limitations

限制

  • Settings panel integration is not yet possible
  • Extensions only run in the editor, not in exported applications
  • 暂不支持设置面板集成
  • 扩展仅在编辑器中运行，在导出的应用程序中不会运行