Launching vvvv gamma
Filesystem Paths
| Location | Path |
|---|
| Install directory | INLINECODE0 |
| User data (AppData) |
%LOCALAPPDATA%\vvvv\gamma\ |
| Documents root |
%USERPROFILE%\Documents\vvvv\gamma\ |
| Sketches |
%USERPROFILE%\Documents\vvvv\gamma\Sketches |
| Exports |
%USERPROFILE%\Documents\vvvv\gamma\Exports |
| User packages |
%LOCALAPPDATA%\vvvv\gamma\nugets |
| Log file (when enabled) |
%USERPROFILE%\Documents\vvvv\gamma\vvvv.log |
Preview builds use gamma-preview instead of gamma in the above paths.
Normal Launch
CODEBLOCK0
Package Repositories and Editable Packages
These two arguments work together and are the most important for development:
- -
--package-repositories tells vvvv where to look for packages. Provide the parent folder of each package (the folder containing the package directory, not the package directory itself). --editable-packages tells vvvv which packages from those repositories to load from source instead of pre-compiled cache (read-only). Glob patterns are supported.
You must use both together when working on a package from source:
CODEBLOCK1
Without --package-repositories, vvvv won't find your local package sources, and --editable-packages will have no effect.
Common Argument Combinations
CODEBLOCK2
For the complete argument reference, see cli-reference.md.
Detecting vvvv Installations
To find vvvv programmatically:
- 1. Windows Registry: Enumerate
HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall for subkeys starting with vvvv_gamma_. Read the InstallLocation value. - Default path: Scan
C:\Program Files\vvvv\ for directories matching vvvv_gamma_*. - Version parsing: Extract version from directory name format
vvvv_gamma_MAJOR.MINOR[-PREVIEW-HASH-PLATFORM]. - Filtering: Exclude
-beta, -alpha, -rc, -test, -dev, etc. variants if not explicitly requested. - Selection: Sort by major DESC, minor DESC, preview number DESC. Pick the latest and ask the user if that or another one should be used.
The executable is at <install-dir>\vvvv.exe.
启动 vvvv gamma
文件系统路径
| 位置 | 路径 |
|---|
| 安装目录 | C:\Program Files\vvvv\vvvvgammaX.Y-win-x64\ |
| 用户数据 (AppData) |
%LOCALAPPDATA%\vvvv\gamma\ |
| 文档根目录 | %USERPROFILE%\Documents\vvvv\gamma\ |
| 草图文件夹 | %USERPROFILE%\Documents\vvvv\gamma\Sketches |
| 导出文件夹 | %USERPROFILE%\Documents\vvvv\gamma\Exports |
| 用户包 | %LOCALAPPDATA%\vvvv\gamma\nugets |
| 日志文件（启用时） | %USERPROFILE%\Documents\vvvv\gamma\vvvv.log |
预览版本在上述路径中使用 gamma-preview 代替 gamma。
正常启动
shell
启动 vvvv（打开默认空白补丁）
C:\Program Files\vvvv\vvvv
gamma7.0-win-x64\vvvv.exe
打开特定补丁
vvvv.exe MyProject.vl
打开多个文件
vvvv.exe --open FileA.vl;FileB.vl
包仓库和可编辑包
这两个参数协同工作，对开发最为重要：
- - --package-repositories 告诉 vvvv 在哪里查找包。提供每个包的父文件夹（包含包目录的文件夹，而非包目录本身）。
- --editable-packages 告诉 vvvv 从这些仓库中加载哪些包的源代码而非预编译缓存（只读）。支持通配符模式。
当从源代码处理包时，必须同时使用这两个参数：
shell
给定以下文件夹结构：
D:\Projects\
VL.MyLib\ <-- 包
VL.MyLib.vl
VL.MyOtherLib\ <-- 另一个包
VL.MyOtherLib.vl
父文件夹 D:\Projects 即为包仓库
vvvv.exe --package-repositories D:\Projects --editable-packages VL.MyLib* --debug
多个仓库（分号分隔）
vvvv.exe --package-repositories D:\Projects;D:\SharedLibs --editable-packages VL.MyLib*;VL.SharedUtils --debug
打开特定帮助补丁进行测试
vvvv.exe --package-repositories D:\Projects --editable-packages VL.MyLib* -o D:\Projects\VL.MyLib\help\HowTo Use Feature.vl --debug
没有 --package-repositories，vvvv 将找不到本地包源，--editable-packages 也将无效。
常用参数组合
shell
开发：调试符号 + 允许多个实例
vvvv.exe MyProject.vl --debug --allowmultiple
故障排除：跳过缓存，启用日志
vvvv.exe MyProject.vl --nocache --log
最小启动：无扩展，无后端（快速启动用于补丁编辑）
vvvv.exe --noextensions --disable-backend
启动时暂停（运行时不会启动，直到您按下播放键）
vvvv.exe MyProject.vl --stoppedonstartup
跳过启动画面
vvvv.exe --no-splash
完整的参数参考，请参见 cli-reference.md。
检测 vvvv 安装
要以编程方式查找 vvvv：
- 1. Windows 注册表：枚举 HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall 中以 vvvvgamma 开头的子项。读取 InstallLocation 值。
- 默认路径：扫描 C:\Program Files\vvvv\ 中匹配 vvvvgamma* 的目录。
- 版本解析：从目录名称格式 vvvvgammaMAJOR.MINOR[-PREVIEW-HASH-PLATFORM] 中提取版本。
- 过滤：除非明确要求，否则排除 -beta、-alpha、-rc、-test、-dev 等变体。
- 选择：按主版本号降序、次版本号降序、预览号降序排序。选择最新版本并询问用户是否使用该版本或其他版本。
可执行文件位于 \vvvv.exe。
