Google libultrahdr 开源项目指南

Google libultrahdr 开源项目指南

libultrahdr Ultra HDR is a true HDR image format, and is backcompatible. libultrahdr is the reference codec for the Ultra HDR format. The codecs that support the format can render the HDR intent of the image on HDR displays; other codecs can still decode and display the SDR intent of the image. 项目地址: https://gitcode.com/gh_mirrors/li/libultrahdr

1. 项目介绍

Google的libultrahdr是一个高级的HDR图像处理库，支持真10位HDR图像格式，且向后兼容。此库为Ultra HDR格式提供了参考编码器，使得图像在兼容显示器上能够展现高动态范围效果。通过结合基础图像与增益映射图像，旧版阅读器仅展示基础图像，而支持该格式的应用则能合成并渲染出HDR图像。libultrahdr利用libjpeg-turbo进行JPEG压缩，并需要CMake、NASM或Yasm等工具以及支持C++17的编译器来构建。

2. 项目快速启动

要快速启动并构建libultrahdr及其示例应用，遵循以下步骤：

在Linux或Mac上：

mkdir build
cd build
cmake -G "Unix Makefiles" -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ -DUHDR_BUILD_TESTS=1 ../
make
ctest

在Windows（使用Visual Studio 2019或更高版本）上：

mkdir build
cd build
cmake -G "Visual Studio 16 2019" -DUHDR_BUILD_TESTS=1 ..
cmake --build . --config Release
ctest -C Release

这将分别在不同平台上生成相应的静态库文件和其他可执行文件，包括用于API演示的ultrahdr_app及单元测试。

3. 应用案例和最佳实践

使用libultrahdr时，开发者可以创建支持HDR显示的应用。最佳实践包括：

• 利用ultrahdr_api.h中详述的API进行HDR图像的编码与解码。
• 对于新的应用开发，确保正确处理基础图像与增益映射图像，以保证在不同显示设备上的兼容性和视觉一致性。
• 在性能敏感场景下，考虑启用或禁用单元测试的构建，以优化构建时间与运行效率（通过移除-DUHDR_BUILD_TESTS=1）。

4. 典型生态项目

libultrahdr作为HDR处理的核心组件，可以集成到多种生态系统中，如Android平台的多媒体应用，实现高质量的图像显示。此外，结合其他HDR相关的标准和工具，例如Android的HDR Image Format指导，开发者可以在多种应用场景中构建出高度优化的HDR内容处理解决方案。

在实现HDR功能时，注意遵循Android开发者指南中的HDR图像格式建议，以充分利用libultrahdr的优势。开发者社区可以探索将此库应用于图像编辑软件、流媒体服务客户端或是专业摄影后期处理工具，以提升最终用户的HDR体验。

---

本指南提供了一个起点，让开发者能够迅速理解和开始使用libultrahdr库。深入学习和定制化应用将取决于具体项目需求和技术栈。

libultrahdr Ultra HDR is a true HDR image format, and is backcompatible. libultrahdr is the reference codec for the Ultra HDR format. The codecs that support the format can render the HDR intent of the image on HDR displays; other codecs can still decode and display the SDR intent of the image. 项目地址: https://gitcode.com/gh_mirrors/li/libultrahdr