1.UE5 ModelingMode & GeometryScript源码学习（一）
2.UE入门笔记（1）：编译UE4源码 + apk打包
3.越学越多——获取虚幻源码
4.游戏引擎随笔 0x36：UE5.x Nanite 源码解析之可编程光栅化（下）
5.UE4源码剖析——异步与并行 中篇 之 Thread
6.UE4学习笔记（1）：UE源码下载编译+安卓打包

UE5 ModelingMode & GeometryScript源码学习（一）

       前言

       ModelingMode是源码虚幻引擎5.0后的新增功能，用于直接在引擎中进行3D建模，视频无需外接工具，源码实现快速原型设计和特定需求的视频模型创建。GeometryScript是源码用于通过编程方式创建和操控3D几何体的系统，支持蓝图或Python脚本，视频安居客地图 源码提供灵活控制能力。源码

       本文主要围绕ModelingMode与GeometryScript源码学习展开，视频涵盖DMC简介、源码查找感兴趣功能源码、视频动态网格到静态网格的源码代码介绍。

       起因

       在虚幻4中，视频通过RuntimeMeshComponent或ProceduralMeshComponent组件实现简单模型的源码程序化生成。动态网格组件（DynamicMeshComponent）在UE5中提供了额外功能，视频如三角面级别处理、源码转换为StaticMesh/Volume、烘焙贴图和编辑UV等。

       将动态网格对象转换为静态网格对象时，发现官方文档对DMC与PMC对比信息不直接涉及此转换。通过搜索发现，DynamicMesh对象转换为StaticMesh对象的代码位于Source/Runtime/MeshConversion目录下的UE::Modeling::CreateMeshObject函数中。

       在UE::Modeling::CreateMeshObject函数内，使用UEditorModelingObjectsCreationAPI对象进行动态网格到静态网格的转换，通过HasMoveVariants()函数接受右值引用参数。UEditorModelingObjectsCreationAPI::CreateMeshObject函数进一步处理转换参数，UE::Modeling::CreateStaticMeshAsset函数负责创建完整的静态网格资产。

       总结转换流程，DynamicMesh对象首先收集世界、变换、资产名称和材质信息，通过FCreateMeshObjectParams对象传递给UE::Modeling::CreateMeshObject函数，该函数调用UE::Modeling::CreateStaticMeshAsset函数创建静态网格资产。

       转换为静态网格后，程序创建了一个静态网格Actor和组件。此过程涉及静态网格属性设置，最终返回FCreateMeshObjectResult对象表示转换成功。

       转换静态网格为Volume、动态网格同样在相关函数中实现。

       在Modeling Mode中添加基础形状涉及UInteractiveToolManager::DeactivateToolInternal函数，当接受基础形状时，调用UAddPrimitiveTool::GenerateAsset函数，根据面板选择的输出类型创建模型。

       最后，UAddPrimitiveTool::Setup函数创建PreviewMesh对象，UAddPrimitiveTool::UpdatePreviewMesh()函数中通过UAddPrimitiveTool::GenerateMesh生成网格数据填充FDynamicMesh3对象，进而更新到PreviewMesh中。

       文章总结了Modeling Mode与GeometryScript源码的学习路径，从动态网格到静态网格的转换、基础形状添加到输出类型对应函数，提供了一条完整的流程概述。

