Dolby Vision工具箱：dovi_tool完整使用指南

Dolby Vision工具箱：dovi_tool完整使用指南

【免费下载链接】dovi_tooldovi_tool is a CLI tool combining multiple utilities for working with Dolby Vision.项目地址: https://gitcode.com/gh_mirrors/do/dovi_tool

dovi_tool是一个功能强大的命令行工具，专门用于处理Dolby Vision内容。该工具集成了多种实用功能，为开发者和视频工程师提供完整的Dolby Vision处理解决方案。

项目概述

dovi_tool作为Dolby Vision处理的综合工具，提供了从元数据分析到文件格式转换的全方位功能。项目包含核心的dolby_vision Rust库，同时也提供C兼容库libdovi。

环境要求与安装

系统要求

• 最低Rust版本：1.85.0
• Linux系统需要安装fontconfig依赖

快速安装步骤

git clone https://gitcode.com/gh_mirrors/do/dovi_tool cd dovi_tool cargo build --release

构建完成后，可执行文件位于target/release/dovi_tool。

核心功能详解

Dolby Vision元数据工具

info命令

用于解析和显示RPU信息，支持获取摘要和特定帧的详细数据。

使用示例：

dovi_tool info -i RPU.bin -s dovi_tool info -i RPU.bin -f 123

generate命令

支持从多种来源生成二进制RPU文件：

• 从XML元数据文件生成：支持CMv2.9和CMv4.0格式
• 从配置文件生成：支持profile 5/8.1/8.4
• 从HDR10+元数据生成：基于HDR10+场景信息
• 从madVR测量文件生成：支持自定义目标亮度

使用示例：

dovi_tool generate --xml dolbyvision_metadata.xml -o RPU_from_xml.bin dovi_tool generate -j assets/generator_examples/default_cmv40.json -o RPU_generated.bin

editor命令

通过JSON配置文件编辑二进制RPU文件，支持帧范围操作。

使用示例：

dovi_tool editor -i RPU.bin -j assets/editor_examples/mode.json -o RPU_mode2.bin

export命令

将二进制RPU文件导出为文本格式，支持多种数据类型的导出。

使用示例：

dovi_tool export -i RPU.bin -d all=RPU_export.json dovi_tool export -i RPU.bin -d scenes,level5=L5.json

plot命令

将RPU元数据绘制成图表，输出为PNG格式。

使用示例：

dovi_tool plot RPU.bin -t "Dolby Vision L1 plot" -o L1_plot.png

HEVC解析与处理

转换模式

提供多种RPU处理模式：

• 模式0：解析并重写RPU
• 模式1：转换为MEL兼容格式
• 模式2：转换为profile 8.1兼容格式
• 模式3：profile 5转8.1
• 模式4：转换为profile 8.4
• 模式5：转换为profile 8.1并保留映射

convert命令

在单层HEVC文件中转换RPU，支持丢弃增强层。

使用示例：

dovi_tool -m 2 convert --discard file.hevc

demux命令

将单轨双层Dolby Vision分离为基础层和增强层文件。

使用示例：

dovi_tool demux file.hevc dovi_tool -m 2 demux file.hevc

mux命令

将增强层交织到基础层HEVC码流中，是demux的逆操作。

使用示例：

dovi_tool mux --bl BL.hevc --el EL.hevc

extract-rpu命令

从HEVC文件中提取Dolby Vision RPU数据。

使用示例：

dovi_tool extract-rpu video.hevc dovi_tool -m 1 extract-rpu video.hevc

inject-rpu命令

将RPU NAL单元注入到HEVC编码码流中。

使用示例：

dovi_tool inject-rpu -i video.hevc --rpu-in RPU.bin -o injected_output.hevc

remove命令

从视频中移除增强层和RPU数据。

使用示例：

dovi_tool remove file.hevc

配置文件说明

项目提供了丰富的配置文件示例，位于assets/目录下：

• editor_examples/：编辑器配置示例
• generator_examples/：生成器配置示例
• hevc_tests/：HEVC测试文件
• tests/：各种测试用例

高级功能

场景检测与处理

支持基于HDR10+元数据的场景切割检测，确保场景边界的正确处理。

亮度映射

提供灵活的亮度映射功能，支持多种目标亮度设置（100-4000 nits）。

多格式支持

兼容多种Dolby Vision配置文件，包括profile 4、5、7、8等。

最佳实践建议

1. 预处理检查：在处理关键数据前，先使用info命令检查元数据完整性
2. 批量处理：结合脚本实现批量文件处理
3. 质量保证：使用plot命令可视化元数据变化
4. 版本兼容：确保使用的工具版本与目标格式兼容

项目结构

项目采用模块化设计，主要包含：

• dolby_vision/：核心库源码
• src/：命令行工具源码
• docs/：详细文档
• assets/：示例文件和测试数据

通过dovi_tool，用户可以高效地处理Dolby Vision内容，从简单的元数据分析到复杂的格式转换，都能得到专业的支持。

【免费下载链接】dovi_tooldovi_tool is a CLI tool combining multiple utilities for working with Dolby Vision.项目地址: https://gitcode.com/gh_mirrors/do/dovi_tool