Back to Details

vvvv-startup

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Launching vvvv gamma

启动vvvv gamma

Filesystem Paths

文件系统路径

LocationPath
Install directory
C:\Program Files\vvvv\vvvv_gamma_X.Y-win-x64\
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.
位置路径
安装目录
C:\Program Files\vvvv\vvvv_gamma_X.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
。

Normal Launch

常规启动

shell
undefined
shell
undefined

Launch vvvv (opens with default empty patch)

启动vvvv（打开默认空补丁）

"C:\Program Files\vvvv\vvvv_gamma_7.0-win-x64\vvvv.exe"
"C:\Program Files\vvvv\vvvv_gamma_7.0-win-x64\vvvv.exe"

Open a specific patch

打开特定补丁

vvvv.exe MyProject.vl
vvvv.exe MyProject.vl

Open multiple files

打开多个文件

vvvv.exe --open "FileA.vl;FileB.vl"
undefined
vvvv.exe --open "FileA.vl;FileB.vl"
undefined

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:
shell
undefined
以下两个参数配合使用，是开发过程中最重要的设置：
  • --package-repositories
    ：指定vvvv查找包的位置。需提供每个包的父文件夹（包含包目录的文件夹，而非包目录本身）。
  • --editable-packages
    ：指定vvvv从源码而非预编译缓存（只读）加载仓库中的哪些包。支持通配符模式。
当从源码开发包时，必须同时使用这两个参数：
shell
undefined

Given this folder structure:

假设文件夹结构如下：

D:\Projects\

D:\Projects\

VL.MyLib\ <-- the package

VL.MyLib\ <-- 包

VL.MyLib.vl

VL.MyLib.vl

VL.MyOtherLib\ <-- another package

VL.MyOtherLib\ <-- 另一个包

VL.MyOtherLib.vl

VL.MyOtherLib.vl

The parent folder "D:\Projects" is the package repository

父文件夹 "D:\Projects" 是包仓库

vvvv.exe --package-repositories "D:\Projects" --editable-packages "VL.MyLib*" --debug
vvvv.exe --package-repositories "D:\Projects" --editable-packages "VL.MyLib*" --debug

Multiple repositories (semi-colon separated)

多个仓库（分号分隔）

vvvv.exe --package-repositories "D:\Projects;D:\SharedLibs" --editable-packages "VL.MyLib*;VL.SharedUtils" --debug
vvvv.exe --package-repositories "D:\Projects;D:\SharedLibs" --editable-packages "VL.MyLib*;VL.SharedUtils" --debug

Open a specific help patch for testing

打开特定帮助补丁进行测试

vvvv.exe --package-repositories "D:\Projects" --editable-packages "VL.MyLib*" -o "D:\Projects\VL.MyLib\help\HowTo Use Feature.vl" --debug

Without `--package-repositories`, vvvv won't find your local package sources, and `--editable-packages` will have no effect.
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`也不会生效。

Common Argument Combinations

常用参数组合

shell
undefined
shell
undefined

Development: debug symbols + allow multiple instances

开发模式：调试符号 + 允许多实例

vvvv.exe MyProject.vl --debug --allowmultiple
vvvv.exe MyProject.vl --debug --allowmultiple

Troubleshooting: skip cache, enable logging

故障排查：跳过缓存，启用日志

vvvv.exe MyProject.vl --nocache --log
vvvv.exe MyProject.vl --nocache --log

Minimal startup: no extensions, no backend (fast launch for patch editing)

极简启动：无扩展，无后端（快速启动用于补丁编辑）

vvvv.exe --noextensions --disable-backend
vvvv.exe --noextensions --disable-backend

Paused on startup (runtime won't start until you press play)

启动时暂停（运行时需按下播放键才会启动）

vvvv.exe MyProject.vl --stoppedonstartup
vvvv.exe MyProject.vl --stoppedonstartup

Skip splash screen

跳过启动画面

vvvv.exe --no-splash

For the complete argument reference, see [cli-reference.md](cli-reference.md).
vvvv.exe --no-splash

完整参数参考请见 [cli-reference.md](cli-reference.md)。

Detecting vvvv Installations

检测vvvv安装

To find vvvv programmatically:
  1. Windows Registry: Enumerate 
    HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall
    for subkeys starting with 
    vvvv_gamma_
    . Read the 
    InstallLocation
    value.
  2. Default path: Scan 
    C:\Program Files\vvvv\
    for directories matching 
    vvvv_gamma_*
    .
  3. Version parsing: Extract version from directory name format 
    vvvv_gamma_MAJOR.MINOR[-PREVIEW-HASH-PLATFORM]
    .
  4. Filtering: Exclude 
    -beta
    , 
    -alpha
    , 
    -rc
    , 
    -test
    , 
    -dev
    , etc. variants if not explicitly requested.
  5. 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的步骤：
  1. Windows注册表：枚举
    HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall
    下以
    vvvv_gamma_
    开头的子项，读取
    InstallLocation
    值。
  2. 默认路径：扫描
    C:\Program Files\vvvv\
    下匹配
    vvvv_gamma_*
    的目录。
  3. 版本解析：从目录名格式
    vvvv_gamma_MAJOR.MINOR[-PREVIEW-HASH-PLATFORM]
    中提取版本。
  4. 过滤：如果未明确要求，排除
    -beta
    、
    -alpha
    、
    -rc
    、
    -test
    、
    -dev
    等变体。
  5. 选择：按主版本降序、次版本降序、预览版编号降序排序。选择最新版本，或询问用户使用该版本还是其他版本。
可执行文件位于
<安装目录>\vvvv.exe
。