TiXL Asset Library资源库完整指南浏览、追踪与就地替换项目媒体【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址: https://gitcode.com/GitHub_Trending/t3/t3Asset Library资源库是 TiXL实时动态图形软件中统一浏览、管理项目所使用媒体文件的核心面板。它以缩略图网格 树形目录的方式展示图片、视频、字体等一切项目资源并实时报告每个资源被哪些算子引用当你需要替换某个素材时可以直接在库中就地换源让所有引用它的算子一次性更新。读完本文你将掌握 Asset Library 的完整功能资源地址体系、引用追踪机制、就地替换操作、右键菜单与链接文件夹Linked Folder的维护并能结合仓库源码理解其底层实现。一、Asset Library 是什么核心概念按照官方文档 AssetLibrary.md 的定义Asset Libraryis where you browse the images, videos and other media files a project uses, shown as thumbnails.也就是说资源库面向的是项目实际使用或将要使用的媒体文件而不是磁盘上的任意文件。它具备两个官方强调的核心能力引用可见每个资源条目除了展示预览缩略图还会显示它已经在项目中哪里被使用让你一眼看出哪些算子依赖它就地替换你可以用另一个资源就地替换当前资源所有引用它的算子会同时更新。官方文档给出的使用场景定位是当你想要审查review、替换replace或追踪track down喂给场景的媒体时就打开 Asset Library。与之配套的 Asset.md 进一步界定了“资源Asset”的概念一个 Asset 就是一个媒体文件——图片、视频、字体或类似资源——由项目加载并送入算子使用。资源通过匹配的算子例如图片加载器加载到图中帮助文本和描述可以通过方括号链接square-bracket link直接链接到某个资源点击后会在资源库中将其打开定位。二、窗口入口与界面构成在 TiXL 编辑器中Asset Library 对应的是一个名为Assets的窗口。从源码看它的实现类为T3.Editor.Gui.Windows.AssetLib.AssetLibrary通过[HelpUiID(AssetLibrary)]属性注册窗口标题为Assets见 AssetLibrary.cs。窗口顶部是三条关键控件见 AssetLibrary.Draw.cs搜索框Search Assets...按资源地址Address做不区分大小写的模糊匹配折叠全部Collapse图标按钮一键收起整棵资源目录树工具与设置Tools按钮打开资源库设置弹窗其中包含与算子选择联动的过滤选项。主区域是一棵按包Package→ 目录 → 资源文件组织的树。树中的每个文件夹节点右侧还会在“筛选/搜索模式”下显示匹配数量MatchingAssetCount方便你快速判断资源分布。从实现细节看DrawContent()每一帧都会调用UpdateAssetsIfRequired()检查是否需要重建资源列表触发条件包括文件监视器状态变化ResourceFileWatcher.FileStateChangeCounter、当前合成对象变化、筛选条件变化、搜索词变化见 AssetLibrary.cs。这意味着你在编辑器外部如 Windows 资源管理器往Assets/文件夹里增删文件Assets 窗口会自动感知并刷新——这正是“文件监视器”机制在起作用。资源地址与类型理解库的组织方式理解 Asset Library 的树形结构需要先了解资源的“地址”体系。每个资源都有一个唯一地址Address格式为包名:相对路径例如MyProject:Footage/Clips/example.mp4表示项目MyProject包下Footage/Clips/目录中的视频。分隔符在源码中定义于 AssetRegistry.csPackageSeparator :。Asset类见 Asset.cs保存Address、由地址生成的稳定Id、所属包、磁盘FullPath、AssetType等元数据并为 UI 树提供PathParts按路径分段免去重复解析。资源的类型图片、视频、音频、数据等由 AssetType.cs 定义每种类型绑定一组扩展名 IDExtensionIds、专属颜色与图标并关联一个“主算子”PrimaryOperators——把该资源拖到图上时会创建的默认算子。部分类型还声明了TimelineClipOperator拖到时间线时创建的 Clip 算子例如视频拖到图上创建PlayVideo、拖到时间线则创建VideoClip和RecordingFolder录制会话导入的子目录例如 Audio →audio、Data →dataclips。三、引用追踪一个资源被谁在使用这是 Asset Library 区别于普通文件浏览器的核心能力。资源库维护了一张资源 → 引用列表的全局索引ReferencesForAssetId见 AssetRegistry.cs每个AssetReference定义于 Asset.cs记录引用它的符号Symbol、符号子节点与输入槽并区分“算子实例引用”与“默认值引用”IsDefaultValueReference。具体到界面当鼠标悬停在一个资源条目上时会弹出富信息工具提示见 AssetLibrary.Draw.cs显示资源的缩略图预览由ThumbnailManager.GetThumbnail提供文件大小人类可读格式与最后修改时间使用计数Used by : N operators或Not used by any operator按住Shift键悬停时还会逐条列出具体使用它的符号格式为命名空间.符号名 » 子节点名实例引用或命名空间.符号名.输入名 (Default)默认值引用见 AssetLibrary.Draw.cs。在列表视图中没有任何引用的资源条目左侧会显示一个“休眠”图标Icon.Sleeping帮助你快速发现项目中未被使用的素材及时清理或归档见 AssetLibrary.Draw.cs。四、就地替换一次点击更新所有引用官方文档强调的核心操作是就地替换把资源 A 换成资源 B所有引用 A 的算子同时更新。这个操作的触发方式先在图上选中某个带有资源路径输入的算子再在 Assets 窗口中点击目标资源条目。其底层逻辑在DrawAssetItem()与ApplyResourcePath()中见 AssetLibrary.Draw.cs点击资源条目后代码定位到当前选中实例的路径输入槽ActivePathInput校验该资源与输入槽的扩展名过滤是否兼容fileConsumerOpIsCompatible不兼容则条目被淡化且不可点击兼容时通过ChangeInputValueCommand修改输入值——该命令会压入撤销栈UndoRedoStack因此替换操作可以撤销强制使输入槽的 DirtyFlag 失效并逐级传播失效触发引用它的算子在下一次求值时重新加载新资源。也就是说“就地替换”在实现上就是一次带撤销能力的输入值修改Asset Library 只是帮你把所有引用一次性处理掉。与算子选择的联动筛选Assets 窗口与当前选中的算子实例是双向联动的见 AssetLibrary.cs选中带有资源输入的算子后窗口会自动定位滚动并展开到该算子当前使用的资源地址ActiveAssetAddress同时启用类型过滤只有与该输入兼容的资源类型会被高亮显示不兼容的类型自动过滤该行为受用户设置SyncWithOperatorSelection控制可在 Settings.cs 对应的用户设置中开启或关闭若当前选中算子使用的资源位于某个未展开的文件夹行尾会出现“瞄准”图标Icon.Aim闪烁提示点击即可展开并定位到目标文件。此外当某个资源条目处于激活状态且尚未在可视区域内时窗口会自动滚动到该条目SetScrollHereY(0.5f)确保你始终能看到当前正在使用的资源。五、右键菜单文件级操作全集在资源条目上右键会弹出上下文菜单见 AssetLibrary.Draw.csEdit Externally用系统默认应用打开该资源文件如用 PS 打开图片进行外部编辑Reveal in Explorer在系统文件管理器中定位并高亮该文件所在目录Delete File... / Delete N Selected...删除文件多选时批量删除并显示数量删除前有确认对话框DrawDeleteConfirmationDialog。资源条目本身支持拖拽可以把资源从库中直接拖到图上或时间线上创建对应算子类型决定算子见上文PrimaryOperators/TimelineClipOperator拖拽时按住 Ctrl 可多选Shift 可实现范围选择锚点选择见GetRange辅助逻辑。若目标位置是文件夹节点还可以把资源移动到该文件夹MoveAssetsToFolder见 AssetLibrary.Actions.cs拖放时若目标文件夹缺失会拒绝执行并给出警告避免把文件移动到错误的工作目录。六、文件夹管理创建、重命名与链接文件夹在文件夹节点上右键提供如下操作见 AssetLibrary.Actions.csOpen in Explorer打开该目录Create Sub Folder在当前目录下创建New folder重名时自动追加数字后缀Rename重命名目录名称不能包含/、\、:等非法字符普通文件夹会执行真实的磁盘目录移动并同步资源索引Directory.MoveAssetRegistry.UpdateMovedAssetDelete Folder...删除整个目录及其内容。链接文件夹Linked Folder对于大型媒体素材例如成百上千段视频素材官方推荐使用链接文件夹而不是复制进每个项目。这一机制在 ImportingAssets.md 中有完整说明从文件管理器拖入一个文件夹到 TiXL 窗口时导入对话框提供三种方式Copy folder into Assets—— 复制到Assets/文件夹名/保持目录结构Copy files sorted by type—— 按类型分类复制到标准子目录images/、video/、audio/…Link folder without copying—— 不复制文件夹以链接形式出现在 Assets 窗口中。选择链接后TiXL 只在项目的Assets/目录写入一个很小的文件夹名.tixlLink标记文件指向磁盘上的真实位置。链接文件夹在 Assets 窗口中带链接图标标识源码中为IsLinkMountRoot资源见 Asset.cs。链接文件夹的若干行为要点删除有风险在链接文件夹内删除文件会直接删除源文件它们仍在原位置双向可见TiXL 在链接目录中新建的文件例如代理 Proxy 文件也会出现在源文件夹里跨机器失效链接只在目标路径存在的机器上生效换机器后文件夹显示为灰色并带警告图标但项目本身仍能正常加载从链接文件夹拖放不复制从资源管理器把链接目录内的文件拖到图上/时间线/Assets 窗口时TiXL 会识别它已通过链接可达直接以链接地址引用如MyProject:Footage/Clips/example.mp4拖放提示显示Reference files from linked folder...若确实需要项目内副本请先在资源管理器中复制到Assets/下移除链接右键链接文件夹 →Remove Link仅删除.tixlLink标记文件绝不触碰链接内容重命名链接文件夹只是重命名标记不会改源目录名见RenameFolderLinkAssetLibrary.Actions.cs重新链接Relink若链接目标缺失常见于换机器后同步目录路径不同右键 →Relink...在对话框中粘贴新路径即可。最快获取路径的方式是在 Windows 资源管理器中右键文件夹 →Copy as path或CtrlShiftC。链接文件会记住历史位置每台机器只需首次重链接一次对应 UI 逻辑见 AssetLibrary.RelinkFolder.cs。注意事项如果项目位于同步盘OneDrive、Dropbox 等.tixlLink小文件会随项目同步但链接的媒体内容不会同步此外导出独立可执行文件时不会打包链接的外部文件发布前请先把文件夹复制进项目。七、与帮助系统及其他窗口的联动帮助文本直链资源如 Asset.md 所述帮助文本和算子描述可以用方括号链接例如[ui:AssetLibrary|Asset Library]这样的格式直接引用某个资源点击后会在资源库中打开并定位该资源文件监视器Assets 窗口依赖ResourceFileWatcher的变更计数自动刷新外部对Assets/目录的增删改会实时反映到库中时间线拖放资源还可拖入时间线创建基于 TimeClip 的算子如 AudioClip、VideoClip、LoadDataClip这是由资源类型的TimelineClipOperator决定的见 AssetType.cs 的注释说明。八、相关源码速查主题仓库位置Asset Library 窗口主类AssetLibrary.cs绘制、工具提示与就地替换AssetLibrary.Draw.cs文件夹与文件操作重命名/删除/移动AssetLibrary.Actions.cs资源模型Address/Id/引用Asset.cs资源注册表地址解析/引用索引AssetRegistry.cs资源类型扩展名/主算子/图标AssetType.cs官方使用指南导入与链接文件夹ImportingAssets.md总而言之Asset Library 是 TiXL 媒体工作流的中枢浏览缩略图 树 搜索/筛选、追踪引用计数与使用位置列表、替换带撤销的就地换源三位一体配合链接文件夹机制让大型媒体项目的素材管理既直观又安全。无论你是在排查“这个画面用了哪张图”还是想整体换一套纹理素材Assets 窗口都是你唯一需要的入口。【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址: https://gitcode.com/GitHub_Trending/t3/t3创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考