SuperAPI AI 工具集

vvvv-spreads

编程与开发

查看项目

更新于 10-16 01:48

技能介绍

用途:帮助在 vvvv gamma 中正确使用 Spread<T> 不可变集合类型及其构建器 SpreadBuilder<T>,适用于处理 Spreads、SpreadBuilder 和集合相关代码的场景。

主要能力:说明 Spread<T> 的关键特性——不可变(不得原地修改,需新建)、值语义(元素相同即相等)、可视化补丁中支持循环索引(C# API 中不循环)、永不为 null(用 Spread<T>.Empty 代替);并给出创建、访问元素及常见 C# 模式的写法。

创建方式:主要用 SpreadBuilder(new SpreadBuilder<float>(expectedCount),循环 Add 后调用 ToSpread());也可用扩展方法 new int[]{1,2,3}.ToSpread()、静态工厂 Spread.Create(resultArray)、Spread<float>.Empty 以及单元素构建器。访问元素前须检查 Count,优先用 foreach 迭代以避免分配,或按索引循环。

常见模式:包括 Map(逐元素变换)、Filter(条件筛选)、Zip(按较长长度并配合取模处理两个 Spread)、Accumulate(累计求和),均以 SpreadBuilder 构建并返回 Spread<T>。

集合输入:节点需要计数或索引访问时用 IReadOnlyList<T>,仅需迭代时用 IEnumerable<T>;Spread<T> 因实现 IReadOnlyList<T> 可接入两者,而输入类型为 Spread<T> 会强制转换。输出保持 Spread<T>。

性能规则:已知数量时预分配 builder;热路径避免 LINQ(Where、Select、ToList 会产生隐藏分配);缓存未变化的 Spread 并直接返回引用;避免重复 ToSpread();大集合内部可考虑 Span<T>,在 API 边界转回 Spread;由于不可变,可用引用相等判断是否变化。ProcessNode 中可用 IReadOnlyList<float> 输入与缓存输出,仅在引用变化时重建。热路径输出可用 ReadOnlySpan<T> 实现零分配(如逐帧模拟数据)。

限制:资料未提供关于收费、价格、平台支持或具体安装步骤的信息。