1. 先搞清楚视频融合宽高比调整到底解决什么问题

如果你在数字孪生项目里用过 CIMPro，大概率会遇到这个问题：导入的视频素材和三维场景对不上，要么视频被拉伸变形，要么场景边缘出现黑边。这其实就是宽高比不匹配导致的。

视频融合宽高比调整，核心解决的是“视频源与三维场景视觉对齐”的问题。比如监控摄像头实时画面接入三维工厂场景，或者宣传视频嵌入数字沙盘时，如果宽高比没调对，画面要么变形失真，要么无法完整覆盖目标区域。CIMPro 作为国产数字孪生平台，视频融合是其多源数据融合能力的一部分，但宽高比调整这个具体操作，很多人在第一次接触时容易忽略前置条件，直接调参数，结果越调越乱。

我建议先明确一个基础概念：宽高比调整不是简单拉拽画面，而是协调输入视频、目标区域、输出分辨率三者的关系。在 CIMPro 里，这涉及到场景编辑器、动画模块和输出设置三个环节的联动。如果只是学习测试，默认参数可能够用；但如果要做交付项目，就必须提前规划好输入视频规格和场景画布比例。

2. 环境准备和前置检查：别急着改参数，先确认基础条件

宽高比问题经常被误判为功能缺陷，其实八成是环境或输入数据问题。在动手调整前，先按这个顺序检查一遍。

2.1 确认 CIMPro 版本和基础配置

CIMPro 不同版本对视频格式的支持略有差异。虽然官方资料提到支持多源数据融合，但具体到视频格式，建议先确认以下几点：

• 版本类型：你是否使用支持视频融合的 CIMPro 孪大师版本（通常是全功能版或企业版）。
• 系统环境：Windows 10/11 或 Windows Server 2016/2019/2022，64 位系统。虽然也支持 Ubuntu，但视频处理在 Windows 环境下兼容性更好。
• 资源占用：视频解码会占用额外内存和 CPU。官方推荐配置是 8 核 CPU、64G 内存，但如果你只是调整宽高比（不涉及多路视频实时融合），4 核 CPU、16G 内存的最低配置也能跑。

2.2 检查输入视频的元数据

这是最容易出问题的地方。很多人直接拖拽手机拍摄的视频或网络下载的素材，但它们的宽高比可能非标准。用播放器或 FFmpeg 检查视频的原始宽高比（例如 1920x1080 是 16:9，1280x720 也是 16:9，但 1920x817 可能是裁剪后的电影比例）。

我一般会先用工具查看视频的精确分辨率、编码格式（H.264/HEVC）和帧率。CIMPro 对 MP4（H.264）支持最稳定，如果视频是 MOV、AVI 或特殊编码，建议先转码再导入。

2.3 确认场景画布比例

在 CIMPro 场景编辑器中，画布比例取决于项目设置。比如你创建的是一个 16:9 的大屏项目，但视频是 4:3，直接融合就会出问题。先进入项目设置，查看场景分辨率或画布宽高比，记下这个数值。

3. 单视频融合测试：从最小样例开始验证

不要一上来就处理多路视频或复杂动画。先拿一条标准视频（如 1920x1080 的 MP4）做单次融合测试，确认整个流程能跑通。

3.1 导入视频并定位到目标区域

在 CIMPro 编辑器中，通过“资源导入”或直接拖拽添加视频。添加后，视频会以平面素材形式出现在场景中。这时先不要调整任何参数，观察默认状态：

• 如果视频自动匹配画布比例，且无变形，说明原始比例一致，无需调整。
• 如果视频被拉伸或压缩，说明比例不一致，需要手动干预。
• 如果视频只显示部分画面，可能是裁剪模式生效。

3.2 调整宽高比的三个核心参数

在视频对象的属性面板中，找到“变换”或“尺寸”模块，关键参数如下：

• 保持宽高比（Aspect Ratio Lock）：这个选项一定要勾选。否则直接调整宽度或高度会导致变形。
• 宽度/高度：手动输入目标尺寸。这里不建议直接拖拽控制点，容易误操作。最好根据场景画布比例计算后输入精确值。
• 适配模式（Fit Mode）：CIMPro 可能有类似“填充（Fill）”、“适配（Fit）”、“拉伸（Stretch）”的选项。如果是融合到固定区域，选“填充”会裁剪视频边缘以铺满区域，选“适配”会保留全部画面但可能留黑边。

举个例子：如果场景画布是 16:9（1920x1080），视频是 4:3（1440x1080），你想让视频完全覆盖画布：

• 计算缩放比例：以高度为基准，1080 像素对应视频原始高度 1080，宽度应缩放为 1440 * (1080/1080) = 1440。但画布宽度是 1920，所以左右会有黑边。
• 如果不想留黑边，就要选择“填充”模式，视频会放大到高度 1080、宽度 1920，但左右内容被裁剪。

3.3 预览和输出验证

调整后，在编辑器内预览效果。重点关注：

