zidage/AlcedoStudio
Open-source RAW photo processing and digital asset management software.
📦 新功能
- 胶片颗粒与 Halation 效果:新增胶片颗粒密度/粒度控制和 Halation 算子,接入编辑历史,并将效果流水线扩展到 CPU/CUDA/OpenCL/Metal 路径,补齐多后端一致性。(`514a667`, `5803529`, `e943264`, `c0b3043`, `6c19966`, `15d9228`, `6f24a66`, `f614dae`, `c84016b`, `bac945c`, `97778e7`)
- 语义 AI 生成与搜索:新增图像内容识别、AI 标签生成、多模型支持、多语言/Jina CLIP 路径、标签搜索/过滤、语义搜索分发、VSS/HNSW 存储、标签提示词优化、标签分配逻辑优化,以及未使用模型标签清理。(`0304551`, `ee94c48`, `84ad809`, `9d13093`, `c152e86`, `529e587`, `7a3b3ea`, `3745126`, `4e06e46`, `3baaad7`, `6b24957`)
- 模型下载与激活流程:新增模型下载器 UI、基于 aria2c 的下载服务、生成 ETA 显示、下载/激活体验优化、模型激活提示,以及专用的激活对话框。(`a20a1ba`, `100a4a8`, `157eb5`, `70af466`, `882ce4b`, `0444a80`, `b0029c`)
- RAW 与相机兼容性:通过 patched LibRaw 路径加入 Nikon HE/HE* 支持,更新 LibRaw submodule,并为 macOS 加入原生 CoreML 模型支持。(`419fb74`, `3880f2c`, `5f7e288`, `631fb11`, `b7d50a1`)
- 编辑器效率改进:新增 LUT 收藏、可折叠编辑分区,以及应用 About 面板。(`9570898`, `0d41c03`, `81ea7d6`)
📦 界面
- AI 工作流打磨:改进 AI 标签生成界面、标签展示、文件信息展示、模型切换说明、模型激活提示,以及生成/下载反馈。(`aa53477`, `223c24d`, `3bd23ce`, `c41b24a`, `70af466`, `0444a80`, `b0029c`)
- 网站更新:更新网站设计、文案、截图和 0.2.6 发布信息。(`0028db6`, `a0d4c01`)
📦 性能优化
- 语义数据与模型流水线提速:改进异步模型执行,优化数据库插入,移除冗余数据复制,并重构后端路径以更好支持多模型。(`bce8b9e`, `9c800f9`, `f1ec59f`, `99be227`)
- GPU 处理优化:优化 Metal 高光/阴影调整性能,并改进胶片颗粒算法。(`7206724`, `97778e7`)
📦 缺陷修复
- 发布与打包稳定性:修复 macOS 安装依赖解析与校验、包含 HNSW 的项目包保存、CI 编译失败、VSS 配置缺失、Windows/macOS 模型打包范围、Windows 安装脚本准备,以及进程退出码上报问题。(`9cc06a3`, `60faf7e`, `8a688cd`, `66c306e`, `8493f02`, `4878464`, `c4cf768`)
- RAW、编辑器与 GPU 稳定性:修复 CUDA 高光恢复运行时切换失败、编辑器死锁/卡死、随机非法内存访问、LibRaw 相关段错误,以及部分相机裁切偏移错误。(`9cc0da9`, `48bf884`, `7cf756c`, `5aea74b`, `2d4ca5a`, `3880f2c`, `4262737`)
- AI/模型正确性:修复 AI 面板生成时机、aria2c 重试逻辑、模型名称显示不一致、标签数量过多、数据库连接所有权,以及语义分支合并冲突引入的回归。(`60255ae`, `622c06d`, `102e4d5`, `2936946`, `cf5a823`, `6a756c5`, `bb0852f`)
📦 文档
- 新增语义生成/搜索规划、CUDA Halation/胶片颗粒合并交接说明、网站文案更新、赞助元数据,以及 macOS/Windows 安装树校验相关发布工程脚本。(`7b045c2`, `8f0004a`, `0028db6`, `a0d4c01`, `5ef4433`, `4878464`)
✨ Features
- Film grain and halation effects: Added film grain density/granularity controls and halation operators, wired them into edit history, and brought the effect pipeline across CPU/CUDA/OpenCL/Metal paths with backend alignment work. (`514a667`, `5803529`, `e943264`, `c0b3043`, `6c19966`, `15d9228`, `6f24a66`, `f614dae`, `c84016b`, `bac945c`, `97778e7`)
- Semantic AI generation and search: Added semantic image content detection, AI label generation with multiple model support, multilingual/Jina CLIP handling, label search/filter, semantic search dispatching, VSS/HNSW storage, better label prompts, label assignment improvements, and pruning for unused model labels. (`0304551`, `ee94c48`, `84ad809`, `9d13093`, `c152e86`, `529e587`, `7a3b3ea`, `3745126`, `4e06e46`, `3baaad7`, `6b24957`)
- Model download and activation workflow: Added the model downloader UI, aria2c-based download service, ETA display during generation, model download/activation UX improvements, activation prompts, and a dedicated activation dialog. (`a20a1ba`, `100a4a8`, `157eb5`, `70af466`, `882ce4b`, `0444a80`, `b0029c`)
- RAW and camera compatibility: Added Nikon HE/HE* support through a patched LibRaw path, updated the LibRaw submodule, and added native CoreML model support on macOS. (`419fb74`, `3880f2c`, `5f7e288`, `631fb11`, `b7d50a1`)
- Editor productivity polish: Added LUT favorites, collapsible edit sections, and an About panel for the application. (`9570898`, `0d41c03`, `81ea7d6`)
📦 UI
- AI workflow polish: Improved AI label generation UI, tag display, file information display, model switching clarity, model activation prompts, and generation/download feedback. (`aa53477`, `223c24d`, `3bd23ce`, `c41b24a`, `70af466`, `0444a80`, `b0029c`)
- Website refresh: Updated website design, copy, screenshots, and release information for the 0.2.6 cycle. (`0028db6`, `a0d4c01`)
⚡ Performance
- Semantic data and model pipeline speedups: Improved async model execution, optimized database insertion, removed redundant data copies, and refactored backend paths for better multimodel support. (`bce8b9e`, `9c800f9`, `f1ec59f`, `99be227`)
- GPU processing optimizations: Optimized Metal Highlights/Shadows adjustment performance and improved the film grain algorithm. (`7206724`, `97778e7`)
🐛 Bug Fixes
- Release and packaging stability: Fixed macOS install dependency resolution and verification, HNSW project packaging, CI compile failures, missing VSS setup, Windows/macOS model packaging scope, Windows install script preparation, and process exit-code reporting. (`9cc06a3`, `60faf7e`, `8a688cd`, `66c306e`, `8493f02`, `4878464`, `c4cf768`)
- RAW, editor, and GPU stability: Fixed CUDA highlight reconstruction runtime-switch failures, editor deadlocks/freezes, random illegal memory access, LibRaw-related segmentation faults, and incorrect crop offsets for some cameras. (`9cc0da9`, `48bf884`, `7cf756c`, `5aea74b`, `2d4ca5a`, `3880f2c`, `4262737`)
- AI/model correctness: Fixed AI panel generation timing, aria2c retry handling, model-name display inconsistencies, excessive label counts, DB connection ownership, and merge-conflict regressions in the semantic branch. (`60255ae`, `622c06d`, `102e4d5`, `2936946`, `cf5a823`, `6a756c5`, `bb0852f`)
📝 Documentation
- Added semantic generation/search planning, CUDA halation/film-grain merge handoff notes, website text updates, sponsorship metadata, and release engineering scripts for macOS/Windows install-tree verification. (`7b045c2`, `8f0004a`, `0028db6`, `a0d4c01`, `5ef4433`, `4878464`)
✨ Features
- Highlights/Shadows local tone overhaul: Rebuilt the Highlights and Shadows adjustment around LLF-style local tone processing, stronger shadow detail recovery, better highlight strength scaling, and more consistent CUDA/OpenCL/Metal behavior. (`2b232fc`, `1bf39fd`, `b7263e1`, `8fc7adb`, `61b4b30`, `06dcef5`)
- Color mixer quality upgrade: Migrated the color adjustment path toward OKLCh, refactored HLS/chroma handling, and fused saturation work into the shared color kernels for smoother hue/saturation edits. (`892e34b`, `6d91abe`, `4ea033b`)
- Batch adjustment transfer: Added copy/paste adjustment transfer from the album workflow, including merge/paste modes, clearer dialog copy, and service-level tests for preserving version history. (`3e00552`, `a010503`)
- HDR export overhaul: Reworked HDR export metadata, SDR/HDR parameter handling, UltraHDR writer paths, export queue UI, and writer coverage for more reliable HDR output. (`7a3cd51`)
📦 UI
- Geometry/crop panel refactor: Reorganized crop, rotation, reset, and geometry controls into a clearer dedicated panel with updated editor/viewer interaction coverage. (`44f686d`)
- Preview and interaction polish: Added point-to-point zoom preview scaling and improved tone slider settled-state handling for more stable continuous edits. (`9a09948`, `38b4046`)
⚡ Performance
- Local tone mapping performance: Optimized LLF execution, Metal local tone mapping, and mask resolution bounds to reduce cost while preserving quality. (`f079b56`, `839f2e1`, `908aeee`, `9ac5d55`)
🐛 Bug Fixes
- Preview and cache correctness: Fixed ROI request failures during H/S and geometry edits, LLF blending across ROI/resolution changes, simplified masking cache behavior, and corrected tone-mapping mask cache consistency. (`4001c1c`, `f4ba2c0`, `ac073cb`, `42ed19b`)
- Workflow state fixes: Fixed DRT parameter loss during adjustment overwrite, album rating scroll-position resets, and light theme inconsistencies. (`2e776de`, `82ffbba`, `8489e4c`)
- macOS and CI stability: Fixed macOS compile issues, macOS HDR preview overexposure, third-party dependency wiring, and CI compile/test coverage. (`15b1101`, `bb29bc1`, `cdd30dd`, `dca770f`)
📦 新功能
- 高光阴影局部色调重构:围绕 LLF 风格局部色调处理重建高光/阴影调整,增强暗部细节恢复、高光力度控制,并统一 CUDA/OpenCL/Metal 路径表现。(`2b232fc`, `1bf39fd`, `b7263e1`, `8fc7adb`, `61b4b30`, `06dcef5`)
- 混色器质量升级:将色彩调整路径迁移到 OKLCh 思路,重构 HLS/色度处理,并把饱和度处理融合进共享色彩 kernel,改善色相与饱和度调整稳定性。(`892e34b`, `6d91abe`, `4ea033b`)
- 批处理参数复制/粘贴:新增相册侧调整参数复制与粘贴流程,支持 merge/paste 策略、清晰的对话框说明,以及保留版本历史的服务层测试。(`3e00552`, `a010503`)
- HDR 导出重构:重做 HDR 导出元数据、SDR/HDR 参数处理、UltraHDR 写出路径、导出队列 UI 与 writer 测试覆盖,提升 HDR 输出可靠性。(`7a3cd51`)
📦 界面
- 几何/裁切面板重构:将裁切、旋转、重置与几何控制整理到更清晰的专用面板,并补充编辑器/预览交互覆盖。(`44f686d`)
- 预览与交互打磨:新增点对点放大预览缩放,并改进色调滑块 settled 状态处理,让连续调整更稳定。(`9a09948`, `38b4046`)
📦 性能优化
- 局部色调性能优化:优化 LLF 执行、Metal 局部色调映射与遮罩分辨率上限,在保持质量的同时降低处理成本。(`f079b56`, `839f2e1`, `908aeee`, `9ac5d55`)
📦 缺陷修复
- 预览与缓存正确性:修复高光阴影/几何调整时 ROI 请求失效、不同 ROI/分辨率下 LLF 混合不一致、遮罩缓存策略复杂化,以及 tone mapping 遮罩缓存不一致问题。(`4001c1c`, `f4ba2c0`, `ac073cb`, `42ed19b`)
- 工作流状态修复:修复调整参数覆盖时 DRT 参数丢失、相册评分导致滚动位置重置,以及不同系统主题下应用主题不一致的问题。(`2e776de`, `82ffbba`, `8489e4c`)
- macOS 与 CI 稳定性:修复 macOS 编译问题、macOS HDR 预览过曝、第三方依赖管理与 CI 编译/测试覆盖问题。(`15b1101`, `bb29bc1`, `cdd30dd`, `dca770f`)
📦 新功能
- 以 Pull Request 为主的新功能合并流程:本轮版本开始,主要功能通过 PR 合并进入主线,包括编辑器重构、OpenCL 后端、集合改造、缩略图缓存、高级搜索、加载体验与数据库性能优化等。(`8d09af8`, `9babfb0`, `2548cd4`, `d359241`, `81ad481`, `ed9d3b7`, `d4090f3`, `54ab6d1`, `0ee2835`, `a3575d3`)
- OpenCL 加速路径:新增 OpenCL 图像容器、上下文/程序库管理、RAW 处理、点运算/线性参考空间算子、高光恢复、带 3D LUT 的 LMT、DRT、几何与镜头校正、DNG warp rectilinear、示波器分析、OpenGL 共享、运行时后端切换,以及 OpenCL shader 的安装与源码路径解析。(`590930a`, `ac9cbb8`, `e57ffbd`, `d9522de`, `03cf061`, `8d897b3`, `1b30204`, `771d45c`, `034cf0b`, `5b17d6d`, `a2acab9`, `21aa488`)
- 编辑器面板重构:将编辑器状态与面板职责拆分到色调、RAW 解码、几何、DRT、色彩、版本等专用组件中,引入 render session / coordinator 结构,新增更多 ODT 选项,并调整高级参数折叠面板行为。(`aaa25e0`, `078910c`, `b50bf70`, `1dedfb1`, `7eb3fe1`, `6b391fa`, `7845476`, `b2949ed`, `6415d10`, `f934633`, `2660a11`)
- 版本管理与项目包升级:重构编辑历史语义,加入 log-only versioning、Merkle tree 版本哈希、项目 UUID 持久化、项目文件版本/校验和校验、数据库校验和计算,并重构项目包保存/加载逻辑。(`387edbf`, `8bc35ee`, `e9e39ba`, `4d8b67a`, `b43e43b`, `2baaae8`, `ccebd09`)
- 相册集合与 Sleeve 服务:重构集合成员关系、文件夹列表、分页、筛选服务集成、缓存失效、导入根目录校验、schema 加固、重复文件/历史管理,以及数据库批量新增/删除接口。(`a54358f`, `0a77e71`, `4dacf2a`, `435141b`, `5964e73`, `4f0136c`, `e370d12`)
- 图片评分与高级搜索:新增全应用星级评分、评分筛选、相册统计集成、带模糊/精确模式的全局搜索,改进全局搜索面板,并加入缩略图网格缩放与布局动画控制。(`d2ce4b7`, `8baf1ba`, `29aefb1`, `4ead40f`, `18bd093`, `f7b2611`)
- 缩略图缓存与加载体验:新增 `AlbumThumbnailModel`、磁盘缩略图缓存、按分辨率区分的缩略图请求、8-bit 缩略图存储,改进缩略图加载/选择行为,并优化项目与 OpenCL 加载状态。(`1c36515`, `83368da`, `618c5f6`, `553274e`, `43daa9e`, `b30c463`, `26c3d25`, `11c2ade`, `88cd276`)
📦 界面
- 编辑器与元数据界面优化:改进图片详情对话框的本地化与布局,将数据显示字体切换为 IBM Plex,把色温状态迁移到色调面板,并修复 LUT 选择重置问题。(`b2956bb`, `cbb992c`, `55f4d87`, `c3a95f8`)
- 网站与发布体验优化:更新网站下载链接与 macOS 安装脚本,其中包括 macOS 包中随附 LUT 资源。(`99ba3b8`, `1567f0e`, `3f51efb`)
📦 性能优化
- 数据库与浏览性能:新增数据库批量写入接口,并优化集合、搜索、缩略图模型路径,减少大型项目浏览时的 UI 卡顿。(`e370d12`, `26c3d25`, `a3575d3`)
- 流水线与缩略图生命周期优化:重构 pipeline frame sink 的挂载与生命周期管理,区分不同缩略图分辨率,移除重复图像加载,并补充针对 sink 与缓存行为的单元测试。(`63258c0`, `d6dd172`, `0d1b2bf`, `19e9b05`)
📦 缺陷修复
- Metal 与 RAW 处理修复:修复 macOS/OpenCL 编译问题、Metal RCD 与镜头校正 shader 行为、CUDA RCD 边界处理、lensfun 校正对齐,以及 Metal RCD 测试断言。(`a5436da`, `1fa062b`, `25ad658`, `107dcbd`, `fc97b01`, `a21d7ac`)
- 项目与缩略图稳定性:修复校验和不匹配时的项目加载、缩略图生成崩溃、全局搜索缩略图缺失,以及 LUT 选择重置异常。(`83a8e50`, `cf659da`, `d0ffe14`, `c3a95f8`)
- macOS CI 与打包稳定性:新增 CI workflow,并修复 macOS CI/runtime 中的 OpenMP、third-party CMake、测试编译、lensfun 编译/rpath、本地 OpenMP runtime 等问题。(`2351cea`, `2a76a46`, `7adf31b`, `4e6c1c6`, `a34e826`, `a4349da`, `b57bcbf`, `65c6698`, `977a93a`)
📦 其他
- WebGPU 路径退场:在评估后移除实验性 WebGPU RAW 处理路径,并将 GPU 后端工作转向 OpenCL。(`884cf15`)
- 文档与规划:新增编辑器、pipeline frame sink、Sleeve 相册成员关系等重构计划,并补充集合重构阶段状态。(`b57e39f`, `88afee4`, `7ad0363`, `aa9f3db`, `afce1df`)
- 打包范围:Windows 与 macOS 包现在只随附 Kodak、Fuji、Agfa 三组精选 `.cube` LUT,排除 `spektrafilm` 与其他旧示例 LUT。
✨ Features
- PR-based feature integration: Starting with this release cycle, new capabilities were primarily landed through pull requests, including editor refactors, OpenCL backend work, collection updates, thumbnail caching, advanced search, loading polish, and database performance improvements. (`8d09af8`, `9babfb0`, `2548cd4`, `d359241`, `81ad481`, `ed9d3b7`, `d4090f3`, `54ab6d1`, `0ee2835`, `a3575d3`)
- OpenCL acceleration path: Added OpenCL image containers, context/program management, RAW processing, point/linear-reference operators, highlight reconstruction, LMT with 3D LUT support, DRT operators, geometry/lens-calibration support, DNG warp rectilinear handling, scope analysis, OpenGL sharing, runtime backend switching, and packaging/source-path resolution for OpenCL shader assets. (`590930a`, `ac9cbb8`, `e57ffbd`, `d9522de`, `03cf061`, `8d897b3`, `1b30204`, `771d45c`, `034cf0b`, `5b17d6d`, `a2acab9`, `21aa488`)
- Editor panel refactor: Split editor state and panel ownership into dedicated tone, RAW decoding, geometry, DRT, color, and versioning components; introduced the render session/coordinator structure; added more ODT options and refreshed advanced-parameter accordion behavior. (`aaa25e0`, `078910c`, `b50bf70`, `1dedfb1`, `7eb3fe1`, `6b391fa`, `7845476`, `b2949ed`, `6415d10`, `f934633`, `2660a11`)
- Versioning and project package upgrades: Reworked edit-history semantics with log-only versioning support, Merkle-tree version hashes, UUID persistence, project file version/checksum validation, database checksum computation, and refactored project package save/load behavior. (`387edbf`, `8bc35ee`, `e9e39ba`, `4d8b67a`, `b43e43b`, `2baaae8`, `ccebd09`)
- Album collections and Sleeve services: Overhauled collection membership, folder listing, pagination, filter-service integration, cache invalidation, import root validation, schema hardening, duplicate/history handling, and batch database add/delete interfaces. (`a54358f`, `0a77e71`, `4dacf2a`, `435141b`, `5964e73`, `4f0136c`, `e370d12`)
- Image rating and advanced search: Added application-wide star ratings, rating filters, album statistics integration, global search with fuzzy and exact modes, improved global-search panel behavior, and thumbnail/grid zoom and layout animation controls. (`d2ce4b7`, `8baf1ba`, `29aefb1`, `4ead40f`, `18bd093`, `f7b2611`)
- Thumbnail cache and loading experience: Introduced `AlbumThumbnailModel`, disk-backed thumbnail caching, resolution-separated thumbnail requests, 8-bit thumbnail storage, improved thumbnail loading/selection behavior, and smoother project/OpenCL loading states. (`1c36515`, `83368da`, `618c5f6`, `553274e`, `43daa9e`, `b30c463`, `26c3d25`, `11c2ade`, `88cd276`)
📦 UI
- Editor and metadata UI polish: Improved image details dialog i18n and layout, switched data display typography to IBM Plex, moved color-temperature state into the tone panel, and fixed LUT selection reset behavior. (`b2956bb`, `cbb992c`, `55f4d87`, `c3a95f8`)
- Website and distribution polish: Updated website download links and macOS installation scripts, including LUT asset shipping for macOS packages. (`99ba3b8`, `1567f0e`, `3f51efb`)
⚡ Performance
- Database and browser performance: Added batch database mutation APIs and optimized collection/search/thumbnail model paths to reduce UI stalls during large project browsing. (`e370d12`, `26c3d25`, `a3575d3`)
- Pipeline and thumbnail lifecycle improvements: Refactored pipeline frame-sink attachment/lifecycle management, separated thumbnail resolutions, removed redundant image loading, and added targeted unit coverage for sink and cache behavior. (`63258c0`, `d6dd172`, `0d1b2bf`, `19e9b05`)
🐛 Bug Fixes
- Metal and RAW processing fixes: Fixed macOS/OpenCL compile issues, Metal RCD and lens-calibration shader behavior, CUDA RCD margin handling, lensfun correction alignment, and Metal RCD test assertions. (`a5436da`, `1fa062b`, `25ad658`, `107dcbd`, `fc97b01`, `a21d7ac`)
- Project and thumbnail stability: Fixed project loading around checksum mismatches, thumbnail-generation crashes, global-search missing thumbnails, and LUT selection reset discrepancies. (`83a8e50`, `cf659da`, `d0ffe14`, `c3a95f8`)
- macOS CI and packaging stability: Added CI workflow and fixed macOS CI/runtime failures around OpenMP, third-party CMake wiring, test builds, lensfun compile/rpath handling, and local OpenMP runtime behavior. (`2351cea`, `2a76a46`, `7adf31b`, `4e6c1c6`, `a34e826`, `a4349da`, `b57bcbf`, `65c6698`, `977a93a`)
📦 Miscellaneous
- WebGPU path retired: Removed the experimental WebGPU RAW processing path after evaluating it, and redirected GPU backend work toward OpenCL. (`884cf15`)
- Documentation and planning: Added editor, pipeline frame-sink, and sleeve album-membership refactor plans, plus phase status updates for the collection refactor. (`b57e39f`, `88afee4`, `7ad0363`, `aa9f3db`, `afce1df`)
- Packaging scope: Windows and macOS packages now ship only the curated Kodak, Fuji, and Agfa `.cube` LUTs, excluding `spektrafilm` and other legacy sample LUTs.
📋 Changes
- 更清爽的工作空间 — 移除了操作系统窗口边框,主界面更沉浸;欢迎面板也做了重新设计。
- 修复了Ultra HDR的依赖丢失问题。
- 直出色彩优化 — 基于 [rawtoaces](https://github.com/AcademySoftwareFoundation/rawtoaces) 光谱数据重新生成了部分相机的色彩矩阵,具体支持相机列表详见[rawtoaces-data](https://github.com/AcademySoftwareFoundation/rawtoaces-data/tree/main/data/camera),让支持的机型在 RAW 解码阶段在部分场景获得了更“精准”的颜色还原。
- 更顺手的导出与界面 — 导出选项的选择逻辑更智能,选中动画更舒服,同时修掉了 macOS 按钮图标缺失、导入背景错误、删除按钮布局、滚动时选中项消失等恼人的小问题。
- 现在macOS版本LUT将随安装包分发,并且修复了LUTs文件夹打包途中丢失的问题。
- Cleaner workspace — We ditched the OS window chrome for a sleeker, borderless main interface and gave the welcome panel a fresh coat of paint.
- Fix Ultra HDR dependency missing issue.
- CCM optimization — Camera color matrices have been regenerated from [rawtoaces](https://github.com/AcademySoftwareFoundation/rawtoaces) spectral data, improving color "fidelity" in some cases for [supported cameras](https://github.com/AcademySoftwareFoundation/rawtoaces-data/tree/main/data/camera) right at the RAW development stage.
- + 2 more
📋 Changes
- 重构了UI风格与逻辑,配色更柔和,交互更加直观。
- 内置了由各胶片技术手册生成的胶片模拟LUT预设。通过[spectral_film_lut](https://github.com/JanLohse/spectral_film_lut)将胶片数据手册数字化,然后用光谱物理模型来模拟光线进入胶片、曝光、冲洗、印放的全过程来生成LUT。我在原版基础上增加了对本项目场景参考管线的支持,保留下了负片极为宽广的高光宽容度。
- 支持LOD渲染,哪怕是1.5亿像素的巨型DNG也可被流畅处理,滑块调整丝般顺滑(需8G显存及以上)的同时可放大数毛。
- Redesigned UI style and logic, with softer color schemes and more intuitive interactions.
- Built-in film simulation LUT presets generated from various film technical manuals. By digitizing film data manuals via [spectral_film_lut](https://github.com/JanLohse/spectral_film_lut), we use a spectral physical model to simulate the entire process—from light entering the film to exposure, development, and printing—to generate LUTs. Building on the original version, I’ve added support for the reference pipeline used in this project, while preserving the extremely wide highlight latitude characteristic of negative film. Currently supported films include: Kodak Portra/Ektar/Vision series/TriX/Aerocolor, and Fuji Pro series/Eterna/Superia/C200.
- Supports LOD rendering, allowing even massive 150-megapixel DNG files to be processed smoothly. Slider adjustments are silky smooth (requires 8GB of VRAM or more) while allowing for zooming in to examine fine details.
📦 常见问题
- 部分 RAW 图片解码后可能在高对比度边缘出现彩边(色彩条纹)。这是已知的解码瑕疵,可通过裁剪掉受影响的边缘来规避。
- 如果元数据解析器未正确读取焦距数据,镜头校正将会失败。这个问题经常发生在佳能无反相机上。
- 如果元数据解析器未正确读取相机型号,色温/色调调整将会失败。这个问题可能会发生在一些移动设备上。
- ACES 2.0 不支持 HDR 处理,目前峰值亮度选项是无效的。
- 切换两个波形图时,直方图/波形显示可能无法正确渲染。你可以通过在下方面板中拖动一个滑块来触发重新渲染以解决这个问题。
- 切换版本可能会导致 LUT 应用不正确。你可以通过在控制面板中重新选择 LUT 来解决这个问题。
- 版本控制界面过于紧凑,无法显示较长的版本名称。
- "Plain" 版本根本不会将调整重置为默认值。请改用 "Incremental" 版本。
- + 4 more
📦 Windows 问题
- 由于当前实现的技术限制,HDR 预览在 Windows 上不可用。但当你将 DRT 设置为 P3/ST2084 或 Rec.2020/ST2084 时,你仍然可以导出 Ultra HDR 图像。
- 应用不会在 Windows 上自动对屏幕显示进行色彩管理。导出文件会正确嵌入 ICC profile,但应用内预览不受色彩管理约束。请选择与你显示器色彩空间相匹配的输出色彩空间,以确保预览和导出结果的色彩一致。
- 如需编辑 60MP 以上的图片,建议使用 8GB 及以上显存的 GPU。在显存较低的设备上,处理速度可能明显变慢,甚至出现不稳定情况。
- _请将你的 GPU 驱动程序更新到最新版本_。最低要求的 GPU 驱动程序版本是 570.xx。较旧的驱动程序将导致崩溃。
📦 macOS 问题
- 我只有一台运行 macOS Tahoe (macOS 26) 的 MacBook Air M4,因此我只能在这个特定的硬件和软件配置上测试应用。该应用为 Apple Silicon 构建。如果你在其他支持 Metal 的 ARM Mac 型号或 macOS 版本上遇到任何问题,请向我报告。
- 应用要求 macOS 13.3 或更高版本。但强烈建议升级至 macOS 26 (Tahoe) 或更高版本以获得最佳体验和完整功能支持。
- 由于我没有加入 Apple Developer Program,应用未签名和未公证。它将被 macOS 的安全措施阻止启动。可能存在解决方法,但这里不会讨论。如果你担心安全问题,建议从源代码构建应用。
- HDR 预览和颜色管理在 macOS 上可用,并且导出图像将被标记为你在 DRT 设置中选择的色彩空间。然而,如果你使用非 sRGB 的色彩空间,UI 颜色将不准确,因为应用不支持 UI 中的颜色管理。
📦 Common Issues
- Some RAW images may exhibit chromatic fringing (color fringing along high-contrast edges) after decoding. This is a known decode artifact; crop the affected edges as a workaround.
- 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.
- 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.
- + 4 more
📦 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.
- The app does not automatically apply color management to the screen display on Windows. Exported files are tagged with the correct ICC profile, but the in-app preview is not color-managed. Select an output color space that matches your monitor to keep preview and exported colors consistent.
- For editing images 60MP or larger, a GPU with 8 GB VRAM or more is recommended. Processing may be significantly slower or unstable on lower-VRAM hardware.
- _Please update your GPU drivers to the latest version_. The mimimum 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.
- The app requires macOS 13.3 or later. However, upgrading to macOS 26 (Tahoe) or later is strongly recommended for the best experience and full feature support.
- 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.
✨ Features
- Nikon HE / HE\* RAW recovery workflow: Added Nikon HE-compressed NEF detection during import, a guided Adobe DNG Converter recovery dialog, automatic project cleanup/reimport after conversion, and macOS support for the same flow. Linear DNG inputs are now accepted, so converted files can go straight back into the RAW pipeline. (`b8e4962`, `dc86707`, `d32992d`, `0f85b8a`)
- Highlight reconstruction and tone refactor: Reworked RAW highlight recovery on CUDA and Metal into a multi-pass clipped-mask/chrominance-accumulation pipeline, and refactored Highlights/Shadows adjustments around a shared tone curve with new tests for knee behavior and chroma preservation. (`352d3d2`, `a4218c5`, `478205b`, `624cc24`)
- LUT browser & Look panel redesign: Rebuilt the editor side-panel layout, split out a dedicated Look panel, and added a LUT catalog/browser with `.cube` header validation, missing/invalid state display, quick folder open/refresh actions, and better selection persistence. (`955b47d`, `b8e4962`, `83583f0`)
- Color, export, and metadata upgrades: Added ICC profile embedding on Windows, expanded built-in export profile support, added EXIF details/source-path UI, added macOS scopes, and improved camera metadata resolution for tricky bodies such as Hasselblad. (`6def338`, `93c0b08`, `1f36cd6`, `da0102d`, `912dc2d`)
⚡ Performance
- High-resolution RAW decode acceleration: Split the CUDA RAW path into dedicated full-frame and tiled execution modes, added active-area-aware crop handling, and reduced peak cost for very large Bayer files. (`624cc24`, `2d80f39`)
- Less GPU copying and redundant work: Added GPU buffer sharing and no-op detection for geometry stages so resize/crop passes can skip redundant work or avoid extra copies when possible. (`624cc24`, `2d80f39`)
- Kernel fusion and intermediate reuse: Combined highlight correction with RGBA packing, introduced reusable CUDA/Metal workspaces, tightened several low-level RAW kernels, and improved thumbnail / inference-side throughput. (`624cc24`, `2d80f39`, `22bb73b`)
🐛 Bug Fixes
- Tone and color stability: Fixed the contrast `-100` all-black issue, corrected color temperature UI refresh behavior, and improved camera matrix matching for Hasselblad files. (`6294602`, `83583f0`, `912dc2d`)
- Workflow and platform stability: Fixed export dialog layout/parameter issues, added source-missing notifications in the album UI, and added CUDA driver version requirement probing on startup. (`9ad8384`, `d3083ff`, `4c21e10`, `17363e4`)
📦 新功能
- 尼康 HE / HE\* RAW 恢复工作流:新增导入时对尼康 HE 压缩 NEF 格式的检测、引导式 Adobe DNG Converter 恢复对话框、转换后自动清理项目并重新导入,以及对上述流程的 macOS 支持。现已支持线性 DNG 作为输入,转换后的文件可直接进入 RAW 处理管线。(`b8e4962`, `dc86707`, `d32992d`, `0f85b8a`)
- 高光重建与色调重构:将 CUDA 和 Metal 上的 RAW 高光恢复重构为多轮裁剪掩码/色度累积管线,并围绕共享色调曲线重构了高光/阴影调整逻辑,新增了针对膝点行为和色度保留的测试。(`352d3d2`, `a4218c5`, `478205b`, `624cc24`)
- LUT 浏览器与外观面板重新设计:重建了编辑器侧边栏布局,拆分出独立的外观(Look)面板,新增 LUT 目录/浏览器,支持 `.cube` 文件头校验、缺失/无效状态显示、快速打开文件夹/刷新操作,以及更稳定的选中状态持久化。(`955b47d`, `b8e4962`, `83583f0`)
- 色彩、导出与元数据增强:新增 Windows 平台 ICC 配置文件嵌入、扩展了内置导出配置支持、新增 EXIF 详情/源路径界面显示、新增 macOS 示波器,并改善了对哈苏等特殊机型的相机元数据解析。(`6def338`, `93c0b08`, `1f36cd6`, `da0102d`, `912dc2d`)
📦 性能优化
- 高分辨率 RAW 解码加速:将 CUDA RAW 处理路径拆分为独立的全帧与分块执行模式,加入了感知有效区域的裁剪处理,并降低了超大拜耳文件的峰值开销。(`624cc24`, `2d80f39`)
- 减少 GPU 拷贝与冗余计算:新增 GPU 缓冲区共享机制以及几何处理阶段的空操作检测,使缩放/裁剪步骤在可能时跳过冗余计算或避免额外拷贝。(`624cc24`, `2d80f39`)
- 内核融合与中间结果复用:将高光校正与 RGBA 打包合并为单一步骤,引入可复用的 CUDA/Metal 工作空间,精简了多个底层 RAW 内核,并提升了缩略图生成与推理侧的吞吐量。(`624cc24`, `2d80f39`, `22bb73b`)
📦 问题修复
- 色调与色彩稳定性:修复了对比度设为 `-100` 时画面全黑的问题,修正了色温 UI 刷新异常,并改善了哈苏文件的相机矩阵匹配。(`6294602`, `83583f0`, `912dc2d`)
- 工作流与平台稳定性:修复了导出对话框的布局/参数异常,在相册 UI 中新增源文件丢失提示,并在启动时加入了 CUDA 驱动版本检测。(`9ad8384`, `d3083ff`, `4c21e10`, `17363e4`)
- Lens correction will not correctly crop the final image and may leave visible optical defects.
- Issues present in version v0.2.1 or earlier that were not mentioned in the fixes listed above.
- 镜头矫正可能不能够正确地对最终图像进行裁切并可能留下光学缺陷。
- 上述修复中没提到的存在于0.2.1或更早版本的问题。
✨ Features
- Expanded RAW mosaic support: Added support for non-RGGB 2x2 Bayer patterns and the corresponding Metal processing path (`3d4c1b7`, `b8d292b`)
- X-Trans acceleration: Added Metal support for Fuji X-Trans RAWs and CUDA support for X-Trans RAW processing (`a9b0ed3`, `044f948`)
🐛 Bug Fixes
- Installation and reload stability: Fixed repeated macOS installation issues and corrected path reload logic (`f74e774`, `50045b8`, `0c5c9e5`)
- Shader and path handling fixes: Fixed improper clamp behavior in GPU shaders and resolved Chinese path name handling failures (`286c8cf`, `4823d57`)
- Black level correction: Corrected black level subtraction logic during RAW processing (`6933d51`)
📝 Documentation
- Updated website content and added website documentation updates (`4d3429f`, `03ab42b`, `e7f0585`)
📦 Miscellaneous
- Refactored UI controllers and removed the file tree cache from the album backend (`fd7c56f`, `dede5f3`)
- Optimized image resize performance (`c283563`)
📦 新功能
- 扩展 RAW 马赛克支持:新增对非 RGGB 2x2 Bayer pattern 的支持,并补齐对应的 Metal 处理路径 (`3d4c1b7`, `b8d292b`)
- X-Trans 加速支持:新增 Fuji X-Trans RAW 的 Metal 支持,以及 X-Trans RAW 处理的 CUDA 支持 (`a9b0ed3`, `044f948`)
📦 缺陷修复
- 安装与重载稳定性:修复重复出现的 macOS 安装问题,并修正路径重载逻辑 (`f74e774`, `50045b8`, `0c5c9e5`)
- Shader 与路径处理修复:修复 GPU shader 中不正确的 clamp 行为,并解决中文路径名解析失败问题 (`286c8cf`, `4823d57`)
- 黑电平校正:修正 RAW 处理流程中的 black level subtraction 逻辑 (`6933d51`)
📦 文档更新
- 更新项目网站内容,并补充网站文档 (`4d3429f`, `03ab42b`, `e7f0585`)
📦 其他
- 重构 UI controllers,并移除 album backend 中的文件树缓存 (`fd7c56f`, `dede5f3`)
- 优化图像缩放性能 (`c283563`)
- During HDR export, an 8192px long edge limitation exists. Please set the corresponding export parameters if you have files with an edge of more than 8192px.
- On macOS, the Fujifilm X-Trans RAW images may take longer to decode.
- On macOS, HDR preview may be over-exposed.
- The SDR content in the HDR output may not be accurate.
- HDR 导出仅支持最长边为 8192px 的图片,如果您有此类图片有导出需求,请在导出时设置相关参数。
- 在 macOS 上,X-Trans RAW 可能会花更长的时间解码。
- + 2 more
📋 Changes
- Fix the Chinese path name resolving failure issue.
- Fix the folder sync inconsistency issue.
- Fix the macOS Metal redistribution issue.
- 修复了中文路径解析错误的问题。
- 修复了文件夹的同步不一致问题。
- 修复了 macOS 上 Metal 打包出错的问题。
📋 Changes
- 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 显卡驱动已更新到最新
✨ 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`)
📦 新功能
- 跨平台渲染扩展:新增 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`)
📦 Common Issues
- 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.
- 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.
- + 5 more
📦 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.
📦 常见问题
- 目前仅支持 RGGB 排列的 Bayer RAW 图像,其他排列的支持将会在未来版本中添加。
- 尼康高效率压缩 RAW 格式目前不受支持。你可以将这些文件转换为 DNG 格式以在应用中使用。
- 如果元数据解析器未正确读取焦距数据,镜头校正将会失败。这个问题经常发生在佳能无反相机上。
- 如果元数据解析器未正确读取相机型号,色温/色调调整将会失败。这个问题可能会发生在一些移动设备上。
- ACES 2.0 不支持 HDR 处理,目前峰值亮度选项是无效的。
- 切换两个波形图时,它们可能无法立即渲染。你可以通过在下方面板中拖动一个滑块来触发重新渲染以解决这个问题。
- 切换版本可能会导致 LUT 应用不正确。你可以通过在控制面板中重新选择 LUT 来解决这个问题。
- 版本控制界面过于紧凑,无法显示较长的版本名称。
- + 5 more
📦 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 中的颜色管理。
- 直方图和波形图现不可用
✨ Features
- OpenDRT support: Added support for OpenDRT (Open Display Rendering Transform), licensed under GPLv3 (`8c9e62a`)
- Rendering transform selection: Added support for selecting different rendering transforms (RT) in the pipeline (`6d94167`)
- Image deletion: Added support for deleting images from the project (`197df08`)
- Filter UI improvements: Improved the filter UI for better usability (`874c93b`)
- Project font change: Changed the font used in the project UI (`6c4c6ad`)
🐛 Bug Fixes
- CCT/Tint resolution: Fixed color correlated temperature (CCT) and tint resolution calculation (`2d1efc9`)
- File name display: Fixed file name display issues in the editor and exporter (`20fe29b`)
- Raw processing race conditions: Fixed race conditions during raw image processing (`9dd3e42`)
- Color management resolution: Fixed name normalization error in color management resolution (`665b442`)
📝 Documentation
- Updated README with lensfun installation details (`537670d`)
- Updated core libraries listing in README (`c691484`)
- Updated lensfun build documentation (`3a40dd0`)
- Updated source dependencies information (`c96a980`)
- General README updates (`6a233e7`)
📦 Miscellaneous
- Updated LICENSE back to GPLv3 (`03344c0`)
- Users with an AMD GPU may be able to run this application through [ZLUDA](https://github.com/vosen/ZLUDA). I can't test it on my local environment, so if anyone successfully runs it, please share it and post a pull request to the README.
- ---
📦 新功能
- OpenDRT 支持:新增 OpenDRT 支持,采用 GPLv3 许可证 (`8c9e62a`)
- 渲染变换选择:支持在流水线中选择不同的渲染变换(RT) (`6d94167`)
- 图片删除:新增从项目中删除图片的功能 (`197df08`)
- 筛选器 UI 改进:优化筛选器界面,提升可用性 (`874c93b`)
- 项目字体更换:更换了项目 UI 使用的字体 (`6c4c6ad`)
📦 缺陷修复
- CCT/Tint 解析:修复了色温(CCT)和色调(Tint)解析的计算问题 (`2d1efc9`)
- 文件名显示:修复了编辑器和导出器中文件名显示异常的问题 (`20fe29b`)
- Raw 处理竞态条件:修复了 Raw 图像处理过程中的竞态条件 (`9dd3e42`)
- 色彩管理分辨率:修复了色彩管理分辨率中名称归一化错误 (`665b442`)
📦 文档更新
- 更新 README,添加 lensfun 安装说明 (`537670d`)
- 更新 README 中的核心库列表 (`c691484`)
- 更新 lensfun 构建文档 (`3a40dd0`)
- 更新源码依赖信息 (`c96a980`)
- 常规 README 更新 (`6a233e7`)
📦 其他
- 将许可证恢复为 GPLv3 (`03344c0`)
- AMD GPU 用户可以尝试使用 [ZLUDA](https://github.com/vosen/ZLUDA) 运行本程序,我这边没有条件测试,如果您确实可以通过这一方式运行我的程序,欢迎直接提 README 的 Pull Request。
📦 Pipeline
- Add support for lensfun-based lens correction. The full support list can be found [here](https://lensfun.github.io/lenslist/). To enable it, go to the "RAW Decode" session and check the corresponding checkbox. The automatic lens name resolving may fail. In such cases, the image may exhibit strange distortion, especially with ultra-wide-angle lenses. You can manually select your lens using the options below.
- Improve runtime metadata resolve logic.
- The user can now disable highlight reconstruction in the "RAW Decode" session.
📦 Asset Management
- Improve import UX. Add a new progress ring during the import.
- Improve overall stability during import.
📦 Known Issues (v0.1.1, commit: 846e9d307b63d0b7fb47482387af416482849730)
- See [v0.1.0 Release](https://github.com/zidage/PuerhLab/releases/tag/v0.1.0)
- Full Changelog: https://github.com/zidage/PuerhLab/compare/v0.1.0...v0.1.1
📦 Pipeline
- Only support RGGB Bayer pattern RAW files for now (kind of sucks). The supported camera list is consistent with LibRaw 0.22.0, except for some Fujifilm X-Trans models and non-RGGB models (e.g., Panasonic LUMIX S1R). The detailed list is available in the [LibRaw documentation](https://www.libraw.org/supported-cameras). This also means that JPEG and TIFF files are not supported for importing and editing, but they can be exported from the app.
- RAW files using certain proprietary compression algorithms, such as Nikon's HE Compressed RAW files, are not supported. For such files, please convert them to DNG format for processing.
- For some newer camera models, the 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 or by converting the image into DNG using Adobe DNG Converter. Even though the image may be properly processed, the exported file may still miss EXIF metadata for 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 (depending 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](https://community.acescentral.com/t/aces-2-0-seeing-a-few-issues/5812). This can be mitigated by using "Default_LMT" LUT from [aces-looks](https://github.com/priikone/aces-looks), which emulates an ACES 1.3 look that "fixes" the sunset color issue.
- + 1 more
📦 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 an 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 an 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.
- Filtering is only working with some EXIF tags.
- 普洱工坊的第一个发布版在这里了
- 双击 bin/puerhlab_main.exe 运行
- + 2 more
📦 影像处理管线
- 目前仅支持 RGGB 拜尔阵列 的 RAW 文件(有点惨)。支持的相机列表与 LibRaw 0.22.0 一致,但除去使用 X-Trans 传感器的部分富士机型和一些非 RGGB 模式的机型(例如松下 LUMIX S1R)。详细列表可以在 [LibRaw 文档](https://www.libraw.org/supported-cameras) 中找到。这也意味着 JPEG 和 TIFF 文件目前不支持导入和编辑。
- 不支持采用部分专有压缩算法的RAW文件,比如尼康的高效率压缩RAW文件。对于此类文件,请转换至DNG进行处理。
- 对于一些较新的相机型号,由于当前 LibRaw 版本缺乏支持,图像可能会出现黑色边缘、白平衡不正确,甚至无法加载的问题。这预计将在未来集成更新的 LibRaw 版本后得到解决。在此情况下,即使图像可以正确处理,导出的文件可能仍然缺少 EXIF 元数据。但如果Adobe DNG Converter支持该相机的RAW文件转换为DNG,请使用DNG版本导入即可解决问题。
- 适配自 darktable 的“inpaint opposed”方法的高光重建算法在极端情况下(例如大面积过曝)可能会产生明显的伪影(artifacts)。未来计划提供一个“禁用”选项,并且可能会实现一个更可靠的方法(估计得取决于未来 LLM 的能力了)。
- 版本控制目前还不支持分支,且在不同版本之间切换时可能会遇到预览中 LUT 没有正确应用的问题。可以通过重新应用 LUT 或等待未来的修复来解决这个问题。
- CDL 色轮可能对鼠标拖动有点过于敏感,一拖就变成RGB灯了。
- 在对比度调整为-100时,图像会变黑。
- 不支持用 Ctrl + Z 撤销,只能鼠标点那个Undo。
- + 2 more
📦 资产管理
- 目前 UI 不支持从库中删除单张图片,也不支持在文件夹之间移动图片。底层 API 支持这些操作,但 UI 尚未实现。
- 如果导入了不受支持的 RAW 文件,可能会导致库损坏并在未来无法加载。因此请确保目前仅导入受支持的 RAW 文件。未来计划提供更健壮的处理方式。
- 由于我没有那么多 RAW 照片(比如说 10000+)来测试,库在那个规模下的可用性仍然未知。如果你有大量 RAW 文件并且愿意测试库的表现,请随时尝试并报告你遇到的任何问题。
- 缩略图生成可能会遇到一些数据竞争问题,导致生成的缩略图出现异常。但编辑会话和导出的图像不会受到这个问题的影响。
- 如果你使用的是非英文 Windows 系统,并且没有启用系统设置中的“为全球语言支持使用 Unicode UTF-8”选项,可能会在遇到非 ASCII 文件路径时导致应用程序崩溃。如果由于兼容性问题无法启用 UTF-8 支持,请确保目前仅在文件路径中使用 ASCII 字符,包括安装路径、库路径、每个导入图像的路径和导出路径。
- 影像筛选只在一部分EXIF标签上有效。