UE入门笔记（1）：编译UE4源码 + apk打包

       实验环境：win / VS专业版 / UE4..

       准备工作①获取UE4源码：按照官方教程，完成邮件确认后即可下载 UE4..2源码。

       记得下载Commit.gitdeps.xml文件，archlinux怎么获取源码后续会用到。

       ②VS安装工具包：打开Visual Studio Installer，选中并安装

       2、编译

       下面操作均基于UE4源码文件夹

       ①执行bat文件

       a)运行setup.bat，如出现下面错误，则需要替换Commit.gitdeps.xml文件

       b)运行GenerateProjectFiles.bat，如出现下面错误，则将文件路径改短

       ②编译

       打开UE4.sln，右键UE4选“生成”，编译过程多分钟

       ③UE4，启动！

       编译完成后，打开Engine\Binaries\Win，找到UE4Editor.exe，即可启动。

       3、安卓环境配置

       下载Android Studio并在UE4部署安卓：参考官方教程以及UE部署到Android以及杂症的解决，配置过程较为复杂，一步步来不要跳步。

       4、打包并测试

       打包过程报错：

       ①packagingresults: error: failed to build "uattempproj.proj"

       解决：打开项目.sln，重新生成AutomationTool

       ②找不到dx文件

       解决：打开C:\Users\Administrator\AppData\Local\Android\Sdk\build-tools，将或版本文件夹中的dx.bat 和 lib 文件夹中的 dx.jar 复制到 .0.0 版本文件夹的对应位置。（build-tools从版本之后把dx的方式去掉了，而UE需要这个，没有的话会发布失败）

       手机测试报错：

       ①No Google Play Store Key

       解决：UE项目设置->Android中勾选“将游戏数据打包至.apk中”，重新打包

       参考链接

       ① UE部署到Android以及杂症的解决

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

       ③ 油管教程《Unreal Engine 4..2 Packaging For Android | Unreal Engine 4..2 Export Android Project》

越学越多——获取虚幻源码

       游戏开发领域，知识永无止境。

       那么，如何获取虚幻引擎的源码呢？

       获得源码方法一：

       官方教程：unrealengine.com/zh-CN/...

       第一步：关联账户

       1. 打开Epic Games启动器，点击管理账户后，跳转网页。

       2. 如果网页无法打开，直接访问unrealengine.com/accoun...

       3. 进入后，点击关联GitHub账户，点击授权EpicGames按钮，完成OAuth应用授权流程。

       4. 接收邮件，加入GitHub上的@EpicGames组织。

       第二步：下载源码

       1. 登录GitHub账号。

       2. 在GitHub个人页面点击右上角Your profile，进入后点击这个图标（有这个图标表示已经加入虚幻组织）。

       3. 进入后，找到虚幻源码仓库，双击进入。

       4. 下载源码。

       第三步：打开源码文件

       1. 下载后解压，地址不能有中文和空格。

       2. 运行setup.bat，可能报错无法下载。

       - 第一种错误：Failed to download 'cdn.unrealengine.com/de...': 远程服务器返回错误: () 已禁止。 (WebException)

       解决办法：要解决此问题，网站源码led电源您需要获取位于此处的文件：github.com/EpicGames/Un...

       然后替换engine/build/commit.gitdeps.xml版本中的文件。

       文件在这，点击下载Commit.gitdeps.xml。

       - 第二种错误：下载至%时，下载失败。

       解决办法：UE4源码下载对于文件路径长度有要求，将文件夹名字改短即可，6个字符长度。

       再次运行Setup.bat，即可成功。这个阶段时间很长。

       双击运行GenerateProjectFiles.bat文件，运行结束会生成UE5.sln文件，这个就是源码啦！

       获取源码方法二：

       这个方法适合只是想要了解学习引擎底层原理，并不用于编译的情况。

       快速打开代码去查看，一般用于非程序人员想要进阶了解引擎原理的时候。

       前提，安装Visual Studio。

       第一步：打开虚幻引擎工程。

       第二步：新建蓝图类，比如actor。

       第三步：新建C++组件，选择actor组件。

       第四步：创建类。

       第五步：完成，在Visual Studio里查看代码。

