TiXL 算子解析CacheBoolean —— 用「提前计算好的布尔值」阻止重复更新【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址: https://gitcode.com/GitHub_Trending/t3/t3CacheBoolean 是 TiXL 实时运动图形库中一个看似不起眼、却非常实用的流程控制算子它并不重新计算布尔结果而是把早前已经计算出来的布尔值直接转发出去从而避免下游逻辑被多次触发或重复求值。本文以该算子的官方文档为骨架结合其在 Operators/Lib 中的真实实现为你讲清它的工作原理、使用方式与适用场景读完你就能在节点图中熟练使用它来优化布尔信号的传递。算子定位Lib.numbers.bool.process 下的布尔流程控制族CacheBoolean 归属于运算符库Lib.numbers.bool.process该命名空间下集中了四个用于处理布尔Boolean信号流程控制的算子彼此配合可以覆盖大多数“布尔状态传递、延迟、保持、缓存”的需求算子一句话说明CacheBoolean转发早前已计算出的布尔值防止多次更新DelayBoolean按帧数延迟布尔信号的传递DelayTriggerChange延迟布尔标志的变化延迟变 true / 延迟变 false / 双向延迟在 vvvv 中类似 MonoFlopKeepBoolean保持标志状态直到被重置以上清单可参见 Lib.numbers.bool.process 目录文档。核心功能与输出根据官方文档 CacheBoolean.md该算子的功能定义是Prevents multiple updates by forwarding a boolean value that was computed earlier.通过转发一个早前计算出的布尔值来阻止多次更新。即当某个布尔值在节点图中已经计算完毕、且结果在整个求值周期内不会改变时用 CacheBoolean 把这份“缓存好的结果”送往下游而不是让下游再去触发一遍计算链。输出Outputs文档中明确了该算子唯一的输出端口名称类型ResultSystem.Boolean在 CacheBoolean.t3 的符号定义中可以看到它的输入ValueId 为37e95081-96fb-4374-840f-3ecfee430181默认值为false即当输入没有连接任何上游时输出将保持为 false。源码级原理剖析它到底“缓存”了什么要真正理解 CacheBoolean 的价值需要看它在 CacheBoolean.cs 中的实现。该算子是一个继承自InstanceCacheBoolean的内部类拥有Guid(6502c40f-a38e-4bd9-8dbf-90e35079572d)的唯一标识其更新逻辑挂在输出插槽Result上[Output(Guid b0fa6fed-3478-493a-98b8-f4e680dc936e)] public readonly Slotbool Result new(); public CacheBoolean() { Result.UpdateAction Update; } private void Update(EvaluationContext context) { if (!Value.HasInputConnections) { Result.Value Value.GetValue(context); return; } if (Value.TryGetFirstConnection(out var connection) connection is Slotbool boolValue) { Result.Value boolValue.Value; } } [Input(Guid 37e95081-96fb-4374-840f-3ecfee430181)] public readonly InputSlotbool Value new();这段代码揭示了它的两条执行分支无输入连接走参数默认值当Value没有挂接任何上游连接时算子直接读取输入插槽当前的值即用户在参数面板中设定的值或默认值false作为输出。有输入连接转发缓存结果当Value连接了上游时算子取出第一个连接对应的Slotbool直接读取其.Value并赋值给Result。注意这里读取的是上游插槽已经计算好的Value而不会再去重新执行上游的整条求值链——这就是文档所说“转发早前计算出的布尔值”的本质。从源码结构还可以推断出另一个设计意图这个算子不持有任何内部状态变量没有_cachedValue之类的字段它的“缓存”体现在求值时序上——在 TiXL 的插槽Slot求值机制中只有当输出被下游请求且脏标记DirtyFlag判定为需要更新时UpdateAction才会被触发。因此CacheBoolean 实际起到的是屏障与快照作用让同一份布尔结果在单帧内被稳定地、原样地多次引用而不触发重复计算。关于插槽求值机制的更多底层细节可以参考 InputSlot.cs输入插槽的InputUpdate会依据是否为默认值来决定读取TypedDefaultValue还是TypedInputValue而GetCurrentValue()在“存在输入连接”或“该插槽被动画驱动”时才返回Value否则返回TypedInputValue.Value。何时使用 CacheBoolean场景与边界结合文档定义与实现CacheBoolean 的典型使用场景包括打断长求值链当一个昂贵的布尔计算结果会被多个下游分支消费时在其后插入 CacheBoolean可以确保下游只消费“已算好的结果”而不会各自再去触发重复计算。稳定单帧内的信号实时图形渲染中同一帧内布尔信号的抖动可能造成视觉闪烁或逻辑误触发通过 CacheBoolean 转发的值在同一帧内是稳定一致的。手动快照布尔值把某一时刻的布尔判定结果“钉”在节点图上后续逻辑基于该快照而非实时信号工作。同时也要注意它的边界CacheBoolean不做延迟那是 DelayBoolean.cs 的职责它通过FrameCount参数与队列机制按帧延迟信号、不做状态保持那是 KeepBoolean.cs 的职责它通过Freeze输入冻结当前值并输出TimeSinceFreeze、不做变化延迟那是 DelayTriggerChange.cs 的职责它支持DelayTrue/DelayFalse/DelayBoth三种模式并输出RemainingTime。选择哪个算子取决于你是要“复用结果”“推迟变化”还是“锁存状态”。实践建议在 Graph 编辑器中通过搜索CacheBoolean即可将该算子加入节点图它位于Lib.numbers.bool.process分类下输入Value、输出Result均为bool类型。当输入未连接时请留意默认值false避免因遗漏连接而输出非预期结果。与同族的 DelayBoolean、DelayTriggerChange、KeepBoolean 组合使用可以构建出完整的布尔信号处理管线例如“实时判定 → 缓存快照 → 延迟输出 → 冻结保持”的典型链路。相关资源算子文档CacheBoolean.md分类目录文档Lib.numbers.bool.process源码实现CacheBoolean.cs符号定义CacheBoolean.t3同族算子 DelayBoolean.cs、 DelayTriggerChange.cs、 KeepBoolean.cs底层插槽机制InputSlot.cs【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址: https://gitcode.com/GitHub_Trending/t3/t3创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 TiXL 算子解析：CacheBoolean —— 用「提前计算好的布尔值」阻止重复更新
TiXL 算子解析CacheBoolean —— 用「提前计算好的布尔值」阻止重复更新【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址: https://gitcode.com/GitHub_Trending/t3/t3CacheBoolean 是 TiXL 实时运动图形库中一个看似不起眼、却非常实用的流程控制算子它并不重新计算布尔结果而是把早前已经计算出来的布尔值直接转发出去从而避免下游逻辑被多次触发或重复求值。本文以该算子的官方文档为骨架结合其在 Operators/Lib 中的真实实现为你讲清它的工作原理、使用方式与适用场景读完你就能在节点图中熟练使用它来优化布尔信号的传递。算子定位Lib.numbers.bool.process 下的布尔流程控制族CacheBoolean 归属于运算符库Lib.numbers.bool.process该命名空间下集中了四个用于处理布尔Boolean信号流程控制的算子彼此配合可以覆盖大多数“布尔状态传递、延迟、保持、缓存”的需求算子一句话说明CacheBoolean转发早前已计算出的布尔值防止多次更新DelayBoolean按帧数延迟布尔信号的传递DelayTriggerChange延迟布尔标志的变化延迟变 true / 延迟变 false / 双向延迟在 vvvv 中类似 MonoFlopKeepBoolean保持标志状态直到被重置以上清单可参见 Lib.numbers.bool.process 目录文档。核心功能与输出根据官方文档 CacheBoolean.md该算子的功能定义是Prevents multiple updates by forwarding a boolean value that was computed earlier.通过转发一个早前计算出的布尔值来阻止多次更新。即当某个布尔值在节点图中已经计算完毕、且结果在整个求值周期内不会改变时用 CacheBoolean 把这份“缓存好的结果”送往下游而不是让下游再去触发一遍计算链。输出Outputs文档中明确了该算子唯一的输出端口名称类型ResultSystem.Boolean在 CacheBoolean.t3 的符号定义中可以看到它的输入ValueId 为37e95081-96fb-4374-840f-3ecfee430181默认值为false即当输入没有连接任何上游时输出将保持为 false。源码级原理剖析它到底“缓存”了什么要真正理解 CacheBoolean 的价值需要看它在 CacheBoolean.cs 中的实现。该算子是一个继承自InstanceCacheBoolean的内部类拥有Guid(6502c40f-a38e-4bd9-8dbf-90e35079572d)的唯一标识其更新逻辑挂在输出插槽Result上[Output(Guid b0fa6fed-3478-493a-98b8-f4e680dc936e)] public readonly Slotbool Result new(); public CacheBoolean() { Result.UpdateAction Update; } private void Update(EvaluationContext context) { if (!Value.HasInputConnections) { Result.Value Value.GetValue(context); return; } if (Value.TryGetFirstConnection(out var connection) connection is Slotbool boolValue) { Result.Value boolValue.Value; } } [Input(Guid 37e95081-96fb-4374-840f-3ecfee430181)] public readonly InputSlotbool Value new();这段代码揭示了它的两条执行分支无输入连接走参数默认值当Value没有挂接任何上游连接时算子直接读取输入插槽当前的值即用户在参数面板中设定的值或默认值false作为输出。有输入连接转发缓存结果当Value连接了上游时算子取出第一个连接对应的Slotbool直接读取其.Value并赋值给Result。注意这里读取的是上游插槽已经计算好的Value而不会再去重新执行上游的整条求值链——这就是文档所说“转发早前计算出的布尔值”的本质。从源码结构还可以推断出另一个设计意图这个算子不持有任何内部状态变量没有_cachedValue之类的字段它的“缓存”体现在求值时序上——在 TiXL 的插槽Slot求值机制中只有当输出被下游请求且脏标记DirtyFlag判定为需要更新时UpdateAction才会被触发。因此CacheBoolean 实际起到的是屏障与快照作用让同一份布尔结果在单帧内被稳定地、原样地多次引用而不触发重复计算。关于插槽求值机制的更多底层细节可以参考 InputSlot.cs输入插槽的InputUpdate会依据是否为默认值来决定读取TypedDefaultValue还是TypedInputValue而GetCurrentValue()在“存在输入连接”或“该插槽被动画驱动”时才返回Value否则返回TypedInputValue.Value。何时使用 CacheBoolean场景与边界结合文档定义与实现CacheBoolean 的典型使用场景包括打断长求值链当一个昂贵的布尔计算结果会被多个下游分支消费时在其后插入 CacheBoolean可以确保下游只消费“已算好的结果”而不会各自再去触发重复计算。稳定单帧内的信号实时图形渲染中同一帧内布尔信号的抖动可能造成视觉闪烁或逻辑误触发通过 CacheBoolean 转发的值在同一帧内是稳定一致的。手动快照布尔值把某一时刻的布尔判定结果“钉”在节点图上后续逻辑基于该快照而非实时信号工作。同时也要注意它的边界CacheBoolean不做延迟那是 DelayBoolean.cs 的职责它通过FrameCount参数与队列机制按帧延迟信号、不做状态保持那是 KeepBoolean.cs 的职责它通过Freeze输入冻结当前值并输出TimeSinceFreeze、不做变化延迟那是 DelayTriggerChange.cs 的职责它支持DelayTrue/DelayFalse/DelayBoth三种模式并输出RemainingTime。选择哪个算子取决于你是要“复用结果”“推迟变化”还是“锁存状态”。实践建议在 Graph 编辑器中通过搜索CacheBoolean即可将该算子加入节点图它位于Lib.numbers.bool.process分类下输入Value、输出Result均为bool类型。当输入未连接时请留意默认值false避免因遗漏连接而输出非预期结果。与同族的 DelayBoolean、DelayTriggerChange、KeepBoolean 组合使用可以构建出完整的布尔信号处理管线例如“实时判定 → 缓存快照 → 延迟输出 → 冻结保持”的典型链路。相关资源算子文档CacheBoolean.md分类目录文档Lib.numbers.bool.process源码实现CacheBoolean.cs符号定义CacheBoolean.t3同族算子 DelayBoolean.cs、 DelayTriggerChange.cs、 KeepBoolean.cs底层插槽机制InputSlot.cs【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址: https://gitcode.com/GitHub_Trending/t3/t3创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考