• 画面是否变形（圆形是否还是圆）。
• 重要内容是否被裁剪（如人脸、关键设备）。
• 边缘是否出现非预期的黑边或重复像素。

然后输出一小段视频（选择 10 秒左右，降低测试时间），用播放器全屏查看，确认在目标设备上显示正常。

4. 批量视频处理：统一规格和命名规则

单视频测试通过后，如果项目需要融合多个视频（如多个摄像头视角），就要考虑批量处理。CIMPro 本身可能不直接支持批量宽高比调整，但可以通过模板化操作提高效率。

4.1 预处理视频素材

在导入 CIMPro 前，先用 FFmpeg 或格式工厂等工具，将所有视频统一为相同宽高比和分辨率。例如，全部转为 1920x1080（16:9）的 MP4 文件。这样在 CIMPro 里只需要应用同一套尺寸参数，避免逐个调整。

批量转码命令示例（FFmpeg）：

ffmpeg -i input.mp4 -vf "scale=1920:1080:force_original_aspect_ratio=decrease:flags=lanczos,pad=1920:1080:(ow-iw)/2:(oh-ih)/2" -c:v libx264 -preset medium output.mp4

这个命令将视频按比例缩放至 1920x1080 内，不足部分填充黑边，保持内容不变形。

4.2 在 CIMPro 中使用蓝图或脚本

如果视频数量多，且需要动态调整，可以尝试 CIMPro 的蓝图编辑器或 API 二次开发。通过蓝图节点控制视频对象的宽高比属性，实现批量绑定参数。例如，创建一个宽高比控制变量，所有视频对象引用同一变量，修改变量值即可同步调整。

4.3 输出设置和命名管理

批量处理时，输出视频的命名要有规则，例如按摄像头编号、时间戳或区域命名。在 CIMPro 输出模块中，设置好输出目录和文件命名模板，避免文件覆盖或混乱。

5. 常见问题排查：宽高比异常的可能原因和解决顺序

调整宽高比时遇到问题，不要急着改参数，按这个顺序排查：

5.1 检查输入视频本身

• 现象：视频在 CIMPro 中变形，但在播放器里正常。
• 排查：用 MediaInfo 或 FFmpeg 检查视频是否包含非标准 SAR（Sample Aspect Ratio）或 DAR（Display Aspect Ratio）。有些视频元数据标记的宽高比与实际像素比例不一致，导致播放器能正确解析，但 CIMPro 识别错误。
• 解决：用 FFmpeg 重写元数据，强制统一比例：

  ffmpeg -i input.mp4 -c copy -aspect 16:9 output.mp4

5.2 确认场景单位和缩放比例

• 现象：视频在编辑器中显示正常，但输出后变形。
• 排查：检查场景的输出分辨率设置是否与预览分辨率一致。有时编辑器预览用的是画布比例，但输出模块设置了固定分辨率，两者不匹配。
• 解决：在输出设置中，确认分辨率与场景画布比例一致。例如画布是 16:9，输出分辨率也设为 1920x1080 或同比例值。

5.3 动画关键帧干扰

• 现象：视频在某一帧突然变形。
• 排查：如果视频参与了动画序列，检查关键帧是否误改了缩放属性。在动画编辑器中，逐帧查看宽高比参数是否被意外添加关键帧。
• 解决：删除异常关键帧，或重置动画曲线。

5.4 渲染引擎差异

• 现象：本地预览正常，部署到服务器后变形。
• 排查：服务器和客户端的图形设置或渲染模式可能不同。例如，服务器端可能强制使用某种缩放策略。
• 解决：在部署配置中，统一渲染设备的输出分辨率和缩放模式。

6. 进阶场景：动态宽高比适配和性能权衡

对于需要动态调整宽高比的场景（如响应式大屏或移动端适配），CIMPro 可以通过蓝图或 API 实现。

6.1 响应式布局思路

通过蓝图脚本监听画布尺寸变化，动态计算视频对象的宽高比。例如，当大屏分辨率切换时，脚本自动调整视频尺寸，保持内容比例不变形。这需要一些简单的数学计算：以画布短边为基准，按视频原比例缩放。

6.2 性能注意事项

动态调整宽高比会触发实时渲染重计算，对性能有影响。在低配设备上，如果视频数量多或分辨率高，可能出现卡顿。建议：

• 预计算常见分辨率下的宽高比参数，避免运行时频繁计算。
• 对于固定场景，尽量预处理视频，减少运行时调整。
• 在蓝图或脚本中，添加条件判断，只有比例变化超过阈值时才触发调整。

6.3 替代方案：遮罩和背景设计

如果宽高比无法完美匹配，可以考虑用视觉设计弥补。例如，在视频周围添加装饰性边框或遮罩，使黑边融入场景设计。这在数字孪生大屏中很常见，既能保持内容比例，又不影响整体美观。

宽高比调整本身不难，难的是在项目流程中提前规划。我建议在素材收集阶段就统一视频规格，在场景设计时预留适配空间，这样后期调整工作量最小。如果等到交付前才发现比例问题，修改成本会高很多。