游戏引擎随笔 0x：UE5.x Nanite 源码解析之可编程光栅化（下）

       书接上回。

       在展开正题之前，先做必要的铺垫，解释纳尼特(Nanite)技术方案中的Vertex Reuse Batch。纳尼特在软光栅路径实现机制中，将每个Cluster对应一组线程执行软光栅，每ThreadGroup有个线程。在光栅化三角形时访问三角形顶点数据，但顶点索引范围可能覆盖整个Cluster的个顶点，因此需要在光栅化前完成Cluster顶点变换。纳尼特将变换后的顶点存储于Local Shared Memory(LDS)中，进行组内线程同步，确保所有顶点变换完成，光栅化计算时直接访问LDS，实现软光栅高性能。

       然而，在使用PDO(Masked)等像素可编程光栅化时，纳尼特遇到了性能问题。启用PDO或Mask时，可能需要读取Texture，根据读取的Texel决定像素光栅化深度或是否被Discard。读取纹理需计算uv坐标，而uv又需同时计算重心坐标，增加指令数量，诱导源码交易降低寄存器使用效率，影响Active Warps数量，降低延迟隐藏能力，导致整体性能下降。复杂材质指令进一步加剧问题。

       此外，当Cluster包含多种材质时，同一Cluster中的三角形被重复光栅化多次，尤其是材质仅覆盖少数三角形时，大量线程闲置，浪费GPU计算资源。

       为解决这些问题，纳尼特引入基于GPU SIMT/SIMD的Vertex Reuse Batch技术。技术思路如下：将每个Material对应的三角形再次分为每个为一组的Batch，每Batch对应一组线程，每个ThreadGroup有个线程，正好对应一个GPU Warp。利用Wave指令共享所有线程中的变换后的顶点数据，无需LDS，减少寄存器数量，增加Warp占用率，提升整体性能。

       Vertex Reuse Batch技术的启用条件由Shader中的NANITE_VERT_REUSE_BATCH宏控制。

       预处理阶段，纳尼特在离线时构建Vertex Reuse Batch，核心逻辑在NaniteEncode.cpp中的BuildVertReuseBatches函数。通过遍历Material Range，统计唯一顶点数和三角形数，达到顶点去重和优化性能的目标。

       最终，数据被写入FPackedCluster，根据材质数量选择直接或通过ClusterPageData存储Batch信息。Batch数据的Pack策略确保数据对齐和高效存储。

       理解Vertex Reuse Batch后，再来回顾Rasterizer Binning的数据：RasterizerBinData和RasterizerBinHeaders。在启用Vertex Reuse Batch时，这两者包含的是Batch相关数据，Visible Index实际指的是Batch Index，而Triangle Range则对应Batch的三角形数量。

       当Cluster不超过3个材质时，直接从FPackedCluster中的VertReuseBatchInfo成员读取每个材质对应的BatchCount。有了BatchCount，即可遍历所有Batch获取对应的三角形数量。在Binning阶段的ExportRasterizerBin函数中，根据启用Vertex Reuse Batch的条件调整BatchCount，表示一个Cluster对应一个Batch。

       接下来，遍历所有Batch并将其对应的Cluster Index、Triangle Range依次写入到RasterizerBinData Buffer中。启用Vertex Reuse Batch时，通过DecodeVertReuseBatchInfo函数获取Batch对应的三角形数量。对于不超过3个材质的异步提交表单源码Cluster，DecodeVertReuseBatchInfo直接从Cluster的VertReuseBatchInfo中Unpack出Batch数据，否则从ClusterPageData中根据Batch Offset读取数据。

       在Binning阶段的AllocateRasterizerBinCluster中，还会填充Indirect Argument Buffer，将当前Cluster的Batch Count累加，用于硬件光栅化Indirect Draw的Instance参数以及软件光栅化Indirect Dispatch的ThreadGroup参数。这标志着接下来的光栅化Pass中，每个Instance和ThreadGroup对应一个Batch，以Batch为光栅化基本单位。

       终于来到了正题：光栅化。本文主要解析启用Vertex Reuse Batch时的软光栅源码，硬件光栅化与之差异不大，此处略过。此外，本文重点解析启用Vertex Reuse Batch时的光栅化源码，对于未启用部分，除可编程光栅化外，与原有固定光栅化版本差异不大，不再详细解释。

       CPU端针对硬/软光栅路径的Pass，分别遍历所有Raster Bin进行Indirect Draw/Dispatch。由于Binning阶段GPU中已准备好Draw/Dispatch参数，因此在Indirect Draw/Dispatch时只需设置每个Raster Bin对应的Argument Offset即可。

       由于可编程光栅化与材质耦合，导致每个Raster Bin对应的Shader不同，因此每个Raster Bin都需要设置各自的PSO。对于不使用可编程光栅化的Nanite Cluster，即固定光栅化，为不降低原有性能，在Shader中通过两个宏隔绝可编程和固定光栅化的执行路径。

       此外，Shader中还包括NANITE_VERT_REUSE_BATCH宏，实现软/硬光栅路径、Compute Pipeline、Graphics Pipeline、Mesh Shader、Primitive Shader与材质结合生成对应的Permutation。这部分代码冗长繁琐，不再详细列出讲解，建议自行阅读源码。

       GPU端软光栅入口函数依旧是MicropolyRasterize，线程组数量则根据是否启用Vertex Reuse Batch决定。

       首先判断是否使用Rasterizer Binning渲染标记，启用时根据VisibleIndex从Binning阶段生成的RasterizerBinHeaders和RasterizerBinData Buffer中获取对应的Cluster Index和光栅化三角形的起始范围。当启用Vertex Reuse Batch，这个范围是Batch而非Cluster对应的范围。

       在软光栅中，每线程计算任务分为三步。第一步利用Wave指令共享所有线程中的Vertex Attribute，线程数设置为Warp的Size，目前为，每个Lane变换一个顶点，最多变换个顶点。由于三角形往往共用顶点，直接根据LaneID访问顶点可能重复，为确保每个Warp中的每个Lane处理唯一的顶点，需要去重并返回当前Lane需要处理的唯一顶点索引，通过DeduplicateVertIndexes函数实现。同时返回当前Lane对应的三角形顶点索引，用于三角形设置和光栅化步骤。

       获得唯一顶点索引后，进行三角形设置。这里代码与之前基本一致，只是写成模板函数，将Sub Pixel放大倍数SubpixelSamples和是否背面剔除bBackFaceCull作为模板参数，通过使用HLSL 语法实现。

       最后是光栅化三角形写入像素。在Virtual Shadow Map等支持Nanite的场景下，定义模板结构TNaniteWritePixel来实现不同应用环境下Nanite光栅化Pipeline的细微差异。

       在ENABLE_EARLY_Z_TEST宏定义时，调用EarlyDepthTest函数提前剔除像素，减少后续重心坐标计算开销。当启用NANITE_PIXEL_PROGRAMMABLE宏时，可以使用此机制提前剔除像素。

       最后重点解析前面提到的DeduplicateVertIndexes函数。

       DeduplicateVertIndexes函数给每个Lane返回唯一的顶点索引，同时给当前Lane分配三角形顶点索引以及去重后的顶点数量。

       首先通过DecodeTriangleIndices获取Cluster Local的三角形顶点索引，启用Cluster约束时获取所有Lane中最小的顶点索引，即顶点基索引。将当前三角形顶点索引（Cluster Local）减去顶点基索引，得到相对顶点基索引的局部顶点索引。

       接下来生成顶点标志位集合。遍历三角形三个顶点，将局部顶点索引按顺序设置到对应位，表示哪些顶点已被使用。每个标志位是顶点的索引，并在已使用的顶点位置处设置为1。使用uint2数据类型，最多表示个顶点位。

       考虑Cluster最多有个顶点，为何使用位uint2来保存Vertex Mask而非位？这是由于Nanite在Build时启用了约束机制（宏NANITE_USE_CONSTRAINED_CLUSTERS），该机制保证了Cluster中的三角形顶点索引与当前最大值之差必然小于（宏CONSTRAINED_CLUSTER_CACHE_SIZE），因此，生成的Triangle Batch第一个索引与当前最大值之差将不小于，并且每个Batch最多有个唯一顶点，顶点索引差的最大值为，仅需2个位数据即可。约束机制确保使用更少数据和计算。

       将所有Lane所标记三个顶点的Vertex Mask进行位合并，得到当前Wave所有顶点位掩码。通过FindNthSetBit函数找出当前Lane对应的Mask索引，加上顶点基索引得到当前Lane对应的Cluster Local顶点索引。

       接下来获取当前Lane对应的三角形的Wave Local的三个顶点索引，用于后续通过Wave指令访问其他Lane中已经计算完成的顶点属性。通过MaskedBitCount函数根据Vertex Mask以及前面局部顶点索引通过前缀求和得到当前Lane对应的Vertex Wave Local Index。

       最后统计Vertex Mask所有位，返回总计有效的顶点数量。

       注意FindNthSetBit函数，实现Lane与顶点局部索引（减去顶点基索引）的映射，返回当前Lane对应的Vertex Mask中被设置为1的位索引。如果某位为0，则返回下一个位为1的索引。如果Mask中全部位都设置为1，则实际返回为Lane索引。通过二分法逐渐缩小寻找索引范围，不断更新所在位置，最后返回找到的位置索引。

       最后，出于验证目的进行了Vertex Reuse Batch的性能测试。在材质包含WPO、PDO或Mask时关闭Vertex Reuse Batch功能，与开启功能做对比。测试场景为由每颗万个三角形的树木组成的森林，使用Nsight Graphics进行Profiling，得到GPU统计数据如下：

       启用Vertex Reuse Batch后，软光栅总计耗时减少了1.毫秒。SM Warp总占用率有一定提升。SM内部工作量分布更加均匀，SM Launch的总Warp数量提升了一倍。长短板Stall略有增加，但由于完全消除了由于LDS同步导致的Barrier Stall，总体性能还是有很大幅度的提升。

       至此，Nanite可编程光栅化源码解析讲解完毕。回顾整个解析过程，可以发现UE5团队并未使用什么高深的黑科技，而是依靠引擎开发者强悍的工程实现能力完成的，尤其是在充分利用GPU SIMT/SIMD机制榨干机能的同时，保证了功能与极限性能的实现。这种能力和精神，都很值得我们学习。

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

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中”，我们可以看到对这个勾选项的解释：

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

