1.游戏引擎随笔 0x29：UE5 Lumen 源码解析（一）原理篇
2.UE 八叉树Octree2源码分析
3.UE4学习笔记（1）：UE源码下载编译+安卓打包
4.UE4源码剖析——Actor蓝图之CDO与SCS
5.UE4源码剖析——异步与并行 中篇 之 Thread
6.[UE5.1] StateTree 使用与源码分析(二)

游戏引擎随笔 0x29：UE5 Lumen 源码解析（一）原理篇

       实时全局光照的场景场景追求一直是图形渲染界的焦点。随着GPU硬件光线追踪技术的源码兴起，Epic Games的搭建Unreal Engine 5推出了Lumen，一个结合SDF、场景场景Voxel Lighting、源码Radiosity等技术的搭建微信自动发送消息源码软件光线追踪系统。Lumen的场景场景实现极其复杂，涉及个Pass，源码近5.6万行C++代码和2万行Shader，搭建与Nanite、场景场景Virtual Shadow Map等系统紧密集成，源码并支持混合使用硬件和软件光线追踪。搭建

       本系列将逐步解析Lumen，场景场景从原理入手。源码Lumen以简化间接光照（主要由漫反射构成）为核心，搭建采用Monte Carlo积分方法估算，利用Ray Tracing获取Radiance，生成Irradiance，最终得到光照值。它的核心是Radiance的计算、缓存和查询，以及这些操作的高效整合。

       数学原理上，Lumen依赖渲染方程，通过离散采样近似无限积分。它主要处理Diffuse部分，利用Lambert Diffuse和Ray Tracing获取Radiance。加速结构方面，Lumen利用SDF Ray Marching在无需硬件支持的情况下实现高效的SWRT。

       Surface Cache是关键技术，通过预生成的低分辨率材质属性图集，高效获取Hit Point的Material Attribute，结合SDF Tracing，为Lumen提供了实时性能。Radiance Cache则是将Direct Lighting结果保存，便于后续的光照计算和全局光照的无限反弹。

       Lumen构建了一个由DF和Surface Cache构成的低精度场景表示，即Lumen Scene，负责Mesh DF更新、Global DF合并和Surface Cache更新。复利 源码 论坛通过Screen Space Probe的自适应放置，Lumen实现了高效的光照追踪和降噪处理。

       总体流程包括Lumen Scene更新、Lighting计算和Final Gather，涉及众多数据流和过程，通过3D Texture和Spatial Filtering进行降噪和Light Scattering的处理。后续篇章将深入源码，以更详细的方式揭示Lumen的实现细节和优化策略。

UE 八叉树Octree2源码分析

       UE中八叉树Octree2源码分析，本文旨在深入理解UE八叉树的具体实现。八叉树概念广泛熟悉，但初次接触UE实现时仍需思考。UE八叉树简化应用，多数直接使用方便。本文针对UE4.至UE5.1版本八叉树源码进行详细解析。

       UE八叉树主要结构包括：TreeNodes、ParentLinks、TreeElements、FreeList、RootNodeContext和MinLeafExtent。TreeNodes存储节点信息，每个FNode记录当前节点元素数量及子节点Index；ParentLinks记录节点父节点ID；TreeElements存储元素数据；FreeList记录空闲FNode下标；RootNodeContext和MinLeafExtent与八叉树构造相关，用于确定节点半径。

       UE八叉树构造过程依赖AddElement方法，实现在AddElementInternal中。首先判断节点是否为叶子节点。若无子节点且元素数量超过预设阈值，或节点半径小于MinLeafExtent，则创建子节点。否则，直接将元素加入当前节点。若需创建子节点，清空当前节点元素，分配八个子节点，递归处理非叶节点情况。

       RemoveElement方法根据ElementId移除元素。首先在TreeElements中移除元素，然后从节点向上遍历，检查元素数量过少的图种源码节点，进行塌缩重构，将子节点元素移入当前节点。

       UE八叉树查询接口包括FindElement、FindElementsWithBoundsTest等，核心目的是遍历节点和子节点以满足查询条件。UE八叉树用于高效空间数据处理，通过Octree2类声明实现。例如，PrecomputedLightVolume类定义ElementType和OctreeSemantics，便于特定应用使用。

       UE八叉树内存管理关键在于TreeElement数组，使用TInlineAllocator或FDefaultAllocator需考虑应用场景。空间数据结构如四叉树、八叉树等在空间划分算法中具有重要应用，优化碰撞检测及实现复杂场景。

