游戏开发图形学【免费下载链接】panda3dPowerful, mature open-source cross-platform game engine for Python and C, developed by Disney and CMU项目地址https://gitcode.com/gh_mirrors/pa/panda3d点击查看免费下载Panda3D 的 CMake 构建脚本把大量可复用的“构建逻辑”封装成一个个独立的.cmake模块集中放在 cmake/macros 目录中。这些模块并不是通用的第三方库而是深度依赖 Panda3D 自身变量与目录结构的内部构件从 bison/flex 解析器生成、unity build 合成源文件到 Python 绑定生成Interrogate和“元库”metalib聚合它们共同支撑起整个工程的编译、绑定与打包流程。读完本篇你将理解每个宏的输入输出、典型调用方式以及它们在 Panda3D 构建链中扮演的角色并能在 CMakeLists.txt 中定位到实际调用点。一、目录定位为什么这些模块“不可独立使用”cmake/macros/README.md 明确声明了该目录的使用边界该目录用于存放 CMake 模块这些模块在项目外使用可能是“不安全”的。这些模块可能依赖 Panda3D 特定的 CMake 变量、Panda3D 的目录结构或其他依赖关系。它们并不打算被其他项目直接 include不过你可以自由地复制或改编它们以满足自己的需要。这一点决定了本目录与 cmake/modulesFindXxx.cmake查找第三方库的本质区别macros 里的函数会读取PROJECT_VERSION、BUILD_METALIBS、IS_DIST_BUILD、PANDA_CFG_INTDIR等仅在 Panda3D 工程内定义的全局变量因此直接搬走往往无法正常工作。根 CMakeLists.txt 先通过CMAKE_MODULE_PATH把 macros 目录加入模块搜索路径再逐个include这些宏set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} ${CMAKE_CURRENT_SOURCE_DIR}/cmake/macros/) ... include(PackageConfig) # Defines package_option include(PerConfigOption) # Defines per_config_option include(AddBisonTarget) # Defines add_bison_target function include(AddFlexTarget) # Defines add_flex_target function include(BuildMetalib) # Defines add_component_library AND add_metalib include(CompositeSources) # Defines composite_sources function include(Python) # Defines add_python_target AND install_python_package include(Interrogate) # Defines target_interrogate AND add_python_module include(RunPzip) # Defines run_pzip function include(Versioning) # Hooks add_library to apply VERSION/SOVERSION注意加载顺序并非随意Versioning放在最后是因为它要覆盖overrideCMake 原生的add_library命令必须在所有会创建库的调用可用前完成钩子安装。下面逐一拆解各宏。二、Versioning自动为共享库打版本号cmake/macros/Versioning.cmake 通过重新定义add_library来“劫持”所有共享库的创建过程function(add_library target_name) _add_library(${target_name} ${ARGN}) get_target_property(type ${target_name} TYPE) if(type STREQUAL SHARED_LIBRARY) set_target_properties(${target_name} PROPERTIES VERSION ${PROJECT_VERSION} SOVERSION ${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}) endif() endfunction(add_library)关键实现细节有三点它把真实命令改名调用的_add_libraryCMake 内部保留原名再包裹一层从而无侵入地给每个目标追加属性只有TYPE为SHARED_LIBRARY的目标才设置版本静态库/对象库不受影响主版本号VERSION取完整的PROJECT_VERSION而SOVERSION只保留主.次两个分量这符合 Linux 动态库 soname 的常见约定——小版本patch变化不需要改变 soname。PROJECT_VERSION来自根 CMakeLists.txt 中从setup.cfg解析出的版本号并通过project(Panda3D VERSION ${_version})注入保证库文件版本与 Python 包版本一致。三、AddBisonTarget / AddFlexTarget解析器生成与预编译回退Panda3D 的多个格式解析器Egg、DC 文件、VRML、X 文件等用 bison语法.yxx与 flex词法.lxx编写。AddBisonTarget.cmake 和 AddFlexTarget.cmake 封装了对应的自定义命令。用法与参数两者签名一致add_bison_target(output_cxx input_yxx [DEFINES output_h] [PREFIX prefix]) add_flex_target(output_cxx input_lxx [DEFINES output_h] [PREFIX prefix] [CASE_INSENSITIVE])DEFINES output_h让 bison 生成.h语法规则、flex 生成--header-file同时把该头文件加入输出集合list(APPEND outputs ${arg})PREFIX prefix对应 bison 的-p与 flex 的-P前缀用于避免多个解析器全局符号冲突CASE_INSENSITIVE仅 flex追加-i参数使词法匹配大小写不敏感。实际调用见各格式解析器的 CMakeLists.txtadd_bison_target(parser.cxx parser.yxx DEFINES parser.h PREFIX eggyy) add_flex_target(lexer.cxx lexer.lxx CASE_INSENSITIVE PREFIX egyy)其他调用点包括 dcparser、vrml、xfile。无 bison/flex 时的预编译回退这两个宏最实用的特性是回退机制。当HAVE_BISON/HAVE_FLEX为假时宏不会报错而是寻找同名.prebuilt文件并用cmake -E copy拷贝为最终产物if(HAVE_BISON) add_custom_command(OUTPUT ${outputs} COMMAND ${BISON_EXECUTABLE} ...) else() # 对每个输出查找 ${output}.prebuilt 并用 copy 命令替代 ... list(APPEND commands COMMAND ${CMAKE_COMMAND} -E copy ${prebuilt_file} ${output}) add_custom_command(OUTPUT ${outputs} ${commands} DEPENDS ${depends}) endif()仓库中确实提供了这些预编译产物作为兜底例如 parser.cxx.prebuilt、dcParser.cxx.prebuilt、vrmlParser.cxx.prebuilt 等共 12 个.prebuilt文件。这意味着即便构建机器未安装 bison/flex工程仍可通过预生成源码继续编译。另外AddFlexTarget.cmake在 MSVC 下还会给产物追加YY_NO_UNISTD_H1编译定义解决 flex 生成代码在 Windows 头文件缺失unistd.h的问题。四、BuildMetalib组件库与“元库”聚合BuildMetalib.cmake 是理解 Panda3D 库组织方式的核心。它定义了“库中库”metalibrary概念——metalib 自身不含独立代码而是把多个组件库的对象“摊平”flatten进一个共享库。它提供两个函数add_component_library与add_metalib。add_component_library用法类似add_library并支持关键字add_component_library(target [SYMBOL building_symbol] [SOURCES] [[NOINIT]/[INIT func [header]]])目标名若以p3开头会自动剥离前缀默认初始化函数为init_libname、头文件为config_name.hNOINIT可抑制这一默认SYMBOL类似 CMake 的DEFINE_SYMBOL只在构建库本身时定义构建链接方时不定义关键分支在BUILD_METALIBS为真时组件库被创建为OBJECT库供 metalib 用$TARGET_OBJECTS:...吸收对象并强制开启POSITION_INDEPENDENT_CODE、把INTERFACE_INCLUDE_DIRECTORIES指向组件源码目录为假时退化为普通add_library。真实调用例如 p3dcparser、p3dtoolbase。add_metalibadd_metalib(target [source1 source2] [INCLUDE header.h ...] [INIT initfunc [initheader.h] [EXPORT type name expr]] [COMPONENTS component1 ...])在 metalib 模式下add_metalib会对每个COMPONENTS组件通过$TARGET_OBJECTS:${component}直接消费其对象文件而不是链接它用生成表达式generator expression把组件的COMPILE_DEFINITIONS、INTERFACE_INCLUDE_DIRECTORIES、LINK_OPTIONS等“摊平”到 metalib并过滤掉仅指向其他组件或项目内部路径的引用若指定了INIT则基于 cmake/templates/metalib_init.cxx.in 与metalib_init.h.in自动生成一个 init 源文件依次调用各组件的初始化函数并安装对应头文件EXPORT type name expr会以extern C形式导出一个不带装饰的 C 符号返回表达式expr类型type——这是让 Python 绑定层拿到特定管线的关键。典型例子 panda/metalibs/pandagl/CMakeLists.txtadd_metalib(pandagl ${MODULE_TYPE} INCLUDE ${PANDAGL_PIPE_INCLUDE} INIT init_libpandagl pandagl.h EXPORT int get_pipe_type_pandagl ${PANDAGL_PIPE_TYPE}::get_class_type().get_index() COMPONENTS ${PANDAGL_LINK_TARGETS})而核心元库 panda/metalibs/panda/CMakeLists.txt 则把p3chan p3char p3collide ... p3tform等二十多个组件聚合进panda并按条件HAVE_AUDIO、HAVE_FREETYPE等追加组件。五、CompositeSourcesUnity Build 与合成源文件CompositeSources.cmake 实现了“合成源文件”unity build把多个.cxx拼接成单个_compositeN.cxx一次性编译以显著缩短构建时间。相关缓存变量包括CMAKE_UNITY_BUILD # 默认 ON CMAKE_UNITY_BUILD_BATCH_SIZE # 默认 30每批合成的源文件数 COMPOSITE_SOURCE_EXTENSIONS # 默认 .cxx;.mm;.c COMPOSITE_SOURCE_EXCLUSIONS # 跳过合成的目标列表CI 用composite_sources(target sources_var)的核心逻辑若 CMake ≥ 3.16直接改用原生的CMAKE_UNITY_BUILD*仅对非.cxx源文件设置SKIP_UNITY_BUILD_INCLUSION YES注释说明 3.16.2 及更早版本对多语言支持有缺陷故只允许.cxx进入原生 unity否则按扩展名分组、按BATCH_SIZE分批跳过GENERATED、HEADER_FILE_ONLY、SKIP_UNITY_BUILD_INCLUSION源文件每批通过 cmake/scripts/MakeComposite.cmake 生成target_compositeN.ext并把原始源文件标记为HEADER_FILE_ONLY仍可在 IDE 中查看但不参与编译同时打WRAP_EXCLUDE YES避免被 Interrogate 重复扫描。调用点如 contrib/src/ai/CMakeLists.txt、direct/src/interval/CMakeLists.txt。六、InterrogateC 到 Python 的绑定生成Interrogate.cmake 是 Panda3D 把 C 暴露给 Python 的关键提供target_interrogate、interrogate_sources与add_python_module三级函数。target_interrogate(target [ALL] [EXTENSIONS ...])本身不运行 interrogate只是把要扫描的源文件、扩展文件通过IGATE_SOURCES/IGATE_EXTENSIONS属性挂到目标上并记录TARGET_SRCDIR/TARGET_BINDIRinterrogate_sources(target output database language_flags)真正运行interrogate生成outfile.cxx与dbfile.in。它会按 INTERROGATE_EXCLUDE_REGEXES 过滤掉.I/.N/.c/.lxx/.yxx/_src.*等文件并自动为同名.N指令文件添加依赖add_python_module(module [lib...] [LINK ...] [IMPORT ...] [INIT ...]编排上述流程调用interrogate_module生成module_module.cxx并通过add_python_target建立 Python 模块目标。它精心处理了“把编译定义、包含路径同步传给 Interrogate使其与编译器用相同方式预处理源码”的问题包括用check_type_size(long)判断 64 位并追加-D_LP64用生成表达式抽取INTERFACE_INCLUDE_DIRECTORIES从CMAKE_CXX_FLAGS*中用正则[/-]D[ \t]*[A-Za-z0-9_]抠出-D定义。真实调用如 panda3d.core、panda3d.egg、panda3d.bullet。IMPORT让模块初始化时依赖另一个 Python 模块LINK则指定链接库与前文列出的库分离。七、PackageConfig第三方包选项与导出PackageConfig.cmake 为 Panda3D 的第三方依赖提供统一的“开关 导入目标”抽象核心是PKG::NAME接口库。package_optionpackage_option(package_name package_doc_string [DEFAULT ON | OFF] [IMPORTED_AS CMake::Imported::Target ...] [FOUND_AS find_name] [LICENSE license])未显式指定DEFAULT时普通构建默认启用所有“找到”的第三方包分发构建IS_DIST_BUILD会额外校验LICENSE若许可证不在PANDA_DIST_USE_LICENSES白名单内则强制默认关闭防止无意中违反第三方许可证——这是注释里强调的“避免意外违反第三方许可”的规则每次调用都会创建PKG::NAME INTERFACE IMPORTED GLOBAL目标即使包未找到也会建“空壳”因此下游可无条件target_link_libraries(... PKG::NAME)通过生成表达式把包包含目录对 Interrogate 隐藏强制绑定层依赖仓库内parser-inc而非系统头文件。package_status / show_packages / export_packages / export_targetspackage_status注册描述与备注show_packages汇总打印“ 已启用 / ! 启用但没找到 / - 未找到或未请求”的报告export_packages(filename)生成可包含的 CMake 文件逐包导出PKG::目标属性并手动递归展开非传递的INTERFACE_LINK_LIBRARIESexport_targets(set [NAMESPACE ...] [COMPONENT ...])生成并安装Panda3DsetTargets.cmake供下游find_package使用。八、PerConfigOption 与 RunPzip构建配置与模型打包per_config_optionPerConfigOption.cmake 的per_config_option(name help [Config1 ...])让选项“按配置”生效单配置生成器下依据CMAKE_BUILD_TYPE是否落在给定配置列表中决定option默认 ON/OFF多配置生成器下为CMAKE_CONFIGURATION_TYPES中每个配置各建一个name_CONFIG选项若该变量已被显式定义则退化为普通option。run_pzipRunPzip.cmake 的run_pzip(target source destination glob)把匹配glob的资源批量打包成 Panda3D 的.pz二进制格式。逻辑为递归 glob 出文件若host_pzip目标存在则对每个文件调用host_pzip -o dest.pz src生成.pz否则回退为copy_if_different直接拷贝最后用add_custom_target(... ALL DEPENDS ...)聚合。根 CMakeLists.txt 用它把 models 下的*.egg打包为内置模型资源。九、小结这些宏如何串成一条构建链结合 cmake/macros/README.md 的定位与 cmake/README.md 的构建入口这套宏模块在 Panda3D 中形成了一条清晰链路package_option/per_config_option先确定“要编译哪些第三方库、哪些配置项”add_bison_target/add_flex_target生成各格式解析器源码缺失工具时用.prebuilt兜底composite_sources把组件源文件 unity 合成加速编译add_component_libraryadd_metalib把组件聚合为对外共享的 metalibtarget_interrogateadd_python_module生成 Python 绑定模块Versioning在add_library层统一给共享库打上 sonamerun_pzip把内置模型打包为.pzexport_packages/export_targets则负责把可安装结果导出给下游。由于这些函数普遍依赖BUILD_METALIBS、PROJECT_VERSION、PANDA_CFG_INTDIR、IS_DIST_BUILD等 Panda3D 全局状态脱离本工程环境直接引用它们往往不可用如需移植应按 README 的建议“复制并改写”后再适配自身变量与目录结构。赞分享游戏开发图形学【免费下载链接】panda3dPowerful, mature open-source cross-platform game engine for Python and C, developed by Disney and CMU项目地址https://gitcode.com/gh_mirrors/pa/panda3d点击查看免费下载相关推荐CMake 策略 CMP0195Swift 模块在构建树中使用模块目录结构CMake 策略 CMP0195Swift 模块在构建树中使用模块目录结构 导读 CMP0195 是 CMake 4.1 引入的一项构建策略它改变了 CMa构建工具开发工具CLIF´ CMake 构建系统完全指南从旧 Make 系统迁移到模块化 CMake 构建F´ CMake 构建系统完全指南从旧 Make 系统迁移到模块化 CMake 构建 导读 F´F Prime飞行软件与嵌入式系统框架早期版本附带了一套专嵌入式系统编程3步解锁Flomo到Obsidian迁移告别笔记碎片化的完整方案3步解锁Flomo到Obsidian迁移告别笔记碎片化的完整方案 你是否曾经在Flomo中积累了数百条灵感碎片却苦于无法将它们系统化整理到Obsidian的知识管理数据集成上一篇Maccy macOS 剪贴板历史开源工具实用手册三步找回你复制过的内容下一篇Uperf Game Turbo 完整指南如何让你的安卓手机流畅如新创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考