1. 项目概述与核心价值在UE5.2里做场景搭建或者关卡设计你是不是也经常遇到这样的困扰想快速知道两个悬崖之间的距离估算一条河流的宽度或者验证一下你摆放的建筑间距是否符合现实比例用眼睛估太不准。手动拉一个Box组件去对齐又慢又麻烦。今天要聊的这个“3D场景测量尺”就是为了解决这个痛点而生的。它不是什么惊天动地的系统但绝对是能让你日常开发效率翻倍的“瑞士军刀”式小工具。简单来说这个工具允许你在运行时的3D场景中像使用现实中的卷尺一样通过点击或者在移动端用双指触摸来动态放置测量点工具会自动用一条可视化的“尺子”样条线连接这些点并实时计算出点与点之间的直线距离甚至累计总长度结果会以清晰的世界空间UI显示出来。它的核心就是UE5蓝图系统中的样条线Spline和SplineMesh组件。样条线负责定义测量的路径和计算数据SplineMesh组件则负责将这条抽象的路径渲染成我们看得见、摸得着的3D模型比如一根有粗细、有材质的绳子或者测量带。为什么非得是蓝图样条线SplineMesh因为这套组合拳太适合干这个了。样条线组件天生就是用来处理空间曲线和路径的它内置了计算长度、获取位置、切线方向等所有我们需要的数学功能。而SplineMesh组件则能根据样条线的形状动态地拉伸一个静态网格体比如一个圆柱体来贴合路径实现“指哪打哪”的可视化。相比用一堆静态模型去拼接或者用LineTrace去画线这套方案在灵活性、性能和效果上取得了完美的平衡。无论是PC端还是移动端结合“ue5双指触摸蓝图”这样的交互都能轻松适配。2. 核心组件深度解析样条线与SplineMesh在动手搭建之前我们必须先吃透这两个核心组件的工作原理。这就像木匠要懂他的锯子和刨子用起来才能得心应手。2.1 蓝图样条线组件空间的标尺与计算核心样条线组件Spline Component是UE中用于定义空间曲线的基石。你可以把它想象成一根虚拟的、无限柔软的“线”。我们通过在这根线上设置一系列的关键点Spline Points来定义它的形状。对于测量尺来说这些关键点就是我们的测量点位。它的核心能力在于插值。给定一个从0到1的“键值”Key通常代表从起点到终点的归一化距离样条线可以立刻告诉我们该位置在世界空间中的坐标、前进方向切线甚至上方向。这对于测量尺至关重要距离计算Get Spline Length函数可以直接获取整条样条线或者任意两个键值之间的曲线长度。这就是我们测量结果的直接来源。动态更新当我们新增、移动或删除一个样条点时整条线的形状和长度会立即重新计算实现测量的实时反馈。数据驱动所有样条点的位置、旋转等信息都存储在组件内部是一个结构化的数据集合方便我们遍历和操作。在蓝图中我们通常会将一个Spline组件添加到我们的测量工具Actor上作为数据存储和计算的中心。2.2 SplineMesh组件从数据到视觉的桥梁只有数据线还不够我们需要把它画出来。SplineMesh组件Spline Mesh Component就是这支“笔”。它的工作原理是将一个给定的静态网格体如细长的立方体或圆柱体沿着一条样条线段进行拉伸和变形使其完美贴合该线段的形状。这里的关键在于“线段”。一个SplineMesh实例只能渲染样条线上两个相邻样条点之间的一段。因此如果我们的测量尺有N个点就需要N-1个SplineMesh组件来渲染整个路径。这引出了动态生成和管理多个SplineMesh的需求。SplineMesh组件有几个关键属性需要设置Start/End Position Tangent绑定到样条线上特定点的位置和切线方向。这决定了这段网格体的起点和终点如何与样条线对齐。Static Mesh指定被拉伸的基础网格体。为了模拟尺子我们通常会用一个细长的长方体或自定义的带刻度纹理的平面。Forward Axis定义网格体的哪个轴XYZ沿着样条线的切线方向拉伸。通常设置为X轴。两者的协作流程可以概括为Spline组件定义路径和计算长度 - 遍历每一对相邻的样条点 - 为每一对点创建或更新一个SplineMesh组件 - 将SplineMesh的起点/终点绑定到对应样条点的位置和切线上。这样数据的变化就能实时映射到视觉表现上。注意在UE5中对于简单的线段可视化也可以考虑使用更新的Geometry Script或Mesh Modeling工具进行动态网格生成但对于我们这种需要频繁动态更新、且形状相对简单直线段的测量工具SplineMesh在性能和易用性上依然是首选。3. 测量尺系统蓝图实战搭建理论清楚了我们开始动手。我会按照一个清晰、可复用的模块化思路来构建这个测量尺Actor。3.1 创建测量尺Actor与组件初始化首先在内容浏览器中右键创建一个新的“蓝图类”父类选择Actor命名为BP_MeasurementTape。添加核心组件打开蓝图在组件面板点击“添加组件”。添加一个Spline Component重命名为MeasurementSpline。这将是我们测量路径的数据核心。我们还需要一个用来生成和管理所有SplineMesh组件的“容器”。添加一个Scene Component作为根组件默认已有然后将MeasurementSpline拖到其下。再添加一个Scene Component作为子项重命名为SplineMeshesParent所有动态生成的SplineMesh都将附加到此组件下便于整体管理如显示/隐藏、批量销毁。定义关键变量在“我的蓝图”面板的变量表中创建以下变量SplineMeshTemplate(Static Mesh): 对象引用类型。用于指定SplineMesh要使用的静态网格体如Shape_Cylinder。将其设为可编辑实例这样我们可以在不同测量尺实例中使用不同的“尺子”外观。SplineMeshMaterial(Material Interface): 对象引用类型。用于指定SplineMesh的材质。同样设为可编辑实例方便定制颜色如红色警示尺、绿色安全尺。MeasurementUnit(Enum): 创建一个枚举类型包含厘米、米、千米等选项。再创建一个该枚举类型的变量用于设置显示单位。SplineMeshArray(Array of Spline Mesh Components): 一个SplineMesh组件引用数组。用于存储所有动态生成的SplineMesh组件方便后续更新和清理。bIsMeasuring(Boolean): 布尔值用于标记当前是否处于测量状态。3.2 实现测量点交互逻辑测量尺的核心交互是放置测量点。我们通过鼠标点击或触摸来触发。输入绑定在项目设置中绑定一个动作映射例如“PrimaryAction”到鼠标左键或触摸屏的触摸事件。射线检测放置点在BP_MeasurementTape的事件图表中监听“PrimaryAction”按下事件。从玩家控制器获取鼠标位置使用Deproject Screen to World节点转换为世界空间中的射线起点和方向。使用LineTraceByChannel节点向场景中发射一条射线。碰撞通道可以设置为WorldStatic或Visibility这取决于你想在哪些物体表面进行测量。如果射线命中Hit Result有效我们就获取命中点Hit Location的世界坐标。添加样条点将获取到的命中点坐标传递给MeasurementSpline组件的Add Spline Point at Position函数。这里有一个关键技巧为了确保SplineMesh能正确连接我们需要将新点的“切线模式”设置为Linear。这可以通过在添加点后使用Set Spline Point Type函数并将Type参数设置为Linear来实现。这样点与点之间将以直线连接符合测量尺的物理直觉。更新可视化每次成功添加一个样条点后除了第一个点因为至少需要两个点才能构成一段都需要调用一个自定义的“更新所有SplineMesh”函数我们将在下一步创建来刷新尺子的视觉表现。针对移动端双指触摸思路类似但需要处理触摸事件。你可以绑定“Touch”事件通过Get Input Touch State节点获取触摸索引和位置。通常我们可以约定用双指同时触摸并拉开的手势来模拟放置两个点并测量其距离。这需要更复杂的手势判断逻辑例如记录第一个触摸点的位置作为起点当第二个触摸点出现时将两点连线方向投射到世界空间来计算和放置终点。这涉及到将屏幕向量转换为世界空间方向并结合射线检测来确定准确的终点位置。3.3 动态生成与更新SplineMesh这是将数据转化为视觉的关键步骤。我们创建一个自定义函数命名为UpdateAllSplineMeshes。清理旧组件首先我们需要清空现有的可视化。遍历SplineMeshArray数组对其中每一个有效的SplineMesh组件调用Destroy Component。遍历完成后清空Clear该数组。计算所需段数获取MeasurementSpline组件当前的样条点数量Get Number of Spline Points。如果点数小于2则直接返回因为无法构成线段。循环生成每一段使用一个For循环索引i从0到点数-2。在循环体内创建组件使用Add Spline Mesh Component函数注意这是一个蓝图函数库中的函数用于动态创建。将其父项设置为SplineMeshesParent组件。配置网格和材质将新创建的SplineMesh组件引用存储到一个临时变量。然后设置其Set Static Mesh为SplineMeshTemplate变量设置Set Material为SplineMeshMaterial变量。绑定起点和终点这是核心步骤。起点使用Get Location at Spline Point和Get Tangent at Spline Point函数传入索引i和坐标空间World获取第i个点的世界位置和切线。将它们分别设置给SplineMesh组件的Set Start Position和Set Start Tangent。终点同理使用Get Location at Spline Point和Get Tangent at Spline Point函数传入索引i1获取第i1个点的世界位置和切线。将它们分别设置给SplineMesh组件的Set End Position和Set End Tangent。调整轴向调用SplineMesh组件的Set Forward Axis将其设置为X确保网格体沿着样条线方向正确拉伸。存入数组将创建并配置好的SplineMesh组件引用添加到SplineMeshArray数组中以便后续管理。调用时机这个UpdateAllSplineMeshes函数需要在添加新的样条点后、移动现有样条点时如果实现该功能以及初始化完成后被调用。3.4 距离计算与3D UI显示有了可视化的尺子我们还需要把数字读出来。计算长度这非常简单。在需要显示的时候例如每次更新样条点后或者每帧更新用于实时显示调用MeasurementSpline组件的Get Spline Length函数即可获得以厘米为单位的样条线总长度。单位转换根据MeasurementUnit变量的值进行单位换算。例如如果单位是“米”则将长度值除以100.0。创建3D Widget首先我们需要一个UMG Widget来设计显示界面。创建一个Widget Blueprint命名为WBP_MeasurementDisplay。在里面简单地放一个Text Block控件。在BP_MeasurementTape中添加一个Widget Component重命名为MeasurementDisplayWidget。将其Widget Class设置为刚创建的WBP_MeasurementDisplay。调整该组件的位置比如将其附着到MeasurementSpline的某个位置或者始终朝向玩家摄像机。动态更新文本在BP_MeasurementTape的事件图表中我们可以每帧Event Tick或在长度变化时进行以下操作计算当前长度和转换后的值。获取MeasurementDisplayWidget组件并调用Get User Widget Object来获取其创建的Widget实例。使用Cast To WBP_MeasurementDisplay节点进行类型转换成功后调用一个该Widget蓝图里自定义的更新函数例如UpdateDistanceText将计算好的距离字符串如“距离2.5m”传递过去。在WBP_MeasurementDisplay蓝图中这个UpdateDistanceText函数负责接收字符串并设置其Text Block的文本内容。为了让显示更友好你还可以在Widget中显示每个分段距离、总距离甚至角度信息。可以将Widget的“空间位置”设置为World这样它就会固定在3D空间中随着玩家移动它会自动调整大小以保证可读性Billboard效果。4. 功能增强与高级技巧基础功能实现后我们可以让它变得更强大、更专业。4.1 多点连续测量与数据管理我们的系统已经支持连续点击添加点实现了多点测量。但我们可以做得更好分段距离显示在UI上不仅显示总长还可以列出每一段的长度。在UpdateAllSplineMeshes的循环中使用Get Distance Along Spline at Point函数计算每个点距起点的距离相邻两点的距离差即为分段长度。将这些数据存储到一个数组变量中并传递给UI进行格式化显示。点编辑功能允许用户选中并拖动已有的样条点来调整测量路径。这需要更复杂的交互逻辑通常结合Widget Interaction Component或自定义的选中高亮例如在点上生成一个可交互的Sphere组件来实现。当点被移动后调用Update Spline Point函数更新样条线数据并再次调用UpdateAllSplineMeshes。测量数据持久化可以创建一个结构体Struct来保存一次完整的测量会话数据包括所有点的位置、时间戳、场景名称等。并提供“保存测量”、“加载测量”的功能将数据序列化保存到本地或游戏存档中。4.2 单位换算与精度控制对于严肃的场景规划单位换算和精度至关重要。内置单位系统如前所述使用枚举变量支持厘米、米、英尺、英寸等多种单位。换算公式需要预先定义好1米100厘米1米≈3.28084英尺等。精度设置在UI上添加一个精度选项例如“保留1位小数”、“保留2位小数”。在将浮点数距离转换为字符串时使用Format Float节点并指定精度格式如“0.0”或“0.00”。比例尺校准如果你的游戏世界单位与现实世界不是1:1对应例如1个虚幻单位10厘米你需要引入一个World Scale乘数变量。在最终计算显示距离时将样条线长度乘以这个比例系数再进行单位换算。4.3 性能优化与移动端适配当测量点非常多时动态生成大量SplineMesh组件可能带来性能压力。SplineMesh实例化考虑使用Instanced Static Mesh Component (ISM)来替代多个独立的SplineMesh组件。但这需要更复杂的数学计算来手动变换每个实例的位置、旋转和缩放以匹配样条线段实现难度较高但Draw Call会大幅降低。细节层次LOD当测量尺距离摄像机很远时可以降低其视觉精度。例如当距离超过一定阈值将SplineMeshTemplate替换为一个更简单、面数更低的网格体或者直接只显示UI文本而隐藏网格。移动端触摸优化针对“ue5双指触摸蓝图”的需求触摸输入的处理要更加稳健。需要处理触摸开始、移动、结束的完整生命周期防止误触。对于双指测距一个实用的技巧是在触摸开始事件中判断如果当前已有两个有效的测量点则清空并开始一次新的测量避免状态混乱。同时移动端的UI字体需要更大确保在小屏幕上清晰可读。5. 常见问题排查与调试心得在实际开发中你肯定会遇到一些“坑”。这里分享几个我踩过的雷和解决方法。5.1 SplineMesh显示异常或不更新问题现象SplineMesh不显示或者显示为扭曲、断开的状态移动点后视觉不更新。排查步骤检查静态网格体确认SplineMeshTemplate变量是否正确赋值了一个有效的静态网格体。尝试用一个简单的Shape_Cube来测试。检查切线方向这是最常见的问题。确保在设置SplineMesh的Start/End Tangent时使用的是从Get Tangent at Spline Point获取的值并且坐标空间一致通常用World。如果切线向量是零向量SplineMesh可能无法正确生成。对于直线测量将切线模式设为Linear可以保证切线方向是点之间的方向差。检查生成顺序确保在UpdateAllSplineMeshes函数中是先清理旧组件再生成新的。如果顺序反了可能导致引用错误。检查函数调用确认在添加、移动、删除样条点后都正确调用了UpdateAllSplineMeshes函数。调试输出在蓝图中使用Print String节点输出样条点的数量、位置和切线值验证数据是否正确。5.2 距离计算不准或单位错误问题现象显示的距离数值明显不符合场景视觉比例。排查步骤确认世界单位首先明确UE默认的单位1虚幻单位1厘米。用已知尺寸的物体如一个100单位长的Box验证Get Spline Length的返回值。检查比例系数如果你自定义了世界比例检查换算公式是否正确。长度值厘米 * 比例系数 目标单位值。验证样条点类型如果样条点类型不是Linear而是Curve等Get Spline Length计算的是曲线长度可能会略长于直线距离。对于测量尺务必使用Linear类型。5.3 3D Widget显示问题问题现象Widget不显示、大小不对、或者不朝向摄像机。排查步骤检查Widget组件属性确保MeasurementDisplayWidget组件的Visibility为可见Widget Class已正确设置。检查空间位置将Widget组件的Space属性设置为World这样它才会存在于3D空间。Draw Size属性决定了Widget的渲染分辨率可以适当调大。检查朝向默认情况下Widget组件有一个bBillboard属性勾选后它会始终面向摄像机。如果希望它有固定朝向可以取消勾选并手动设置旋转。检查ZOrder如果Widget被场景中其他物体遮挡可以尝试调整Widget组件的Render Priority渲染优先级使其更高。5.4 在复杂场景中射线检测失败问题现象点击某些物体表面无法放置测量点。排查步骤检查碰撞通道确认LineTraceByChannel使用的碰撞通道如Visibility或WorldStatic是否与目标物体的碰撞预设Collision Preset匹配。你可以在目标物体的Collision属性中查看和修改。检查碰撞复杂度对于复杂网格体确保其碰撞体Collision Complexity不是No Collision。可以尝试使用Use Complex Collision As Simple来获得更精确的命中结果但这有性能开销。调试射线在发射射线时使用Draw Debug Line节点将射线可视化出来确认射线的起点和方向是否符合预期。这个3D场景测量尺虽然是一个相对独立的小工具但它所涉及的蓝图交互、组件动态管理、数据可视化等思想在UE5开发中非常通用。把它做扎实了以后做路径绘制、绳索物理、动态管道生成等功能都会觉得似曾相识。最关键的是它能立刻为你和团队的设计工作带来实实在在的效率提升这才是工具最大的价值。