尧图网站建设 
darktable 内嵌 LibRaw-cmake 构建脚本解析CMake 集成、LIBRAW_PATH 与可选代码编译【免费下载链接】darktabledarktable is an open source photography workflow application and raw developer项目地址: https://gitcode.com/GitHub_Trending/da/darktabledarktable 作为开源摄影工作流与 RAW 处理软件其 RAW 解码依赖 LibRaw 库。为了在不依赖系统 LibRaw 的环境下稳定构建darktable 在仓库中内嵌了一份由社区维护的LibRaw-cmake构建脚本集位于 src/external/LibRaw-cmake通过add_subdirectory把 LibRaw 作为子工程直接编译并链接进 darktable。本文以该目录下的README.md为主体结合仓库内的 CMake 脚本源码系统讲解 LibRaw-cmake 的定位、接入方式、关键 CMake 变量、可选功能开关与底层实现原理帮助读者理解 darktable 的 RAW 解码依赖如何被构建、裁剪与链接。LibRaw-cmake 是什么LibRaw-cmake 是独立于 LibRaw 主仓库的一套 CMake 支持脚本集合。其README.md明确说明src/external/LibRaw-cmake/README.md它服务于将 LibRaw 以 CMake 方式构建这一目标该项目由 LibRaw 作者之外的用户社区维护依赖用户贡献LibRaw 官方并不维护它与 CMake 构建相关的问题应提交到 LibRaw-cmake 仓库而不是 LibRaw 主仓库。也就是说LibRaw 官方长期以 Autotools./configure make为主流构建方式而 CMake 支持由第三方社区补全。darktable 正是借助这套脚本在自己的 CMake 构建体系中“内嵌”LibRaw 源码树从而避免对系统预装 LibRaw 版本的强依赖。仓库文件构成darktable 内嵌的 LibRaw-cmake 由以下文件组成相对仓库根目录src/external/LibRaw-cmake/CMakeLists.txt核心构建脚本定义两个库目标raw与raw_rsrc/external/LibRaw-cmake/INSTALL.CMAKE独立的安装与配置开关说明src/external/LibRaw-cmake/cmake/modules/FindLibRaw.cmake供客户端项目find_package(LibRaw)使用的查找模块src/external/LibRaw-cmake/cmake/modules/FindLCMS.cmake 与 FindLCMS2.cmake颜色管理引擎探测src/external/LibRaw-cmake/cmake/modules/MacroBoolTo01.cmake、MacroLogFeature.cmake、MacroOptionalFindPackage.cmake通用 CMake 辅助宏src/external/LibRaw-cmake/cmake/data/libraw_config.h.cmakelibraw_config.h的模板src/external/LibRaw-cmake/cmake/data/libraw.pc.cmake、libraw_r.pc.cmake、libraw.lsm.cmakepkg-config 与 LSM 打包元数据模板src/external/LibRaw-cmake/cmake/librawConfig.cmake.in安装后供find_package(libraw)使用的包配置文件模板。使用方式从“复制进 LibRaw 根目录”到 git submoduleREADME.md给出了两种接入方式方式一直接把脚本复制进 LibRaw 根目录Just copy the contents of this repository into the root LibRaw folder and run cmake as usual.也就是把LibRaw-cmake的全部内容拷入 LibRaw 源码根目录然后像普通 CMake 工程一样运行 cmake。这是最朴素的做法但会污染 LibRaw 源码树。方式二作为 git submodule 引入官方推荐先同时把 LibRaw-cmake 与 LibRaw 添加为子模块git submodule add https://github.com/LibRaw/LibRaw-cmake.git git submodule add https://github.com/LibRaw/LibRaw.git然后在你的CMakeLists.txt中add_subdirectory(LibRaw-cmake) target_link_libraries(ProjectName PRIVATE libraw::libraw)最后用LIBRAW_PATH变量指向 LibRaw 源码目录cmake -DLIBRAW_PATH./LibRaw/darktable 的实际接入方式darktable 采用了方式二的变体即在自身构建体系中直接add_subdirectory。见 src/CMakeLists.txtif(USE_LIBRAW AND NOT (DONT_USE_INTERNAL_LIBRAW AND libraw_FOUND)) set(LIBRAW_PATH ${CMAKE_CURRENT_SOURCE_DIR}/external/LibRaw CACHE STRING Relative path to libraw directory (defaultCMAKE_CURRENT_SOURCE_DIR)) # LibRaw sub-module add_subdirectory(external/LibRaw-cmake) target_link_libraries(lib_darktable PRIVATE libraw::libraw)同时在 src/CMakeLists.txt 中darktable 首先尝试find_package(libraw 0.21.0)使用系统 LibRaw只有系统版本缺失或不满足0.21.0的最低版本要求时才回退到仓库内嵌的源码树external/LibRaw走add_subdirectory(external/LibRaw-cmake)编译。这条系统优先、内嵌兜底的链路就是LibRaw-cmake在 darktable 中的实际价值所在。注意README.md中的 submodule 命令与 darktable 仓库本身的提交历史并不直接对应darktable 当前是把 LibRaw 作为src/external/LibRaw子模块管理并在 src/external/LibRaw-cmake/CMakeLists.txt 中通过LIBRAW_PATH默认值CMAKE_CURRENT_SOURCE_DIR指向它。上述命令仅用于演示“在自有项目中以 submodule 方式接入”的标准做法。LIBRAW_PATH 变量指向 LibRaw 源码树的关键LIBRAW_PATH是 LibRaw-cmake 最核心的配置变量。在 src/external/LibRaw-cmake/CMakeLists.txt 中set(LIBRAW_PATH ${CMAKE_CURRENT_SOURCE_DIR} CACHE STRING Relative path to libraw directory (defaultCMAKE_CURRENT_SOURCE_DIR)) if(NOT EXISTS ${LIBRAW_PATH}) message(STATUS LIBRAW_PATH${LIBRAW_PATH}) message(FATAL_ERROR LIBRAW_PATH does not contain a valid path to the libraw home) endif() file(TO_CMAKE_PATH ${LIBRAW_PATH} LIBRAW_PATH)要点默认值CMAKE_CURRENT_SOURCE_DIR即脚本自身所在目录。当把 LibRaw-cmake 复制进 LibRaw 根目录时默认值即为 LibRaw 源码树无需额外配置校验如果LIBRAW_PATH指向的路径不存在配置阶段直接FATAL_ERROR终止避免带病构建路径规范化file(TO_CMAKE_PATH ...)统一路径分隔符保证跨平台尤其是 Windows行为一致命令注入外部项目可通过cmake -DLIBRAW_PATH./LibRaw/覆盖默认值这正是README.md给出的用法也是 darktable 在 src/CMakeLists.txt 中显式set(... CACHE STRING ...)的原因。LIBRAW_PATH随后被广泛用于读取版本头文件、收集src/*.cpp源文件、设置 include 目录、安装 LibRaw 公共头文件等详见下文各节。版本号与 ABI 版本自动提取LibRaw-cmake 在配置阶段直接从LIBRAW_PATH/libraw/libraw_version.h中正则提取版本信息见 src/external/LibRaw-cmake/CMakeLists.txtAPI 版本LIBRAW_MAJOR_VERSION、LIBRAW_MINOR_VERSION、LIBRAW_PATCH_VERSION组合成RAW_LIB_VERSION_STRING如0.21.x与十六进制形式的RAW_LIB_VERSION_ID如0x0210ABI 版本LIBRAW_SHLIB_CURRENT、LIBRAW_SHLIB_REVISION、LIBRAW_SHLIB_AGE组合成RAW_LIB_SO_VERSION_STRING用于设置库目标的VERSION与SOVERSION属性CMakeLists.txt 与raw_r对应行project(libraw VERSION ${RAW_LIB_VERSION_STRING} LANGUAGES CXX)用提取到的版本初始化工程因此客户端find_package(libraw 0.21.0)的版本匹配直接受益于此。这套从源码头文件自动解析版本的机制保证了 darktable 在 src/CMakeLists.txt 中要求的libraw 0.21.0最低版本判定完全基于实际内嵌源码而不是硬编码字符串。可配置选项完整开关清单README.md与INSTALL.CMAKE只覆盖了部分开关完整的选项定义在 src/external/LibRaw-cmake/CMakeLists.txt汇总如下CMake 选项默认值说明BUILD_SHARED_LIBSOFF构建共享库默认静态库。注意注释与默认值不符实际option(... OFF)ENABLE_OPENMPON启用 OpenMP 多线程加速需编译器支持ENABLE_LCMSON启用 LCMS 色彩管理引擎自动探测 LCMS1/LCMS2ENABLE_JASPERON启用 libjasperRedCine 编解码器ENABLE_EXAMPLES随主工程编译示例命令行程序作为子工程时默认 OFFENABLE_RAWSPEEDOFF启用 RawStudio 的 RawSpeed 解码器扩展ENABLE_DCRAW_DEBUGOFF输出 dcraw 调试信息-DDCRAW_VERBOSEENABLE_X3FTOOLSOFFFoveon X3F 格式支持-DUSE_X3FTOOLSENABLE_6BY9RPIOFF树莓派 RAW 支持-DUSE_6BY9RPILIBRAW_UNINSTALL_TARGET随主工程生成uninstall自定义目标LIBRAW_INSTALL随主工程生成 install 目标并导出 CMake 包其中ENABLE_EXAMPLES、LIBRAW_UNINSTALL_TARGET、LIBRAW_INSTALL的默认值与MASTER_PROJECT绑定CMakeLists.txt当CMAKE_CURRENT_SOURCE_DIR等于CMAKE_SOURCE_DIR即 LibRaw 作为顶层工程直接构建时默认为 ON否则为 OFF。这保证了 darktable 以add_subdirectory引入时默认不会安装 LibRaw、也不会编译其示例程序避免干扰宿主工程。命令行示例对应INSTALL.CMAKE的./cmake即cmakecmake -DENABLE_OPENMPON -DENABLE_LCMSON -DENABLE_EXAMPLESOFF . make构建期如何选择功能每个开关都会通过MACRO_BOOL_TO_01宏src/external/LibRaw-cmake/cmake/modules/MacroBoolTo01.cmake把布尔结论写入libraw_config.h的#cmakedefine宏见 src/external/LibRaw-cmake/cmake/data/libraw_config.h.cmake#cmakedefine LIBRAW_USE_DNGDEFLATECODEC 1 #cmakedefine LIBRAW_USE_DNGLOSSYCODEC 1 #cmakedefine LIBRAW_USE_OPENMP 1 #cmakedefine LIBRAW_USE_LCMS 1 #cmakedefine LIBRAW_USE_REDCINECODEC 1 #cmakedefine LIBRAW_USE_RAWSPEED 1 #cmakedefine LIBRAW_USE_DCRAW_DEBUG 1 #cmakedefine LIBRAW_USE_X3FTOOLS 1 #cmakedefine LIBRAW_USE_6BY9RPI 1该头文件由configure_file生成到构建目录CMakeLists.txt并随安装流程发布到${CMAKE_INSTALL_INCLUDEDIR}/libraw供依赖方检查 LibRaw 的实际编译能力。依赖探测链路LCMSLCMS2 优先、LCMS1 兜底在 src/external/LibRaw-cmake/CMakeLists.txt 中ENABLE_LCMSON时先find_package(LCMS2)仅当 LCMS2 版本 2.1时启用-DUSE_LCMS2否则回退find_package(LCMS)寻找 LCMS1命中则启用-DUSE_LCMS并把LCMS2_LIBRARIES别名为 LCMS1 的库以统一后续链接代码。两个查找模块分别位于 FindLCMS2.cmake 与 FindLCMS.cmake都会解析lcms.h中的LCMS_VERSION宏并尝试经 pkg-config 定位库。zlib / libjpegDNG 编解码器find_package(ZLIB)命中后定义-DUSE_ZLIB注册为LIBRAW_USE_DNGDEFLATECODECDNG deflate 无损压缩解码CMakeLists.txtfind_package(JPEG)后进一步要求JPEG_VERSION 80libjpeg 8命中才定义-DUSE_JPEG -DUSE_JPEG8并注册为LIBRAW_USE_DNGLOSSYCODECDNG 有损 JPEG 解码CMakeLists.txt。libjpeg 版本不足 8 时MACRO_LOG_FEATURE会记录原因但不中断构建。OpenMP多线程加速ENABLE_OPENMPON时find_package(OpenMP)成功则链接OpenMP::OpenMP_CXX并注册LIBRAW_USE_OPENMPMinGW 下额外定义LIBRAW_FORCE_OPENMPCMakeLists.txt。RawSpeed可选解码器扩展默认关闭ENABLE_RAWSPEEDON时脚本会依次通过RAWSPEED_RPATH默认RawSpeed即LIBRAW_PATH下的RawSpeed目录定位 RawSpeed 源码CMakeLists.txt校验RawSpeed/Common.cpp是否存在且依赖JPEG8 LibXml2 Pthreads全部满足CMakeLists.txt满足后把一长串 RawSpeed 的.cppArwDecoder、Cr2Decoder、NefDecoder、Rw2Decoder、TiffParser 等并入librawspeed_LIB_SRCS定义-DUSE_RAWSPEED并注册LIBRAW_USE_RAWSPEEDCMakeLists.txt。README.RawSpeed.txt中说明的下载 RawSpeed 源码步骤即对应这里的RAWSPEED_RPATH探测逻辑。两个库目标libraw::libraw 与 libraw::libraw_rLibRaw-cmake 会生成两个静态库目标这是其设计上与 Autotools 体系对齐的关键raw别名libraw::libraw单线程版本。编译定义LIBRAW_NOTHREADS源文件集合在 LibRaw 0.21时按固定文件列表指定 0.21时改用file(GLOB_RECURSE ... ${LIBRAW_PATH}/src/*.cpp)收集并剔除*_ph.cpp占位实现CMakeLists.txtraw_r别名libraw::libraw_r多线程安全版本基于相同源文件集合构建CMakeLists.txt。其余要点静态构建的 DLL 语义非BUILD_SHARED_LIBS时两个目标都以PUBLIC方式定义LIBRAW_NODLLCMakeLists.txtPIC两个静态库都强制POSITION_INDEPENDENT_CODE ON以便被宿主共享库链接darktable 的lib_darktable即为共享对象CMakeLists.txt链接依赖按探测结果依次链接MATH_LIBRARYUnix 下为libm、Windows 的ws2_32、OpenMP、LCMS、zlib、libjpeg、Jasper、LibXml2/ThreadsRawSpeed 时CMakeLists.txtinclude 接口对外暴露$BUILD_INTERFACE:${LIBRAW_PATH}与$INSTALL_INTERFACE:libraw保证构建期与安装期都能找到libraw.hCMakeLists.txt。darktable 在 src/CMakeLists.txt 链接的是libraw::libraw单线程版本与 darktable 自身图像管线主要由内部多线程/OpenCL 调度的架构相适应。安装与下游消费FindLibRaw.cmake 与导出包当LIBRAW_INSTALLON顶层构建时默认时脚本会生成并安装libraw.pc、libraw_r.pcpkg-config 元数据与libraw.lsmCMakeLists.txt安装 LibRaw 公共头文件libraw.h、libraw_alloc.h、libraw_const.h、libraw_datastream.h、libraw_internal.h、libraw_types.h、libraw_version.h与生成的libraw_config.h到${CMAKE_INSTALL_INCLUDEDIR}/librawCMakeLists.txt安装两个库目标、安装FindLibRaw.cmake到${CMAKE_INSTALL_DATADIR}/cmake/librawCMakeLists.txt通过configure_package_config_filewrite_basic_package_version_fileinstall(EXPORT ... NAMESPACE libraw::)生成librawConfig.cmake与librawConfigVersion.cmake使下游可以find_package(libraw)CMakeLists.txt。下游消费有两种典型路径find_package(libraw)命中 src/external/LibRaw-cmake/cmake/librawConfig.cmake.in 生成的包它按编译期配置递归find_dependency(Jasper/JPEG/ZLIB/LCMS2/LCMS/LibXml2/Threads/OpenMP)再includeTargets 文件最终得到libraw::libraw与libraw::libraw_r目标——这正是 darktable src/CMakeLists.txt 中find_package(libraw 0.21.0)的消费路径find_package(LibRaw)使用随包安装的 FindLibRaw.cmake它同时探测raw单线程与raw_r线程安全两组库定义LibRaw_LIBRARIES/LibRaw_r_LIBRARIES与对应_DEFINITIONS并同样从libraw_version.h正则提取LibRaw_VERSION_STRING供版本匹配。实战小结接入darktable 通过add_subdirectory(external/LibRaw-cmake)内嵌构建 LibRaw配合 src/CMakeLists.txt 的系统 LibRaw 优先、内嵌源码兜底策略关键变量LIBRAW_PATH指向 LibRaw 源码树darktable 中为src/external/LibRaw是全部源码收集与头文件安装的基准功能裁剪ENABLE_*系列开关通过libraw_config.h的#cmakedefine宏与编译期-DUSE_*定义联动静态库raw对应单线程libraw::librawraw_r对应多线程libraw::libraw_r可验证性配置完成时脚本会打印一份功能清单OpenMP / LCMS / DNG codec / RawSpeed / X3F / 6BY9RPI 等逐项 YES/NOCMakeLists.txt任何功能开关的生效与否都能在cmake输出中直接确认无需猜测。【免费下载链接】darktabledarktable is an open source photography workflow application and raw developer项目地址: https://gitcode.com/GitHub_Trending/da/darktable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 darktable 内嵌 LibRaw-cmake 构建脚本解析：CMake 集成、LIBRAW_PATH 与可选代码编译
darktable 内嵌 LibRaw-cmake 构建脚本解析CMake 集成、LIBRAW_PATH 与可选代码编译【免费下载链接】darktabledarktable is an open source photography workflow application and raw developer项目地址: https://gitcode.com/GitHub_Trending/da/darktabledarktable 作为开源摄影工作流与 RAW 处理软件其 RAW 解码依赖 LibRaw 库。为了在不依赖系统 LibRaw 的环境下稳定构建darktable 在仓库中内嵌了一份由社区维护的LibRaw-cmake构建脚本集位于 src/external/LibRaw-cmake通过add_subdirectory把 LibRaw 作为子工程直接编译并链接进 darktable。本文以该目录下的README.md为主体结合仓库内的 CMake 脚本源码系统讲解 LibRaw-cmake 的定位、接入方式、关键 CMake 变量、可选功能开关与底层实现原理帮助读者理解 darktable 的 RAW 解码依赖如何被构建、裁剪与链接。LibRaw-cmake 是什么LibRaw-cmake 是独立于 LibRaw 主仓库的一套 CMake 支持脚本集合。其README.md明确说明src/external/LibRaw-cmake/README.md它服务于将 LibRaw 以 CMake 方式构建这一目标该项目由 LibRaw 作者之外的用户社区维护依赖用户贡献LibRaw 官方并不维护它与 CMake 构建相关的问题应提交到 LibRaw-cmake 仓库而不是 LibRaw 主仓库。也就是说LibRaw 官方长期以 Autotools./configure make为主流构建方式而 CMake 支持由第三方社区补全。darktable 正是借助这套脚本在自己的 CMake 构建体系中“内嵌”LibRaw 源码树从而避免对系统预装 LibRaw 版本的强依赖。仓库文件构成darktable 内嵌的 LibRaw-cmake 由以下文件组成相对仓库根目录src/external/LibRaw-cmake/CMakeLists.txt核心构建脚本定义两个库目标raw与raw_rsrc/external/LibRaw-cmake/INSTALL.CMAKE独立的安装与配置开关说明src/external/LibRaw-cmake/cmake/modules/FindLibRaw.cmake供客户端项目find_package(LibRaw)使用的查找模块src/external/LibRaw-cmake/cmake/modules/FindLCMS.cmake 与 FindLCMS2.cmake颜色管理引擎探测src/external/LibRaw-cmake/cmake/modules/MacroBoolTo01.cmake、MacroLogFeature.cmake、MacroOptionalFindPackage.cmake通用 CMake 辅助宏src/external/LibRaw-cmake/cmake/data/libraw_config.h.cmakelibraw_config.h的模板src/external/LibRaw-cmake/cmake/data/libraw.pc.cmake、libraw_r.pc.cmake、libraw.lsm.cmakepkg-config 与 LSM 打包元数据模板src/external/LibRaw-cmake/cmake/librawConfig.cmake.in安装后供find_package(libraw)使用的包配置文件模板。使用方式从“复制进 LibRaw 根目录”到 git submoduleREADME.md给出了两种接入方式方式一直接把脚本复制进 LibRaw 根目录Just copy the contents of this repository into the root LibRaw folder and run cmake as usual.也就是把LibRaw-cmake的全部内容拷入 LibRaw 源码根目录然后像普通 CMake 工程一样运行 cmake。这是最朴素的做法但会污染 LibRaw 源码树。方式二作为 git submodule 引入官方推荐先同时把 LibRaw-cmake 与 LibRaw 添加为子模块git submodule add https://github.com/LibRaw/LibRaw-cmake.git git submodule add https://github.com/LibRaw/LibRaw.git然后在你的CMakeLists.txt中add_subdirectory(LibRaw-cmake) target_link_libraries(ProjectName PRIVATE libraw::libraw)最后用LIBRAW_PATH变量指向 LibRaw 源码目录cmake -DLIBRAW_PATH./LibRaw/darktable 的实际接入方式darktable 采用了方式二的变体即在自身构建体系中直接add_subdirectory。见 src/CMakeLists.txtif(USE_LIBRAW AND NOT (DONT_USE_INTERNAL_LIBRAW AND libraw_FOUND)) set(LIBRAW_PATH ${CMAKE_CURRENT_SOURCE_DIR}/external/LibRaw CACHE STRING Relative path to libraw directory (defaultCMAKE_CURRENT_SOURCE_DIR)) # LibRaw sub-module add_subdirectory(external/LibRaw-cmake) target_link_libraries(lib_darktable PRIVATE libraw::libraw)同时在 src/CMakeLists.txt 中darktable 首先尝试find_package(libraw 0.21.0)使用系统 LibRaw只有系统版本缺失或不满足0.21.0的最低版本要求时才回退到仓库内嵌的源码树external/LibRaw走add_subdirectory(external/LibRaw-cmake)编译。这条系统优先、内嵌兜底的链路就是LibRaw-cmake在 darktable 中的实际价值所在。注意README.md中的 submodule 命令与 darktable 仓库本身的提交历史并不直接对应darktable 当前是把 LibRaw 作为src/external/LibRaw子模块管理并在 src/external/LibRaw-cmake/CMakeLists.txt 中通过LIBRAW_PATH默认值CMAKE_CURRENT_SOURCE_DIR指向它。上述命令仅用于演示“在自有项目中以 submodule 方式接入”的标准做法。LIBRAW_PATH 变量指向 LibRaw 源码树的关键LIBRAW_PATH是 LibRaw-cmake 最核心的配置变量。在 src/external/LibRaw-cmake/CMakeLists.txt 中set(LIBRAW_PATH ${CMAKE_CURRENT_SOURCE_DIR} CACHE STRING Relative path to libraw directory (defaultCMAKE_CURRENT_SOURCE_DIR)) if(NOT EXISTS ${LIBRAW_PATH}) message(STATUS LIBRAW_PATH${LIBRAW_PATH}) message(FATAL_ERROR LIBRAW_PATH does not contain a valid path to the libraw home) endif() file(TO_CMAKE_PATH ${LIBRAW_PATH} LIBRAW_PATH)要点默认值CMAKE_CURRENT_SOURCE_DIR即脚本自身所在目录。当把 LibRaw-cmake 复制进 LibRaw 根目录时默认值即为 LibRaw 源码树无需额外配置校验如果LIBRAW_PATH指向的路径不存在配置阶段直接FATAL_ERROR终止避免带病构建路径规范化file(TO_CMAKE_PATH ...)统一路径分隔符保证跨平台尤其是 Windows行为一致命令注入外部项目可通过cmake -DLIBRAW_PATH./LibRaw/覆盖默认值这正是README.md给出的用法也是 darktable 在 src/CMakeLists.txt 中显式set(... CACHE STRING ...)的原因。LIBRAW_PATH随后被广泛用于读取版本头文件、收集src/*.cpp源文件、设置 include 目录、安装 LibRaw 公共头文件等详见下文各节。版本号与 ABI 版本自动提取LibRaw-cmake 在配置阶段直接从LIBRAW_PATH/libraw/libraw_version.h中正则提取版本信息见 src/external/LibRaw-cmake/CMakeLists.txtAPI 版本LIBRAW_MAJOR_VERSION、LIBRAW_MINOR_VERSION、LIBRAW_PATCH_VERSION组合成RAW_LIB_VERSION_STRING如0.21.x与十六进制形式的RAW_LIB_VERSION_ID如0x0210ABI 版本LIBRAW_SHLIB_CURRENT、LIBRAW_SHLIB_REVISION、LIBRAW_SHLIB_AGE组合成RAW_LIB_SO_VERSION_STRING用于设置库目标的VERSION与SOVERSION属性CMakeLists.txt 与raw_r对应行project(libraw VERSION ${RAW_LIB_VERSION_STRING} LANGUAGES CXX)用提取到的版本初始化工程因此客户端find_package(libraw 0.21.0)的版本匹配直接受益于此。这套从源码头文件自动解析版本的机制保证了 darktable 在 src/CMakeLists.txt 中要求的libraw 0.21.0最低版本判定完全基于实际内嵌源码而不是硬编码字符串。可配置选项完整开关清单README.md与INSTALL.CMAKE只覆盖了部分开关完整的选项定义在 src/external/LibRaw-cmake/CMakeLists.txt汇总如下CMake 选项默认值说明BUILD_SHARED_LIBSOFF构建共享库默认静态库。注意注释与默认值不符实际option(... OFF)ENABLE_OPENMPON启用 OpenMP 多线程加速需编译器支持ENABLE_LCMSON启用 LCMS 色彩管理引擎自动探测 LCMS1/LCMS2ENABLE_JASPERON启用 libjasperRedCine 编解码器ENABLE_EXAMPLES随主工程编译示例命令行程序作为子工程时默认 OFFENABLE_RAWSPEEDOFF启用 RawStudio 的 RawSpeed 解码器扩展ENABLE_DCRAW_DEBUGOFF输出 dcraw 调试信息-DDCRAW_VERBOSEENABLE_X3FTOOLSOFFFoveon X3F 格式支持-DUSE_X3FTOOLSENABLE_6BY9RPIOFF树莓派 RAW 支持-DUSE_6BY9RPILIBRAW_UNINSTALL_TARGET随主工程生成uninstall自定义目标LIBRAW_INSTALL随主工程生成 install 目标并导出 CMake 包其中ENABLE_EXAMPLES、LIBRAW_UNINSTALL_TARGET、LIBRAW_INSTALL的默认值与MASTER_PROJECT绑定CMakeLists.txt当CMAKE_CURRENT_SOURCE_DIR等于CMAKE_SOURCE_DIR即 LibRaw 作为顶层工程直接构建时默认为 ON否则为 OFF。这保证了 darktable 以add_subdirectory引入时默认不会安装 LibRaw、也不会编译其示例程序避免干扰宿主工程。命令行示例对应INSTALL.CMAKE的./cmake即cmakecmake -DENABLE_OPENMPON -DENABLE_LCMSON -DENABLE_EXAMPLESOFF . make构建期如何选择功能每个开关都会通过MACRO_BOOL_TO_01宏src/external/LibRaw-cmake/cmake/modules/MacroBoolTo01.cmake把布尔结论写入libraw_config.h的#cmakedefine宏见 src/external/LibRaw-cmake/cmake/data/libraw_config.h.cmake#cmakedefine LIBRAW_USE_DNGDEFLATECODEC 1 #cmakedefine LIBRAW_USE_DNGLOSSYCODEC 1 #cmakedefine LIBRAW_USE_OPENMP 1 #cmakedefine LIBRAW_USE_LCMS 1 #cmakedefine LIBRAW_USE_REDCINECODEC 1 #cmakedefine LIBRAW_USE_RAWSPEED 1 #cmakedefine LIBRAW_USE_DCRAW_DEBUG 1 #cmakedefine LIBRAW_USE_X3FTOOLS 1 #cmakedefine LIBRAW_USE_6BY9RPI 1该头文件由configure_file生成到构建目录CMakeLists.txt并随安装流程发布到${CMAKE_INSTALL_INCLUDEDIR}/libraw供依赖方检查 LibRaw 的实际编译能力。依赖探测链路LCMSLCMS2 优先、LCMS1 兜底在 src/external/LibRaw-cmake/CMakeLists.txt 中ENABLE_LCMSON时先find_package(LCMS2)仅当 LCMS2 版本 2.1时启用-DUSE_LCMS2否则回退find_package(LCMS)寻找 LCMS1命中则启用-DUSE_LCMS并把LCMS2_LIBRARIES别名为 LCMS1 的库以统一后续链接代码。两个查找模块分别位于 FindLCMS2.cmake 与 FindLCMS.cmake都会解析lcms.h中的LCMS_VERSION宏并尝试经 pkg-config 定位库。zlib / libjpegDNG 编解码器find_package(ZLIB)命中后定义-DUSE_ZLIB注册为LIBRAW_USE_DNGDEFLATECODECDNG deflate 无损压缩解码CMakeLists.txtfind_package(JPEG)后进一步要求JPEG_VERSION 80libjpeg 8命中才定义-DUSE_JPEG -DUSE_JPEG8并注册为LIBRAW_USE_DNGLOSSYCODECDNG 有损 JPEG 解码CMakeLists.txt。libjpeg 版本不足 8 时MACRO_LOG_FEATURE会记录原因但不中断构建。OpenMP多线程加速ENABLE_OPENMPON时find_package(OpenMP)成功则链接OpenMP::OpenMP_CXX并注册LIBRAW_USE_OPENMPMinGW 下额外定义LIBRAW_FORCE_OPENMPCMakeLists.txt。RawSpeed可选解码器扩展默认关闭ENABLE_RAWSPEEDON时脚本会依次通过RAWSPEED_RPATH默认RawSpeed即LIBRAW_PATH下的RawSpeed目录定位 RawSpeed 源码CMakeLists.txt校验RawSpeed/Common.cpp是否存在且依赖JPEG8 LibXml2 Pthreads全部满足CMakeLists.txt满足后把一长串 RawSpeed 的.cppArwDecoder、Cr2Decoder、NefDecoder、Rw2Decoder、TiffParser 等并入librawspeed_LIB_SRCS定义-DUSE_RAWSPEED并注册LIBRAW_USE_RAWSPEEDCMakeLists.txt。README.RawSpeed.txt中说明的下载 RawSpeed 源码步骤即对应这里的RAWSPEED_RPATH探测逻辑。两个库目标libraw::libraw 与 libraw::libraw_rLibRaw-cmake 会生成两个静态库目标这是其设计上与 Autotools 体系对齐的关键raw别名libraw::libraw单线程版本。编译定义LIBRAW_NOTHREADS源文件集合在 LibRaw 0.21时按固定文件列表指定 0.21时改用file(GLOB_RECURSE ... ${LIBRAW_PATH}/src/*.cpp)收集并剔除*_ph.cpp占位实现CMakeLists.txtraw_r别名libraw::libraw_r多线程安全版本基于相同源文件集合构建CMakeLists.txt。其余要点静态构建的 DLL 语义非BUILD_SHARED_LIBS时两个目标都以PUBLIC方式定义LIBRAW_NODLLCMakeLists.txtPIC两个静态库都强制POSITION_INDEPENDENT_CODE ON以便被宿主共享库链接darktable 的lib_darktable即为共享对象CMakeLists.txt链接依赖按探测结果依次链接MATH_LIBRARYUnix 下为libm、Windows 的ws2_32、OpenMP、LCMS、zlib、libjpeg、Jasper、LibXml2/ThreadsRawSpeed 时CMakeLists.txtinclude 接口对外暴露$BUILD_INTERFACE:${LIBRAW_PATH}与$INSTALL_INTERFACE:libraw保证构建期与安装期都能找到libraw.hCMakeLists.txt。darktable 在 src/CMakeLists.txt 链接的是libraw::libraw单线程版本与 darktable 自身图像管线主要由内部多线程/OpenCL 调度的架构相适应。安装与下游消费FindLibRaw.cmake 与导出包当LIBRAW_INSTALLON顶层构建时默认时脚本会生成并安装libraw.pc、libraw_r.pcpkg-config 元数据与libraw.lsmCMakeLists.txt安装 LibRaw 公共头文件libraw.h、libraw_alloc.h、libraw_const.h、libraw_datastream.h、libraw_internal.h、libraw_types.h、libraw_version.h与生成的libraw_config.h到${CMAKE_INSTALL_INCLUDEDIR}/librawCMakeLists.txt安装两个库目标、安装FindLibRaw.cmake到${CMAKE_INSTALL_DATADIR}/cmake/librawCMakeLists.txt通过configure_package_config_filewrite_basic_package_version_fileinstall(EXPORT ... NAMESPACE libraw::)生成librawConfig.cmake与librawConfigVersion.cmake使下游可以find_package(libraw)CMakeLists.txt。下游消费有两种典型路径find_package(libraw)命中 src/external/LibRaw-cmake/cmake/librawConfig.cmake.in 生成的包它按编译期配置递归find_dependency(Jasper/JPEG/ZLIB/LCMS2/LCMS/LibXml2/Threads/OpenMP)再includeTargets 文件最终得到libraw::libraw与libraw::libraw_r目标——这正是 darktable src/CMakeLists.txt 中find_package(libraw 0.21.0)的消费路径find_package(LibRaw)使用随包安装的 FindLibRaw.cmake它同时探测raw单线程与raw_r线程安全两组库定义LibRaw_LIBRARIES/LibRaw_r_LIBRARIES与对应_DEFINITIONS并同样从libraw_version.h正则提取LibRaw_VERSION_STRING供版本匹配。实战小结接入darktable 通过add_subdirectory(external/LibRaw-cmake)内嵌构建 LibRaw配合 src/CMakeLists.txt 的系统 LibRaw 优先、内嵌源码兜底策略关键变量LIBRAW_PATH指向 LibRaw 源码树darktable 中为src/external/LibRaw是全部源码收集与头文件安装的基准功能裁剪ENABLE_*系列开关通过libraw_config.h的#cmakedefine宏与编译期-DUSE_*定义联动静态库raw对应单线程libraw::librawraw_r对应多线程libraw::libraw_r可验证性配置完成时脚本会打印一份功能清单OpenMP / LCMS / DNG codec / RawSpeed / X3F / 6BY9RPI 等逐项 YES/NOCMakeLists.txt任何功能开关的生效与否都能在cmake输出中直接确认无需猜测。【免费下载链接】darktabledarktable is an open source photography workflow application and raw developer项目地址: https://gitcode.com/GitHub_Trending/da/darktable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考