UE4学习笔记（1）：UE源码下载编译+安卓打包

       注：该笔记以UE4..2在windows平台为例，vs版本为

       1.关联github和Epic账户

       要在github上获取UE4源码需要先关联账户，否则找不到源码，网页

       按照官网提供流程即可完成 GitHub上的虚幻引擎 - Unreal Engine

       记得确认邮件，否则还是（当初就是忘记了，卡了好一会儿）

       2.下载UE4源码

       在 Releases · EpicGames/UnrealEngine (github.com)中选择自己需要的版本（我使用的是4..2），这步很简单，但需要注意的是还需要将Commit.gitdeps.xml文件也一并下载，用于替换同名文件（有些版本则没有这样的文件），不替换的话后续会报错（之后步骤中会提到）

       解压后目录如下：

       3.执行bat文件

       （1）点击运行setup.bat，没有替换Commit.gitdeps.xml文件可能会出现如下问题：

       （2）点击运行GenerateProjectFiles.bat，此过程可能会出现如下问题：

       未找到框架 .NETFramework Version=v4.6.2

       只需要在VS Installer中选中安装就行：

       完成后会生成UE4.sln文件

       4.生成

       VS打开UE4.sln，开始生成：

       但是生成过程中我出现了这样的问题：

       UE4 fatal error C: 编译器限制: 达到内部堆限制

       error C: 超过了 PCH 的虚拟内存范围问题解决

       我出现这样问题的原因是我的C盘空间不够大（分区的时候给的比较少），托管系统设置在C盘，导致无法分配足够的虚拟内存，设置为空间足够的盘即可。

       步骤：电脑->属性->高级系统设置->高级->性能设置->高级->更改

       OK，成功编译完成

       5.安卓打包

       该过程有官方文档，并且比较繁琐，直接给出链接：

       设置虚幻的Android SDK和NDK | 虚幻引擎文档 (unrealengine.com)

       UE部署到Android以及杂症的解决 - 知乎 (zhihu.com)

       我就提一下自己遇到的问题，在UE4中进行安卓打包的时候遇到了这样的问题：

       原因在于SetupAndroid.bat中，SDK Platform的版本选择是，而在UE项目设置->平台 - Android SDK中的SDK API Levle默认选择latest。但是格盘源码我安装AS的时候默认给我安装了最新的Android API （此时latest指向的是版本），导致冲突。解决方法是UE项目设置中手动设置指定版本，或者在AS中卸载高于版本的Android API。

       OK，打包成功！！！

       6.打开游戏

       但是，是的，还有但是（都最后一步了，还有问题OVO！！！），在手机上下载安装，打开后是这样的：

       原来是因为打包除了生成apk文件还生成了obb，至于Google Play Store Key应该就是一个密钥了。

       解决方法是在UE项目设置->Android中勾选“将游戏数据打包至.apk中”，我们可以看到对这个勾选项的解释：

       行，勾选后重新打包，成功运行：

