First release

[zidage]

The first release version of Pu-erh Lab is here.

Execute bin/puerhlab_main.exe to run your application.

Known Issues：

Pipeline

• Only support RGGB Bayer pattern RAW files for now (kind of sucks). The supported camera list is consistent with LibRaw 0.22.0, excluding some Fujifilm X-Trans models and some non-RGGB models (e.g. Panasonic LUMIX S1R). The detailed list can be found in the LibRaw documentation. This also means that JPEG and TIFF files are not supported for importing and editing, but they can be exported from the app.
• For some newer camera models, image can exhibit black margins, incorrect white balance, or even fail to load due to the lack of support in the current LibRaw version. This is expected to be resolved by integrating a newer LibRaw version in the future. Even though the image may be properly processed, exported file may still miss EXIF metadata due to the same reason.
• The highlight reconstruction algorithm, which is adapted from darktable's "inpaint opposed" method, can produce visible artifacts in extreme cases (e.g., large blown-out areas). A "disable" option is planned for the future, and a more robust method may be implemented later on (depends on how capable the future LLM models are).
• Version control still does not support branching yet, and the current implementation may fail when choosing between different versions with different LUT settings, where the LUT may not be properly applied to the preview. This can be fixed by reapplying the LUT or waiting for the future fix.
• CDL color wheels may be a little bit too sensitive to mouse dragging.
• When contrast is set to -100, the image will be completely black.
• If you are editing a photo with a sunset scene, the color of the sky may not be ideal due to ACES's handling of out-of-gamut colors. This can be mitigatd by using "Default_LMT" LUT from aces-looks, which emulates a ACES 1.3 look that "fixes" the sunset color issue.

Asset Management

• The current UI does not support deleting a single image from the library nor does it support moving images between folders. The underlying API does support these operations, but the UI for them is not implemented yet.
• If you import a unsupported RAW file, it is possible that the library will be broken and fail to load in the future. So please make sure to only import supported RAW files for now. A more robust handling of unsupported files is planned for the future.
• Because I don't have that many RAW photos, say, 10000+ to test with, the usability of the library under that scale is still unknown. If you have a large collection of RAW files and are willing to test the library with it, please feel free to try it out and report any issues you encounter.
• Thumbnail generation may encounter some data race issues that can cause a abnormal look of the generated thumbnails. But the editing session and the exported image will not be affected.
• If you are using a non-English Windows system and have not enabled the "Use Unicode UTF-8 for worldwide language support" option in the system settings, it is possible that the app will crash when encountering non-ASCII file paths. If you can't enable the UTF-8 support due to compatibility concerns, please make sure to only use ASCII characters in the file paths for now, including the installation path, library path, each imported image's path and export path.

普洱工坊的第一个发布版在这里了
双击bin/puerhlab_main.exe运行

已知问题（v0.1.0）

影像处理管线

• 目前仅支持 RGGB 拜尔阵列 的 RAW 文件（有点惨）。支持的相机列表与 LibRaw 0.22.0 一致，但除去使用 X-Trans 传感器的部分富士机型和一些非 RGGB 模式的机型（例如松下 LUMIX S1R）。详细列表可以在 LibRaw 文档 中找到。这也意味着 JPEG 和 TIFF 文件目前不支持导入和编辑。
• 对于一些较新的相机型号，由于当前 LibRaw 版本缺乏支持，图像可能会出现黑色边缘、白平衡不正确，甚至无法加载的问题。这预计将在未来集成更新的 LibRaw 版本后得到解决。在此情况下，即使图像可以正确处理，导出的文件可能仍然缺少 EXIF 元数据。
• 适配自 darktable 的“inpaint opposed”方法的高光重建算法在极端情况下（例如大面积过曝）可能会产生明显的伪影（artifacts）。未来计划提供一个“禁用”选项，并且可能会实现一个更牛的方法（估计得取决于未来 LLM 的能力了）。
• 版本控制目前还不支持分支，且在不同版本之间切换时可能会遇到预览中 LUT 没有正确应用的问题。可以通过重新应用 LUT 或等待未来的修复来解决这个问题。
• CDL 色轮可能对鼠标拖动有点过于敏感，一拖就变成RGB灯了。
• 在对比度调整为-100时，图像会变黑。
• 不支持用 Ctrl + Z 撤销，只能鼠标点那个Undo。
• 如果你编辑的是带有夕阳场景的照片，由于 ACES 2 对超出色域颜色的处理方式，天空的颜色可能开启来有点偏三文鱼色。可以通过使用 aces-looks 提供的 "Default_LMT" LUT 来缓解这个问题，该 LUT 模拟了 ACES 1.3 的外观，可以“修复”夕阳颜色问题。

资产管理

• 目前 UI 不支持从库中删除单张图片，也不支持在文件夹之间移动图片。底层 API 支持这些操作，但 UI 尚未实现。
• 如果导入了不受支持的 RAW 文件，可能会导致库损坏并在未来无法加载。因此请确保目前仅导入受支持的 RAW 文件。未来计划提供更健壮的处理方式。
• 由于我没有那么多 RAW 照片（比如说 10000+）来测试，库在那个规模下的可用性仍然未知。如果你有大量 RAW 文件并且愿意测试库的表现，请随时尝试并报告你遇到的任何问题。
• 缩略图生成可能会遇到一些数据竞争问题，导致生成的缩略图出现异常。但编辑会话和导出的图像不会受到这个问题的影响。
• 如果你使用的是非英文 Windows 系统，并且没有启用系统设置中的“为全球语言支持使用 Unicode UTF-8”选项，可能会在遇到非 ASCII 文件路径时导致应用程序崩溃。如果由于兼容性问题无法启用 UTF-8 支持，请确保目前仅在文件路径中使用 ASCII 字符，包括安装路径、库路径、每个导入图像的路径和导出路径。

---

This discussion was created from the release First release.

[ap0307226]

Lensfun 是不是依赖一个名为 GLib 的第三方库，我真的加载不下去了。。。。。。。

[zidage]

是的

[ap0307226]

过了，原来是VCPKG和lensfun之间的版本问题，导致的

[ap0307226]

另外一个问题，这个D:\PuerhLab\pu-erh_lab\src\utils\string\converter.cpp(18,10): fatal error C1083: 无法打开包括文件: “utf8/checked.h”: No such f
ile or directory [D:\PuerhLab\build\pu-erh_lab\src\StrConv.vcxproj]，一直在报错，咋解决

[zidage]

目前这个情况应该是缺少utfcpp这个库导致的。我后续有时间会编写自行编译的具体步骤，抱歉目前的这个不太全。

当前最好参照CMakeLists中的内容配置相关依赖，具体的依赖列表可参见third_party_license中的内容。

[ap0307226]

找到了CMakeLists是utf8/checked.h，这个D:\PuerhLab\pu-erh_lab\vcpkg\installed\x64-windows\include\utf8cpp\utf8路径有问题

[zidage]

这个库不需要用vcpkg安装，但需要自行去原仓库把文件放到third_party/utfcpp下