v0.2.0

TL;DR

• Please put your .cube LUT files in bin/LUTs on Windows or /Applications/PuerhLab.app/Contents/MacOS/LUTs on macOS.
• On machines with the Apple M1 processor, the application may fail to load or render images.
• For Windows users, please make sure your NVIDIA graphics driver is the latest.

太长不看

• 请把你的 .cube LUT 文件放到 Windows 版本的 bin/LUTs 目录或 macOS 版本的 /Applications/PuerhLab.app/Contents/MacOS/LUTs 目录中.
• M1 处理器的用户可能会遇到图像加载失败的问题，请等待更新
• 对于 Windows 用户来说，请确保您的 NVIDIA 显卡驱动已更新到最新

Changelog

[0.2.0] (03344c0..b8c2fa3) — 2026-03-07 ~ 2026-03-14

Features

• Cross-platform rendering expansion: Added macOS build support and integrated the Metal pipeline (briefly: raw/resize/lens utilities, pipeline wiring, and performance/refactor passes) (5eed41d, 0a37cfa, aefa6f0)
• macOS visual pipeline upgrades: Added basic color management and experimental HDR support on macOS (880234c, 4c879c3)
• Windows preview backend update: Ported Windows preview surface to D3D11 (3a079ad)
• Internationalization: Added i18n support, language selection UI adjustments, and zh-CN font updates (2caeaed, 9657bf5, 44b5401)
• New scopes & controls: Added histogram/waveform display, aspect ratio selection, thumbnail waiting animation, and reset adjustments support (5f47c71, e559e1e, 85a4440, 2c18f7f)
• Versioning UI refresh: Improved versioning UI design (a0a5931)

Bug Fixes

• Windows build stability: Fixed multiple Windows compile issues during cross-platform integration (e794c4e, a6d8968, 2eca003, 4f89c41)
• Metal pipeline path fix: Corrected wrong geometry pipeline path in Metal (34242aa)
• Renderer include/path fixes: Updated include path handling for OpenGL viewer renderer (cefe155)
• Editor background issue: Fixed editor background issue in reset-adjustments workflow (2c18f7f)

Documentation

• Added changelog documentation (805996f)
• Added demo website and updated project website content (f6b76d8, 2eff447)
• Updated README content (performance data, removed outdated video link) (1699e67, adc1912)

Miscellaneous

• Added website deployment GitHub Actions workflow (385ecec)
• Added/updated dependency submodules (metal-cpp, libultrahdr) and Windows support integration (7ffd7c5, 65e1372)
• Removed unnecessary third_party folder cleanup (b8c2fa3)

更新日志

[0.2.0] (03344c0..b8c2fa3) — 2026-03-07 ~ 2026-03-14

新功能

• 跨平台渲染扩展：新增 macOS 编译支持并完成 Metal 流水线集成（简述：Raw/缩放/镜头校正能力接入、流水线贯通，以及性能优化与重构） (5eed41d, 0a37cfa, aefa6f0)
• macOS 新增功能：新增 macOS 基础色彩管理与实验性 HDR 支持，支持导出 Ultra HDR 格式的 JPEG 文件 (880234c, 4c879c3)
• Windows 功能更新：将 Windows 预览 Surface 移植到 D3D11 并且增加 Ultra HDR 导出功能 (3a079ad)
• 国际化支持：新增 i18n、优化语言选择 UI，并更新 zh-CN 字体 (2caeaed, 9657bf5, 44b5401)
• 新示波与控制能力：新增直方图/波形显示、画幅比例选择、缩略图等待动画，以及重置调整支持 (5f47c71, e559e1e, 85a4440, 2c18f7f)
• 版本信息界面优化：改进 versioning UI 设计 (a0a5931)
• 改动重置支持：支持用户通过双击滑块来重置调整参数。

缺陷修复

• Windows 构建稳定性：修复跨平台集成过程中多处 Windows 编译问题 (e794c4e, a6d8968, 2eca003, 4f89c41)
• Metal 流水线路径修复：修复 Metal 中几何管线路径错误 (34242aa)
• 渲染器包含路径修复：修复 OpenGL viewer renderer 的 include/path 处理 (cefe155)
• 编辑器背景问题：修复重置调整流程中的编辑器背景问题 (2c18f7f)

Known Issues

v0.2.0

Common Issues

Pipeline

• Only support Bayer RAW images with RGGB pattern. Support for other patterns will be added in future releases.
• Nikon's High Efficiency Compressed RAW format is currently not supported. You can convert these files to DNG format to use them in the app.
• Lens correction will fail if the focal length data is not properly read by the metadata parser. This issue frequently occurs on Canon mirrorless cameras.
• Color Temp/Tint adjustments will fail if the camera model is not properly read by the metadata parser. This issue may occur on some mobile devices.
• ACES 2.0 does not support HDR processing, where the peak luminance option is currently broken.
• Histogram/Waveform display may not be rendered when switching between two scopes. You can workaround this issue by dragging a slider in the control panel to trigger a re-render.

Versioning

• Version switching may cause LUT to be applied incorrectly. You can solve this by re-selecting the LUT in the control panel.
• The versioning UI is too compact to display long version names.
• The "Plain" version does not reset adjustments to default values at all. Use "Incremental" version instead.