UE4源码剖析——Actor蓝图之CDO与SCS

       在UE的日常使用中，蓝图（UBlueprint）是我们接触最多的资产类型。每个蓝图在创建时需要选择一个父类，这决定了蓝图的类型，比如Actor蓝图、Component蓝图、Widget蓝图、动作蓝图等。以Actor蓝图为例，本文将深入探讨蓝图的基础架构，并学习如何通过代码读取蓝图资产在蓝图编辑器中的属性值。此外，本文还将重点介绍如何利用SCS框架管理新组件，并在运行时加载这些组件。

       在实际开发中，我们经常需要对蓝图进行处理，例如在大型项目中，制定一套资源规范并开发一套资源检测工具。这些工具往往需要遍历特定目录下的触摸查询源码蓝图并执行某些条件判断和处理。本文将帮助大家了解如何实现这些功能。

       **实战需求**：

       1. **例1**：要求所有放置在“Buildings”文件夹下的蓝图必须包含`StaticMeshComponent`组件，且`StaticMesh`字段不能为空。

       2. **例2**：要求“Cars”文件夹下的所有蓝图的`SceneComponent`组件移动性必需为`Movable`。

       **蓝图的父类与Actor蓝图**：

       1. **蓝图的父类**：创建蓝图时，编辑器面板中选择的父类决定蓝图的类型，例如`TestActorChild2`的父类为`TestActorChild1`，而`TestActorChild1`的父类为`TestBlueprintActor`。

       2. **Actor蓝图**：若蓝图的父类层级链最顶层是`Actor 类`，则该蓝图为`Actor蓝图`。

       **蓝图产生类**：蓝图的`_C`后缀代表蓝图产生类，它用于在编译时生成C++类，包含蓝图中的信息。

       **蓝图类（UBlueprint）**：加载蓝图包时，通过`LoadObject`函数获取到的是`UBlueprint`类。

       **蓝图骨骼类（SkeletonGeneratedClass）**：以`SKEL_`前缀和`_C`后缀加载，表示蓝图的基础信息，通常在编辑器中修改时会重新生成。

       **蓝图产生类（GeneratedClass）**：仅以`_C`为后缀加载，用于在运行时创建蓝图对象。

       **前后缀声明**：`UBlueprint.h`中的`GetBlueprintClassNames`函数定义了这些前缀。

       **Actor蓝图产生类的实例化与阶段拆分**：

       1. **CDO的构建**：`ClassDefaultObject`是每个类的默认对象，用于提供默认属性值和行为。

       2. **SCS组件附加**：通过蓝图编辑器的组件面板添加组件，这些组件存储在`SimpleConstructionScript`中，用于在运行时添加组件。

       **CDO与SCS**：

       - **CDO**：存储默认属性值与行为，节省数据传输和存储，支持配置化。

       - **SCS**：简化组件添加过程，通过蓝图编辑器直观操作组件。

       **需求回顾与实现**：通过遍历CDO和SCS，判断组件属性值，实现特定条件的检测，如`StaticMeshComponent`的`StaticMesh`字段是否为空。

       本文从实际需求出发，全面介绍了蓝图的基本概念、内部分类、构建流程以及如何利用SCS管理组件。希望本文内容能帮助开发者更深入地理解蓝图的工作原理，提高资源管理与组件处理的效率。

UE4源码剖析——异步与并行 中篇 之 Thread

       我们知道UE中的异步框架分为TaskGraph与Thread两种，上篇教程我们学习了TaskGraph，它擅长处理有依赖关系的短任务；本篇教程我们将学习Thread，它与TaskGraph相反，它更擅长于处理长任务。而下一篇文章，我们则会承接Thread，去学习一下引擎中一些重要的线程。

       Thread擅长处理长任务，从长任务生命周期这个层面来看，我们可以先把长任务分为两类：常驻型长任务与非常驻型长任务。

       常驻型长任务侧重于并行，通常用于监听式服务，例如网络传输，使用单独的线程对网络进行监听，每当有网络数据包到达时，线程接收并处理后，不会立即结束，而是重置部分状态，继续监听，等待下一轮数据包。

       非常驻型长任务侧重于异步，通常用于数据处理，例如主线程为了提高性能，避免卡顿，会将一些重负载的运算任务分发给分线程处理，可能分批给多条分线程，主线程继续运行其他逻辑。任务处理完成后，将结果返回给主线程，分线程可销毁。

       接下来，我们通过两个例子学习Thread的使用。

       计算由N到M（N和M为大数字）所有数字的和。使用Thread异步调用，将计算操作交由分线程执行，计算完成后再通知主线程结果，代码实现如下：

       逻辑分为两部分：启动分线程计算数字和，使用Async函数，参数为EAsyncExecution::Thread，创建新线程执行。学习Async函数用法，该函数返回TFuture对象，代表未来状态，当前无法获取结果，但在未来某个时刻状态变为Ready，此时可通过TFuture获取结果。

       主线程注册回调，等待分线程计算完成，使用TFuture的Then函数，完成时触发注册的回调，也可使用Wait系列函数等待计算完成。

       接下来学习常驻型任务使用。

       定义玩家血量上限点，当前点，当血量未满时，每0.2秒恢复1点血量。代码实现分为创建生命治疗仪FRunnable对象、重写Run函数、创建FRunnableThread线程、测试恢复功能和释放线程资源。

       生命治疗仪创建与测试完整代码如下，可验证生命恢复功能和暂停与恢复。

       UE4中的FRunnable与FRunnableThread提供创建常驻型任务所需接口。无论是常驻型还是非常驻型，底层实现相同，都是使用FRunnableThread线程。

       FRunnableThread线程结构包含标识符、逻辑功能、效率与性能、辅助调试字段。线程创建与生命周期分为创建FRunnable类对象、创建FRunnableThread对象两步，通过FRunnable的生命周期管理实现线程运行与停止。

       UE4线程管理流程包括继承并创建FRunnable类对象、创建FRunnableThread对象，生命治疗仪线程创建代码。

       UE4中的几种异步方式底层使用线程实现，学习了线程类型、创建、生命周期、销毁方法，为下篇学习引擎特殊线程打下基础。

