用途:帮助在 vvvv gamma 中集成 .NET 代码,包括 C# 插件项目配置、NuGet 包引用、库引用与打包。
主要能力:
- .csproj 配置:目标框架 net8.0(vvvv gamma 6+ 要求),输出路径指向 lib/net8.0/,AppendTargetFrameworkToOutputPath 设为 false。
- 两种 C# 集成工作流:源项目引用(vvvv 用 Roslyn 编译 .cs 并支持保存即热重载,无需 dotnet build);二进制引用(引用预编译 DLL 或 NuGet 包,需外部 dotnet build 并重启 vvvv)。.sdsl 着色器始终热重载。
- 必需全局 using:VL.Core、VL.Core.Import、VL.Lib.Collections;必需程序集属性 [assembly: ImportAsIs],否则节点不会出现在节点浏览器。
- NuGet 源配置与打包:nuget pack MyPlugin/deployment/MyPlugin.nuspec。
- 向量与 SIMD:内部热路径用 System.Numerics,外部 API 用 Stride.Core.Mathematics,二者可用 Unsafe.As 零成本转换。
- 资源管理:持有非托管资源的节点实现 IDisposable,vvvv 在节点移除或文档关闭时调用 Dispose()。
- 异步模式:Update() 在主线程 60 FPS 运行,长任务用 Task 异步处理。
- 可 blittable 结构体用于 GPU/网络边界;引用 vvvv 已加载 DLL 时用 <Private>false</Private>。
构建命令:dotnet build src/MyPlugin.csproj -c Release;dotnet build src/MyPlugin.sln -c Release;C++/CLI 用 msbuild MyCLIWrapper/MyCLIWrapper.vcxproj /p:Configuration=Release /p:Platform=x64(需 Visual Studio)。
适用场景:为 vvvv gamma 开发 C# 插件、封装原生库、集成 NuGet 包、处理 GPU/网络数据与异步加载。
限制:AI 代理无法看到 vvvv 编译器输出,需自行运行 dotnet build 验证;二进制引用工作流需用户重启 vvvv;C++/CLI 不能用 dotnet CLI 构建;COM 对象(DX11/DX12)需注意 ComPtr 泄漏与 ResizeBuffers 限制。