TrajectoryCrafter Gradio界面详解：无需代码即可体验相机轨迹重定向

TrajectoryCrafter Gradio界面详解：无需代码即可体验相机轨迹重定向

【免费下载链接】TrajectoryCrafter[ICCV 2025, Oral] TrajectoryCrafter: Redirecting Camera Trajectory for Monocular Videos via Diffusion Models项目地址: https://gitcode.com/gh_mirrors/tr/TrajectoryCrafter

TrajectoryCrafter是一款基于扩散模型的相机轨迹重定向工具，能够让普通用户无需编写代码，通过直观的Gradio界面实现单目视频的视角转换。本文将详细介绍如何使用TrajectoryCrafter的Gradio界面，轻松创建专业级的视频视角效果。

图1：TrajectoryCrafter项目标题图，展示项目核心功能

快速开始：准备工作

在使用Gradio界面之前，需要先完成项目的基础安装。首先通过以下命令克隆仓库：

git clone https://gitcode.com/gh_mirrors/tr/TrajectoryCrafter

然后安装所需依赖，建议使用虚拟环境：

cd TrajectoryCrafter pip install -r requirements.txt

安装完成后，运行Gradio应用：

python gradio_app.py

应用启动后，会在本地12345端口运行，通过浏览器访问http://localhost:12345即可打开界面。

Gradio界面核心功能区解析

TrajectoryCrafter的Gradio界面设计直观友好，主要分为以下几个核心区域：

1. 视频输入与输出区

界面顶部左右两侧分别是视频输入和输出区域：

• 输入视频区：通过"Input Video"组件上传需要处理的视频文件
• 输出视频区：处理完成的视频会在这里自动播放，支持分享功能

图2：TrajectoryCrafter界面logo，包含相机和轨迹元素

2. 参数调节区

中间部分是参数调节区域，包含四个关键参数：

• Stride：视频采样间隔，范围1-3，值越小处理越精细但耗时更长
• center_scale：世界坐标系原点位置调节，小于1的值会使原点更靠近观察者
• Sampling steps：扩散模型采样步数，范围1-50，值越大效果越好但速度越慢
• Random seed：随机种子，用于结果复现，范围0到2^31

相机轨迹控制：一键实现专业视角转换

TrajectoryCrafter提供了丰富的相机轨迹控制方式，即使没有3D建模经验的用户也能轻松创建专业视角效果。

预设轨迹按钮

界面中部提供了12种预设轨迹按钮，分为三类：

平移控制：

• Pan Left：向左平移
• Pan Right：向右平移
• Pan Up：向上平移
• Pan Down：向下平移

旋转控制：

• Orbit Left：向左环绕
• Orbit Right：向右环绕
• Orbit Up：向上环绕
• Orbit Down：向下环绕

缩放控制：

• Zoom in：放大
• Zoom out：缩小
• Customize：自定义轨迹
• Reset：重置轨迹

点击任意按钮后，系统会自动生成对应的相机参数，无需手动输入复杂数值。

自定义轨迹参数

对于高级用户，TrajectoryCrafter支持通过文本框输入自定义轨迹参数：

Traget camera pose (theta, phi, r, x, y)

参数定义参考官方文档，每个参数的含义如下：

• theta：上下旋转角度，正值向上旋转（<60°）
• phi：左右旋转角度，正值向右旋转（<60°）
• r：距离缩放，正值向前移动（<0.6）
• x：水平平移，正值向右平移（<4）
• y：垂直平移，正值向上平移（<4）

系统提供了轨迹示例，如：

• 20; -30; 0.3; 0; 0：向上20°，向左30°，向前0.3单位
• 0; 0; -0.3; -2; 2：向后0.3单位，向左2单位，向上2单位

实战案例：使用示例视频快速体验

Gradio界面底部提供了5个示例视频，点击任意示例即可自动加载预设参数：

• test/videos/0-NNvgaTcVzAG0-r.mp4：配合参数0; -30; 0.5; -2; 0
• test/videos/tUfDESZsQFhdDW9S.mp4：配合参数0; 30; -0.4; 2; 0
• test/videos/part-2-3.mp4：配合参数20; 40; 0.5; 2; 0
• test/videos/p7.mp4：配合参数0; -50; 0.3; 0; 0
• test/videos/UST-fn-RvhJwMR5S.mp4：配合参数0; -35; 0.4; 0; 0

加载示例后，点击蓝色的"Generate video"按钮即可开始处理。处理时间根据视频长度和参数设置有所不同，一般需要1-5分钟。

高级技巧：优化生成效果

为了获得更好的视频效果，可以尝试以下技巧：

1. 调整采样步数：对细节要求高时使用50步，追求速度时可降低至20步
2. 尝试不同种子：同一参数下，不同种子会产生略有差异的结果
3. 组合使用轨迹：先使用预设按钮，再微调自定义参数
4. 合理设置Stride：高分辨率视频建议使用2或3的Stride值

总结

TrajectoryCrafter的Gradio界面将复杂的相机轨迹重定向技术变得简单易用，无论是视频创作者、设计师还是AI爱好者，都能通过这个直观的工具实现专业级的视角转换效果。无需代码基础，只需简单点击和调节，就能让普通视频焕发新的视觉魅力！

通过本文介绍的界面功能和使用技巧，相信你已经能够轻松上手TrajectoryCrafter。赶快尝试上传自己的视频，探索无限的视角可能吧！

【免费下载链接】TrajectoryCrafter[ICCV 2025, Oral] TrajectoryCrafter: Redirecting Camera Trajectory for Monocular Videos via Diffusion Models项目地址: https://gitcode.com/gh_mirrors/tr/TrajectoryCrafter