[UE5.1] StateTree 使用与源码分析(二)

       深入探讨UE5.1中的StateTree，从初始化到Tick更新数据的流程，以及其背后的源码分析。

       一、StateTree的初始化流程：

       1.1、筛选未激活的Entity：UMassStateTreeActivationProcessor执行初始化时，首先会筛选出所有没有打上FMassStateTreeActivatedTag标记的Entity。

       1.2、遍历并创建上下文：接着，对这些Entity进行遍历，检查StateTreeInstanceList中是否已存在相应的StateTreeInstance。若不存在，则创建FMassStateTreeExecutionContext上下文。

       1.3、注入Fragment：将状态树所需Fragment注入，并进行验证。

       1.4、启动状态树：通过FMassStateTreeExecutionContext的Start()函数正式开始状态树的运行。

       1.5、初始化数据与确定ActivateStates：在FStateTreeExecutionContext::Start()函数中初始化数据，并确定ActivateStates数组，这代表从根节点到激活状态的所有状态。

       1.6、检查所有State的Conditions：遍历所有State，检查其条件，若有子节点，则递归检查。

       1.7、完成初始化：回到UMassStateTreeActivationProcessor，为已初始化的Entity打上Tag，完成整个初始化过程。

       二、状态树的Tick更新：

       2.1、获取并判断状态：FStateTreeExecutionContext::Tick()作为外部调用刷新状态树的接口，首先获取当前正在运行的State，并判断整个树是否仍在运行。

       2.2、刷新Evaluators：刷新所有State的Evaluators。

       2.3、刷新并处理Tasks：刷新ActiveStates中的所有State任务，重点关注TickStatus的逻辑。一旦出现返回EStateTreeRunStatus::Failed的Task，整个Tick结果将失败。如果所有Task中存在非EStateTreeRunStatus::Running状态，则根据状态返回结果。若所有Task都在EStateTreeRunStatus::Running状态中，则Tick结果为Running。

       2.4、处理状态完成与切换：如果最终Tick结果不是EStateTreeRunStatus::Running，则执行StateCompleted()函数，调用所有相关Task的StateCompleted函数。同时，检查当前State的所有Transitions，根据设置触发状态切换。

       三、使用技巧与注意事项：

       3.1、Task的InstanceData可以共享给整个State，根据Category设置决定。

       3.2、设置为Output的参数可被外部使用，Task的Output参数仅限当前State内部共享。

       3.3、Input参数的右值可引用当前State中的其他Task或Evaluator的Output参数，实现灵活的数据共享。

       3.4、Task的执行顺序决定了Output参数的使用时机，确保Task的顺序正确。

UE5引擎Paper2D插件上的IntMargin.h文件源码解读分析

       深入探索Unreal Engine 5 (UE5) 的Paper2D插件时，我们发现IntMargin.h文件中定义了FIntMargin结构体，它用于在整数网格上描述2D区域周围空间的一种数据结构。FIntMargin是一个简单而直观的结构体，用于存储和操作2D界面元素的边距。它采用结构体形式，包含四个公共成员变量：Left、Top、Right和Bottom，使用int类型存储，通过UPROPERTY宏标记为蓝图可读写，归类于Appearance类别。

       FIntMargin设计简洁，仅用于存储相关数据，无封装或继承特性。UE5的代码风格倾向于使用结构体来表示简单的数据集合。FIntMargin包含了四个构造函数，分别用于不同初始化场景，便于快速实例化。结构体通过重载+和-运算符，实现边距的加法和减法操作，简化布局调整中的边距计算。同时，==和!=运算符也被重载，用于比较两个FIntMargin实例是否相等。

       GetDesiredSize方法返回一个FIntPoint结构体，表示由当前边距定义的总尺寸，强化了FIntMargin在布局计算中的功能性。IntMargin.h文件的架构体现了UE5编码风格中的简洁性、直观性和高度的可读性，符合其对代码清晰度、性能和易用性的整体设计哲学。

       FIntMargin结构体虽然简单，但它是UE5中Paper2D插件架构中的基本构建块之一，体现了UE5的设计原则。通过理解此类基本组件，开发者可以深入掌握UE5架构的关键步骤。在未来的版本中，UE5可能会对FIntMargin进行进一步的迭代和优化，以保持其在不断演进的技术环境中的领先地位。