TiXL（t3）项目设置（Project Settings）完全指南：Timing、Audio、Proxies、Recording 与 Export 配置详解

TiXLt3项目设置Project Settings完全指南Timing、Audio、Proxies、Recording 与 Export 配置详解【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址: https://gitcode.com/GitHub_Trending/t3/t3TiXL仓库代号 t3是一款开源实时动态图形创作软件。Project Settings项目设置是与合成composition一起随身携带的每项目配置面板涵盖 Timing时间与节拍、Audio音频、Video Proxies视频代理、Recording录制与 Export导出五大部分。本文以该面板为核心逐项讲解每个配置项的用途、参数语义与默认值并结合仓库源码CompositionSettings.cs、BarPhaseTracker.cs、AudioReaction.cs 等说明这些配置在引擎底层的落点读完即可独立完成一个实时演出或可复现动画项目的完整配置。项目设置的继承模型设置住在合成上项目设置的第一个核心概念是继承设置保存在合成composition上并被其内部的一切内容继承。面板顶部的复选框原文为Specify settings for …决定当前合成是自定义自己的设置还是从父级合成继承。取消勾选即回退到继承勾选则写出一份属于自己的设置。从源码看这套机制对应CompositionSettings类它被序列化进.t3符号文件中键名为ProjectSettings旧项目兼容PlaybackSettings旧键名并通过面包屑式遍历沿图表层级向上查找最终由Animation.Playback.Current?.Settings ?? CompositionSettings.Defaults提供当前生效值见 CompositionSettings.cs。也就是说任何运行中的合成在任何时刻都有一个当前生效的项目设置未启用设置的合成自动落到全局默认值上。Defaults中的默认值BPM120、Resync Threshold0.04s、ProRes 代理、1920×1080 等在 CompositionSettings.cs 中一一可见。Timing项目如何运行、时间如何计量Project Setup动画型 vs 现场型Project Setup决定项目整体运行方式二选一Animation—— 面向可复现的、时间轴驱动的作品有已知时长、有关键帧动画。Live / Interactive—— 面向现场演出VJ set、装置艺术等实时交互场景。两种模式共用同一套时间底座差别主要在同步与交互能力上见下文 Sync Mode。BPM一切时间都以小节为单位TiXL 的一个关键设计是所有时间都以音乐小节musical bars而非秒运行因此BPM直接控制整个项目的动画速度——把 BPM 调准能让程序化动画严格锁定在节拍上。播放引擎侧BpmProvider以单例形式存在编辑器每帧轮询TryGetNewBpmRate(out float bpm)获取新的 BPM 值并触发节拍更新见 BpmProvider.cs配置侧PlaybackConfig.Bpm默认 120序列化字段名即Playback.Bpm。Timeline Display则只影响时间轴标尺ruler的显示单位Bar小节、Seconds秒或 Frames帧三选一属于显示层偏好不改动底层数据。On BPM Change改 BPM 时对剪辑与关键帧做什么修改 BPM 时项目里已有的剪辑clip和关键帧有两种处置方式Stretch with Beat默认—— 保留它们的小节数值不动于是所有内容随节拍一起变快或变慢。适合音乐驱动的作品。Keep Seconds—— 重缩放本合成的剪辑位置、关键帧和循环范围让它们停留在相同的秒数上只有网格grid移动。适用于BPM 当初测错了需要修正或这是一个叙事剪辑而非音乐剪辑的场景。两个重要边界原文明确嵌套合成永远不会被重缩放——因为它们可能在其他地方被复用视频/音频的修剪trims在两种模式下都以秒为单位所以内容本体永远不会位移。无论哪种模式一次 BPM 编辑都只算一个撤销步骤。源码中两种模式对应枚举BpmChangeModes { StretchWithBeat, KeepSeconds }见 CompositionSettings.cs。Sync Mode仅 Live / Interactive 模式现场模式下可选的时钟源Timeline—— 项目仍跑在自己的时间轴上使用固定的 BPM 速率。Tapping—— 每拍敲一下 Sync 按钮或热键实时设定速度。配合audio beat lock音频节拍锁定编辑器会监听音频输入中的瞬态transients持续微调播放速度以咬合到来的节拍。关于节拍锁定源码提供了比文档更细的两条分析路径枚举BeatLockSources见 CompositionSettings.csOnset Detection瞬态检测——跟随瞬态/起音需要一次敲击重同步来找到小节起点Phase Model相位模型——使用神经网络DanceAi 的 bar-phase 模型自主找速度和起始拍并回报置信度ExpectedPhaseError值越低越自信。实现见 BarPhaseTracker.cs模型文件位于可执行文件旁的dance-phase/目录本仓库见 Dependencies/dance-phase捕获回调只做降混与重采样入队推理每 16ms 音频约 4ms跑在独立后台线程上绝不阻塞音频驱动锁相逻辑通过 BPM 微调渐进修正slew播放永不跳变。Beat Sync Offset微调相位偏移——当视频处理设备让画面输出延迟时用它把节拍相位往前挪来补偿。对应字段BeatLockAudioOffsetSec默认 0 秒另有BeatLockSmoothing0紧贴模型、抖动快1信任运行节奏、平滑但响应慢默认 0.5可在面板中调节。Audio主音量、音频分析与反应性Main Volume设置项目整体音频输出电平源码中对应AudioMixConfig.SoundtrackVolume/OperatorVolume等混音参数的总体表现。Resync Threshold重同步阈值控制音频播放相对动画允许漂移多大才触发重同步——文档给出正常区间0.02–0.05 秒源码默认值AudioResyncThreshold 0.04f见 CompositionSettings.cs。Audio Analysis and Reactivity驱动音频反应型算子这一节配置驱动 AudioReaction 这类音频反应型算子的信号Input Device输入设备——留空则使用机器的默认设备该选择按机器存储AudioInputDeviceName字段因此共享项目在任意机器上都能正常工作。面板上显示为 Default Audio Input。Gain增益——补偿各设备不一的输入电平源码字段AudioGainFactor默认 1。Decay衰减——塑造反应回落的速度源码字段AudioDecayFactor默认 0.90.9 意味着较快的回落。电平表level meter——显示的是经过增益之后的输入信号。反应型算子底层消费的是统一的音频分析数据AudioReaction.cs 提供Level、WasHit、HitCount输出以及一个可插入音频图的ResultAudioGraphNode通道——把它插在某个 [AudioBus] 之前就能只对那一部分音源做反应而不是整个混音。分析侧的 FFT 与频段参数在 AudioConfig.cs 中以编译期常量定义FFT 缓冲 1024、32 个频段、低频/高频分离截至 250Hz/2000Hz 等说明音频分析管线是预分配的、低延迟友好的。主声道Main Soundtrack与时间轴音频自 TiXL 4.3 起音频以普通算子的形态活在时间轴上把音频文件从 Asset Library资源库或系统文件管理器拖到时间轴它就变成一个 [AudioClip]——可以像任意剪辑一样拖动、修剪、分割、循环、静音且一个项目可并行播放多个音频剪辑。其中一个剪辑可以成为主声道main soundtrack它有三个作用渲染为时间轴后面的全宽背景图像驱动音频反应型算子决定导出可执行文件的时长。两种设置入口在项目设置中点击Create Soundtrack已有主声道时变为Select and focus Main Soundtrack或右键时间轴上的任意音频剪辑选择Set as main soundtrack。主声道的几个行为细节它总是横跨其完整源内容它的剪辑块会从时间轴图层中隐藏——背景图像就是它的表现形式要重新定位它或把它变回普通剪辑把该算子的Display参数改回Clip即可。源码侧CompositionSettings.TryGetMainSoundtrack()会在启用的设置列表中找IsMainSoundtrack true的剪辑同时兼容主声道是图表中的算子的情况——AudioClip算子的 Display 为 BackgroundImage 时即把自身标记为主声道且该判断不依赖设置是否启用见 CompositionSettings.cs。播放端主声道通过 BASS 解码流接入 SoundtrackMixer现场播放路径为Stream → SoundtrackMixer → GlobalMixer → Soundcard导出时则直接从流读取数据见 SoundtrackClipStream.cs这也解释了听到什么就导出什么的保证。路由与混音把剪辑的AudioReference输出接到 [AudioBus] 即可完成路由——可以直接接也可以经过 [CombineAudio] 分组以及 [AudioReverb]、[AudioEcho]、[AudioCompressor] 等效果链。链路上任意位置挂一个 [AudioLevel] 抽头都能测量信号例如配合 [DuckAudioLevel] 实现人声出现时压低音乐的闪避ducking。在总线或分组上启用AutoCollectClips未接线unwired的剪辑会自动加入该总线。关键保证你听到的一切也正是导出到视频和可执行文件中的内容。Video Proxies预览用的降采样代理代理Proxy是视频剪辑的降采样、快寻址副本仅供预览使用——渲染输出永远使用全分辨率原片这也意味着代理绝不会影响最终成片质量。工作流从视频算子的右键上下文菜单生成代理在项目设置中勾选Use proxies for preview预览/拖拽scrub时即使用代理。参数说明配置项含义与建议Proxy Format代理编码格式。ProRes是均衡的默认值Hap 系列拖拽最快但文件更大对应源码ProxyConfig.Format默认VideoExportCodec.ProRes注释明确代理一律采用 all-intra/LGPL 编码绝不使用 GPL 的 H.264/HEVCProxy Resolution代理尺寸为源分辨率的几分之一默认 0.5即半分辨率源码ProxyConfig.Resolution 0.5f越小寻址越快、越省磁盘Storage显示已生成代理占用的磁盘空间——按项目统计与跨项目总计并提供一键清理清理不影响源片代理可随时重新生成ProxyConfig的三个字段Format / Resolution / UseForPreview与Audio、Export一样序列化在ProjectSettings.Proxy节点下见 CompositionSettings.cs并整体保存在项目的.t3文件中随项目走。Recording时间轴 Record 按钮捕获什么Recording区决定时间轴上的Record录制按钮捕获哪些来源Capture Audio—— 录制当前激活的音频输入设备即上文 Audio 区选择的 Input Device。Capture IO—— 把进入的MIDI 和/或 OSC 事件录制到音频剪辑旁的一个数据文件里使一次现场演出live take事后可以回放并精修。录制输入输出实现位于 IoServices 项目如 MidiDataRecording.cs、OscDataRecording.cs、IoDataSetRecorder.cs数据文件落点与命名规则可参考 RecordingPaths.cs录制路径定义在 Core 音频目录下。Export导出可执行文件的默认值Export区设置导出为独立可执行文件时的默认值真正执行导出通过 [ui:PlayerExporter|export dialog] 即导出对话框菜单 File → Export as ExecutableTitle / Author—— 窗口标题与启动对话框中显示的作者行留空则回退到算子和包名源码ExportConfig.Title/Author默认空字符串。Window Mode—— 可执行文件启动时是全屏还是窗口源码默认WindowMode.Fullscreen。Preferred Width / Height—— 可执行文件启动时的渲染分辨率默认 1920×1080若启用启动对话框则优先让观看者从显示器原生模式中选择。Skip Startup Dialog—— 直接按这些设置启动不再询问显示器、分辨率和窗口模式观看者仍可用--dialog参数强制弹出对话框。Show Log Messages—— 在可执行文件旁打开一个带日志输出的控制台窗口默认关闭。Strip Unused Operators—— 只打包连接到导出输出的算子外加自动播放的音频算子及其所需库若导出后内容缺失可关闭此项重试默认开启。Enable Playback Control—— 观看者可用方向键跳转时间、空格暂停对应源码EnablePlaybackControlWithKeyboard默认 true。导出时长由主声道的长度决定与 Audio 区联动。面板底部的Export按钮导出当前合成——前提是该合成位于某个父合成之内且具有 Texture2D 输出旁边的文件夹图标打开上次导出位置。快速参考关键默认值一览以下默认值均来自 CompositionSettings.cs 的Defaults实例与字段初始化配置默认值BPM120On BPM ChangeStretch with BeatResync Threshold0.04 s推荐区间 0.02–0.05 sAudio Gain1.0Audio Decay0.9Beat Lock SourceOnsetDetection可选 PhaseModel / PhaseModelRawBeat Lock Smoothing0.5Beat Sync Offset0 sProxy FormatProResProxy Resolution0.5源分辨率的一半Use proxies for preview开导出分辨率1920×1080导出窗口模式Fullscreen键盘播放控制开Strip Unused Operators开面板中每个字段旁的(?)悬停提示可随时查阅简短的字段解释见 ProjectSettings_Timing.md 等嵌入式帮助页。整套设置随合成写入.t3文件并支持新旧格式自动迁移旧键PlaybackSettings、旧版BPM 存在剪辑上的迁移逻辑见 CompositionSettings.cs这让项目设置真正做到了随项目旅行、跨机器可用。【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址: https://gitcode.com/GitHub_Trending/t3/t3创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考