TiXL 整数值动画算子 AnimInt 全解析:参数、计算原理与实战用法
TiXL 整数值动画算子 AnimInt 全解析参数、计算原理与实战用法【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址: https://gitcode.com/GitHub_Trending/t3/t3AnimInt 是 TiXL 开源实时运动图形软件项目名 t3核心库见 Core/在Lib.numbers.anim.animators库中提供的整数动画算子用于将时间信号转换成不断增长的整数序列并可配合模运算生成循环计数、节拍触发等离散动画。读完本文你将掌握 AnimInt 全部输入输出参数、底层计算链路、BPM 速度因子SpeedFactor覆盖机制以及如何用它驱动进度计数、闪烁切换、随机抽帧等典型场景。本文基于 AnimInt.md 官方文档并结合源码 AnimInt.cs、符号定义 AnimInt.t3、界面布局 AnimInt.t3ui 以及动画数学工具类 AnimMath.cs、取模扩展 MathUtils.cs 展开深入讲解。一、算子概述AnimInt 是什么官方文档对 AnimInt 的定义只有一句话Animates an integer value.对一个整数值进行动画。它属于 Lib.numbers.anim.animators 算子库与AnimBoolean、AnimValue、AnimVec2、AnimVec3、TriggerAnim等构成 TiXL 的动画/定时算子家族负责把时间轴上的连续变化转译为离散的整数输出。从源码看AnimInt 的核心逻辑非常简洁把时间 × 速度因子 × Rate Phase向下取整为整数再根据 Modulo 参数决定是否取模。这意味着它天然适合生成第几帧 / 第几步的进度计数0、1、2、3…配合 Modulo 生成 0N 循环的离散状态如闪烁序号、轮播索引配合 WasHit 输出检测整数跳变的瞬间作为节拍脉冲或事件触发信号。与同库的 AnimValue.md输出连续的浮点 LFO 波形不同AnimInt 的输出是离散整数且默认已接入 BPM 节拍同步的倍速覆盖能力适合做音乐可视化VJ中的节拍计数与循环切换。二、输入参数详解AnimInt 共有 5 个输入参数文档中列出如下NameRelevancy TypeDescriptionModuloInt32—OverrideTimeSingle—RateSingle—PhaseSingle—AllowSpeedFactorInt32—文档只给出了参数名与类型描述留空。结合源码与符号文件下面给出每个参数的完整语义与默认值参数类型默认值来自 AnimInt.t3作用ModuloInt320对整数结果取模的除数。为 0 时输出不取模的原始计数非 0 时输出result.Mod(Modulo)把序列循环到 0(Modulo-1) 区间。取模实现见 MathUtils.cs对负数也做了修正保证结果为非负OverrideTimeSingle0.0覆盖内部时间源。默认情况下使用 EvaluationContext 的LocalFxTime本地 FX 时间一旦有输入连接则改用该输入提供的自定义时间RateSingle1.0速率/倍率。每单位时间整数递增的量默认 1 表示每秒按时间单位递增 1PhaseSingle0.0相位偏移。线性叠加在时间上用来整体平移整数序列的起点AllowSpeedFactorInt321速度因子开关。0None、1FactorA、2FactorB对应 AnimMath.cs 中的SpeedFactors枚举用于从 EvaluationContext 读取全局覆盖倍速在 AnimInt.t3ui 中Rate 参数的 UI 约束为Min-5.0, Max5.0且开启 ClampMin/ClampMax即图形界面中拖动 Rate 的可用范围被限制在[-5, 5]若需更大倍率可在数值上直接输入但会受钳制。默认值AllowSpeedFactor1FactorA意味着算子默认即响应外部速度因子 A 的覆盖——这正是与 AnimValue 一致的live VJ 中随时变速的设计。三、输出详解NameTypeResultSystem.Int32WasHitSystem.BooleanResult整数值动画结果即取整并可选取模后的整数。WasHit布尔命中信号。其判定逻辑在 AnimInt.csvar originalTime _normalizedTime; _normalizedTime (time) * rateFactorFromContext * rate phase; var result (int)_normalizedTime; var modulo Modulo.GetValue(context); Result.Value modulo ! 0 ? result.Mod(Modulo.GetValue(context)) : result; WasHit.Value (int)originalTime ! (int)_normalizedTime;即当本次更新的(int)_normalizedTime与上一次的整数值不同整数部分发生跳变时WasHit 为 true否则为 false。这是 AnimInt 最有用的输出之一——你不需要自己去比较前后两帧的 Result直接用 WasHit 就能拿到刚刚递增了一次的脉冲非常适合做节拍/步进触发器每递增一步输出一次 true闪烁节拍同步配合 Modulo2 时在 0/1 间跳变每次跳变 WasHit 触发。注意两个输出都注册了DirtyFlagTrigger DirtyFlagTrigger.Animated见 AnimInt.cs且共用一个Update回调保证一次更新同时刷新 Result 与 WasHit二者在同一帧内保持一致。四、计算原理与执行链路4.1 更新执行流程AnimInt 的完整计算流程AnimInt.cs帧去重若_lastUpdateFrame Playback.FrameCount则直接返回保证同一帧内不重复计算Playback.FrameCount来自 Playback.cs。读取参数取 Phase、Rate并通过AnimMath.GetSpeedOverrideFromContext(context, AllowSpeedFactor)读取速度因子倍率。确定时间源若OverrideTime.HasInputConnections为真用OverrideTime.GetValue(context)覆盖时间否则用context.LocalFxTime本地 FX 时间。随后清除 OverrideTime 的脏标记。计算归一化时间_normalizedTime time * rateFactorFromContext * rate phase。取整result (int)_normalizedTime向下取整。可选取模Modulo ! 0时Result result.Mod(Modulo)否则直接输出result。计算 WasHit比较前后两次的整数部分是否变化。4.2 取模的负数安全实现Result 取模走的是 MathUtils.cs 的扩展方法public static int Mod(this int val, int repeat) { if (repeat 0) return 0; var x val % repeat; if (x 0) x repeat x; return x; }该实现有两个关键点一是对除数 0 做了保护C# 中对 0 取模会抛异常而 AnimInt 在Modulo ! 0时才调用与这里形成双重保险二是对负数取模结果做了修正保证结果永远落在[0, repeat-1]因此即使相位/时间进入负区间循环计数也不会出现负索引——这在驱动数组下标、贴图帧索引时尤其重要。4.3 速度因子SpeedFactor覆盖机制AllowSpeedFactor参数映射到 AnimMath.cs 的枚举public enum SpeedFactors { None, // 0不响应任何速度覆盖 FactorA, // 1读取 context.FloatVariables[SpeedFactorA] FactorB, // 2读取 context.FloatVariables[SpeedFactorB] }GetSpeedOverrideFromContextAnimMath.cs会先对输入做Clamp(0, 枚举长度-1)防越界然后None倍率恒为 1FactorA/FactorB从context.FloatVariables字典中读取SpeedFactorA/SpeedFactorB若未设置则回退为 1。这套机制使得 AnimInt 可以与 TiXL 全局的 BPM 速度同步体系联动——外部如节拍同步算子、SetSpeedFactors 之类的工具把当前倍速写入 EvaluationContext 的 FloatVariables所有AllowSpeedFactorFactorA/B的动画算子便会同步变速非常适合 VJ 演出中跟着 BPM 整体加速/减速的场景。这也解释了为什么 AnimInt 与 AnimValue.md 都提供 AllowSpeedFactor 参数。五、典型使用场景场景 1循环步进计数进度 / 轮播索引将Modulo设为 NRate设为 1默认 FactorA 速度覆盖下Result 将输出 0, 1, 2, …, N-1, 0, 1, … 的循环序列可直接接入Step类输入或作为数组索引轮播。场景 2节拍触发脉冲WasHit保持 Modulo 任意值把WasHit接到需要每次递增触发一次的逻辑上如闪烁、换行、计数器复位。由于 WasHit 在整数跳变的当帧输出 true其频率与 Rate 成正比可通过调大 Rate 得到更快的事件流。场景 3抽帧/闪烁效果Modulo2设置Modulo 2Result 在 0/1 间交替可直接驱动闪烁同时 WasHit 在每个周期跳变点输出 true可用于同步其他效果。场景 4自定义时间源OverrideTime给OverrideTime接入自定义时间算子如 [time] 类算子即可让整数动画脱离本地 FX 时间、跟随录制时间或外部时钟推进当没有输入连接时OverrideTime 不生效自动回落到context.LocalFxTime。场景 5演奏中变速AllowSpeedFactor将AllowSpeedFactor设为 0None可让 AnimInt 完全不受全局变速影响作为绝对时间基准设为 1/2FactorA/FactorB则融入 BPM 同步的变速体系实现整组动画算子同步加速。六、相关算子与进一步阅读AnimInt 位于 Lib.numbers.anim.animators 算子族与该目录下其他文档配合使用更佳AnimBoolean.md布尔型动画触发器AnimValue.md连续浮点 LFO 波形与 AnimInt 的离散输出互补AnimVec2.md、AnimVec3.md二维/三维向量动画TriggerAnim.md布尔触发式动画SequenceAnim.md可视化步进序列器可直接消费 AnimInt 的整数输出。在代码层面AnimInt 的实现风格与 AnimValue 一脉相承同为 Instance 算子、相同的 AllowSpeedFactor 机制、相同的 WasHit 输出约定阅读时可相互对照其取模与速度因子底层逻辑则分别位于 MathUtils.cs 与 AnimMath.cs。七、总结AnimInt 是 TiXL 中把时间转译为整数的最小可用单元时间 × 速度因子 × Rate Phase 经向下取整得到整数计数再由 Modulo 决定是否循环WasHit 输出跳变脉冲。它参数少、逻辑透明、默认接入 BPM 变速体系是构建节拍同步计数、循环切换、离散状态机等实时图形的理想基础算子。结合本文对 AnimInt.cs 源码链路的解读你可以在 TiXL 图形编辑器中按需组合这些参数快速搭建属于自己的整数驱动动画。【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址: https://gitcode.com/GitHub_Trending/t3/t3创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

联想平板刷机全攻略:刷机包、救砖与降级实操指南

联想平板刷机全攻略:刷机包、救砖与降级实操指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/11/5 0:42:48 阅读更多 →
Slang 表达式求值类别详解:翻译期常量、运行时值与求值时机

Slang 表达式求值类别详解:翻译期常量、运行时值与求值时机

编译器图形学编程语言 【免费下载链接】slang Making it easier to work with shaders 项目地址: https://gitcode.com/GitHub_Trending/sl/slang 点击查看 免费下载 导读:在 Slang 着色器语言中,表达式的结果(value)…

2026/10/16 0:07:53 阅读更多 →
端点安全必修课:从USB外设管控到网络综合联动

端点安全必修课:从USB外设管控到网络综合联动

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/11 17:20:58 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/17 8:22:52 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/17 12:46:04 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/17 12:46:04 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/17 11:26:33 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/17 12:46:05 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/17 12:46:05 阅读更多 →

日新闻

周新闻

月新闻