UE动画优化之URO(UpdateRateOptimizations)源码解析

       1. URO技术是Unreal Engine动画优化的重要组成部分，它通过智能调整远离摄像头的对象的动画帧率，实现了动画质量和性能的平衡。

       2. 在UE中，URO与LOD和VisibilityBasedAnimTick协同工作，核心动画处理主要在USkeletalMeshComponent的TickComponent和TickPose中执行。

       3. FAnimUpdateRateManager负责指挥整个动画更新频率的调整过程，根据对象距离、LOD等因素动态地进行优化，确保每一帧的动画都既流畅又经济。

       4. USkinnedMeshComponent通过TickUpdateRate和FAnimUpdateRateManager的配合，实现了URO的效果。开发者可以通过SetTrailMode和SetLookAheadMode等函数，对动画参数进行精细调整，使角色动作既自然又节能。

       5. 要掌握URO，关键在于四个策略：命令行魔法、距离阈值决定论、LOD定制策略和插值选项。这些策略可以通过CVarEnableAnimRateOptimization、CVarForceAnimRate、MaxDistanceFactor、LODToFrameSkipMap等参数进行调整。

       6. SkeletalMesh组件提供了VisibilityBasedAnimTickOption设置，以实现不同状态下的动画表现一致性。

       7. 使用DisplayDebugUpdateRateOptimizations，开发者可以可视化URO的运行情况，帮助精准调整优化策略，提升游戏性能。

       8. 通过细致的设置，URO就像一位精密的调音师，为游戏世界赋予了动态且高效的动画生命。