Assets Management

• If you have imported unsupported images, the thumbnail will not be generated. You can delete this image from the project and re-import it after the issue is fixed in future releases.
• If you have delete an image from your disk, the current implementation will not be able to relink the image, and all adjustments will be lost.
• The project file is not backward compatible. Please do not open a project created in v0.1.2 or earlier versions, as it may behave unexpectedly.

Other Issues

• Some texts miss localization and may appear in English even if you have set the app to another language.

Windows Issues

• The HDR preview is not available on Windows due to a technical limitation in the current implementation. But you can still export Ultra HDR images when you set the DRT to P3/ST2084 or Rec. 2020/ST2084.
• Does not support Color Management System (CMS) on Windows. If you use a wide-gamut monitor, limit your monitor to sRGB. Otherwise, the output colors may be inaccurate as the output image will not be properly tagged with the correct color space. This issue will be fixed in future releases.
• Please update your GPU drivers to the latest version. The minimum required GPU driver version is 570.xx. Older drivers will cause crashes.

macOS Issues

• I only have access to a MacBook Air M4 running macOS Tahoe (macOS 26), so I can only test the app on this specific hardware and software configuration. The app is built for Apple Silicon. If you encounter any issues on other ARM Mac models or macOS versions that support Metal, please report them to me, and I will try to fix them in future releases.
• Since I haven't enrolled in the Apple Developer Program, the app is NOT signed and notarized. It will be blocked by macOS's safety measures. Workaround may exist but will not be discussed here. It is recommended to build the app from source code if you are concerned about security.
• The HDR preview and color management IS available on macOS, and the export images will be tagged with the color space you choose in the DRT settings. However, the UI color will be inaccurate if you are using a color space other than sRGB, as the app does not support color management in the UI.
• It is recommended to have 16GB of RAM for the app to run smoothly. The app may perform poorly or even crash on machines with less RAM, especially when processing large images.
• Histogram/Waveform is not available yet.

已知问题

v0.2.0

常见问题

编辑流程

• 目前仅支持 RGGB 排列的 Bayer RAW 图像，其他排列的支持将会在未来版本中添加。
• 尼康高效率压缩 RAW 格式目前不受支持。你可以将这些文件转换为 DNG 格式以在应用中使用。
• 如果元数据解析器未正确读取焦距数据，镜头校正将会失败。这个问题经常发生在佳能无反相机上。
• 如果元数据解析器未正确读取相机型号，色温/色调调整将会失败。这个问题可能会发生在一些移动设备上。
• ACES 2.0 不支持 HDR 处理，目前峰值亮度选项是无效的。
• 切换两个波形图时，它们可能无法立即渲染。你可以通过在下方面板中拖动一个滑块来触发重新渲染以解决这个问题。

版本控制

• 切换版本可能会导致 LUT 应用不正确。你可以通过在控制面板中重新选择 LUT 来解决这个问题。
• 版本控制界面过于紧凑，无法显示较长的版本名称。
• "Plain" 版本根本不会将调整重置为默认值。请改用 "Incremental" 版本。

资源管理

• 如果你导入了不受支持的图像（例如，JPEG, TIFF，尼康高效率压缩RAW），将无法生成缩略图。你可以从项目中删除这个图像，并在未来版本修复这个问题后重新导入它。
• 如果你从磁盘中删除了一个图像，当前的实现将无法重新链接这个图像，并且所有调整都将丢失。
• 项目文件不向后兼容。请不要打开在 v0.1.2 或更早版本中创建的项目，因为它可能会表现异常。

其他问题

• 一些文本缺乏中文翻译，即使你将应用设置为其他语言，它们也可能以英文显示。

Windows 问题

• 由于当前实现的技术限制，HDR 预览在 Windows 上不可用。但当你将 DRT 设置为 P3/ST2084 或 Rec.2020/ST2084 时，你仍然可以导出 Ultra HDR 图像。
• Windows 上不支持颜色管理系统（CMS）。如果你使用宽色域显示器，请将显示器限制在 sRGB。否则，预览颜色可能不准确，并且输出图像将不会正确标记为正确的色彩空间。这个问题将在未来版本中修复。
• 请将你的 GPU 驱动程序更新到最新版本。最低要求的 GPU 驱动程序版本是 570.xx。较旧的驱动程序将导致崩溃。

macOS 问题

• 我只有一台运行 macOS Tahoe (macOS 26) 的 MacBook Air M4，因此我只能在这个特定的硬件和软件配置上测试应用。该应用为 Apple Silicon 构建。如果你在其他支持 Metal 的 ARM Mac 型号或 macOS 版本上遇到任何问题，请向我报告。
• 由于我没有加入 Apple Developer Program，应用未签名和未公证。它将被 macOS 的安全措施阻止启动。可能存在解决方法，但这里不会讨论。如果你担心安全问题，建议从源代码构建应用。
• HDR 预览和颜色管理在 macOS 上可用，并且导出图像将被标记为你在 DRT 设置中选择的色彩空间。然而，如果你使用非 sRGB 的色彩空间，UI 颜色将不准确，因为应用不支持 UI 中的颜色管理。
• 直方图和波形图现不可用