支持软件 TNR/MCTF

IQ-9075-EVKIQ-8275-EVKGPU 加速

GPU

处理引擎

NV12_Q08C

输入格式

MCTF

降噪

平台适用范围：
SW TNR / MCTF 仅在 IQ-9075-EVK 和 IQ-8275-EVK 上启用。

01 · 它是什么？

运动补偿时域滤波（Motion Compensated Temporal Filtering）——一种基于软件的视频质量滤波器，可跨帧降噪——在 IPE 硬件 MCTF 不可用的情况下运行于 GPU 上。 MCTF 通过降低时域噪声和增强运动清晰度来改善预览和视频质量。软件实现运行在 GPU 上，在静态区域执行帧间混合，并应用全局运动补偿变换。

02 · 它控制什么

SW MCTF Workflow Pipeline:
Current Frame  →  ME Matrix  →  Warp (prev frame)  →  Alpha Mask  →  Blend  →  Output Frame
Previous Output →  Noise Calc  →  Blend Input  ↗

阶段	作用	跳过后的影响
运动估计（ME）	计算当前帧与前一帧之间的变换矩阵	无运动补偿 → 出现鬼影伪像
Warp（变形）	使用 ME 矩阵对前一输出帧进行变形	混合错位 → 拖影
Alpha 掩膜	区分背景区域与局部运动区域	静态噪声未被降低，运动区域过度混合
Blend（混合）	使用 Alpha 掩膜和噪声估计合并当前帧与前一帧	输出视频中可见时域噪声

在高运动场景（机器人、汽车）中，降低 MCTF 混合强度可防止快速移动物体出现时域鬼影。

03 · 验证

使用 SSH 连接到设备控制台。相关说明请参阅 How To SSH?。

收集用户日志

实时监控 CamX 核心配置状态。

Log Collection

# On device console
journalctl -f > /opt/user_log.txt

收集内核日志

捕获 ISP 硬件管理器事件和获取信息。

Kernel Logging

dmesg -w > /opt/kernel_log.txt

使用 sw-tnr=true 运行 GStreamer 流水线

使用 NV12_Q08C 格式执行流水线并启用软件 TNR 标志。

GStreamer (SW MCTF Enablement)

gst-launch-1.0 -e qtiqmmfsrc name=camsrc video_0::type=preview sw-tnr=true ! \
video/x-raw,format=NV12_Q08C,width=1280,height=720,framerate=30/1 ! \
v4l2h264enc capture-io-mode=4 output-io-mode=5 \
extra-controls="controls,video_bitrate=6000000,video_bitrate_mode=0;" ! \
h264parse ! mp4mux ! filesink location=/opt/cam_prev.mp4

验证日志输出

通过检查用户日志中以下确切的日志条目确认功能已激活：CamX 流水线状态：

User Log Verification

CamX: [CORE_CFG] 3509 3556 [CORE] camxpipeline.h:4222 SetPipelineStatus()
RealTimeFeatureZSLPreviewRawSWMCTF_0_cam_0 status is now PipelineStatus::STREAM_ON

MCTF 库初始化：

User Log Verification

CamX: [ INFO] 3509 3556 [CHI ] camxchimoduleswmctf.cpp:328 Initialize()
libmctf Version: 1.0.0

STREAM_ON 确认 CamX 流水线已在启用 MCTF 的情况下运行。libmctf Version 字符串确认软件库已在 GPU 上初始化。

🛠️ 故障排除 / 已知问题 — SW TNR/MCTF

问题 / 现象	详情 / 说明
快速移动物体出现鬼影伪像	高运动场景（机器人、汽车）可能导致时域鬼影 — 可通过降低 MCTF 混合强度来缓解
用户日志中未看到 `STREAM_ON` 状态	CamX 流水线可能未在启用 MCTF 的情况下运行 — 请验证日志条目：`SetPipelineStatus() ... status is now PipelineStatus::STREAM_ON`
`libmctf` 库未初始化	如果用户日志中没有 `libmctf Version: 1.0.0`，说明 SW MCTF 库未能在 GPU 上初始化 — 请检查 `camxchimoduleswmctf.cpp:328 Initialize()`

简介

架构

关键文档

技术

系统

发行说明

GPU

NV12_Q08C

MCTF

01 · 它是什么？

02 · 它控制什么

03 · 验证

🛠️ 故障排除 / 已知问题 — SW TNR/MCTF

GPU

NV12_Q08C

MCTF

​01 · 它是什么？

​02 · 它控制什么

​03 · 验证

​🛠️ 故障排除 / 已知问题 — SW TNR/MCTF

01 · 它是什么？

02 · 它控制什么

03 · 验证

🛠️ 故障排除 / 已知问题 — SW TNR/MCTF