vault backup: 2026-05-03 21:38:46

03-UnrealEngine/卡通渲染相关资料/渲染功能/ARC/Rendering/局部位置缩放.md

@@ -43,12 +43,62 @@ void VertexFactoryUpdateLocalPositionScale(
 
 `MP_LocalPositionScale`（float3）通过材质图控制。参见 [[自定义材质属性]]。
 
-## 修改文件列表
+## 完整代码解析
 
-| 文件 | 修改类型 |
-|------|---------|
-| `Shaders/Private/LocalVertexFactory.ush` | 新增缩放函数 |
-| `Shaders/Private/GpuSkinVertexFactory.ush` | 同上 |
-| `Shaders/Private/LandscapeVertexFactory.ush` | 同上 |
-| `Shaders/Private/MeshParticleVertexFactory.ush` | 同上 |
-| 所有 Particle VertexFactory | 同上 |
+### LocalVertexFactory.ush — 缩放函数定义
+
+```hlsl
+// LocalVertexFactory.ush — 缩放函数定义
+// ASW Change : 2016/06/29 17:05:39 Takuro.K
+#if USES_LOCAL_POSITION_SCALE
+void VertexFactoryUpdateLocalPositionScale(
+    inout FVertexFactoryInput Input,           // 顶点输入（可修改）
+    inout FVertexFactoryIntermediates Intermediates,  // 中间数据
+    float3 scale)                               // 缩放系数 (x, y, z)
+{
+    // 直接在局部空间缩放顶点位置
+    // 在 WorldTransform 之前应用，所以效果与 Actor Scale 类似
+    // 但由材质图控制，可以做动画
+    Input.Position.xyz *= scale;
+}
+#endif
+```
+
+### BasePassVertexShader.usf — 调用流程
+
+```hlsl
+// BasePassVertexShader.usf — 调用流程
+// ASW Change : 2016/06/29 17:05:39 Takuro.K
+#if USES_LOCAL_POSITION_SCALE
+    {
+        // 1. 从材质图获取缩放系数
+        // 2. 应用到顶点的局部坐标
+        VertexFactoryUpdateLocalPositionScale(Input, VFIntermediates, 
+            GetMaterialLocalPositionScale(VertexParameters));
+        
+        // 3. 重新计算世界坐标（因为局部坐标已改变）
+        WorldPositionExcludingWPO = VertexFactoryGetWorldPosition(Input, VFIntermediates);
+        WorldPosition = WorldPositionExcludingWPO;
+
+        // 4. 重新获取切线空间和材质参数
+        TangentToLocal = VertexFactoryGetTangentToLocal(Input, VFIntermediates);
+        VertexParameters = GetMaterialVertexParameters(
+            Input, VFIntermediates, WorldPosition.xyz, TangentToLocal);
+    }
+#endif
+```
+
+## 代码修改情况
+
+| 文件路径 | 行号 | 修改类型 | 修改内容 |
+|---------|------|---------|---------|
+| `Shaders/Private/BasePassVertexShader.usf` | L64~L76 | 新增 | 调用 `VertexFactoryUpdateLocalPositionScale` + 重算世界坐标 |
+| `Shaders/Private/LocalVertexFactory.ush` | L1171~L1179 | 新增 | `VertexFactoryUpdateLocalPositionScale` 函数（`Input.Position.xyz *= scale`） |
+| `Shaders/Private/GpuSkinVertexFactory.ush` | L822~L830 | 新增 | 同上（GPU 蒙皮版本） |
+| `Shaders/Private/LandscapeVertexFactory.ush` | L948~L958 | 新增 | 同上（Landscape 版本） |
+| `Shaders/Private/MeshParticleVertexFactory.ush` | L728~L736 | 新增 | 同上（MeshParticle 版本） |
+| `Shaders/Private/ParticleSpriteVertexFactory.ush` | L684~L691 | 新增 | 同上（ParticleSprite 版本） |
+| `Shaders/Private/ParticleGPUSpriteVertexFactory.ush` | L698~L706 | 新增 | 同上（ParticleGPUSprite 版本） |
+| `Shaders/Private/ParticleBeamTrailVertexFactory.ush` | L246~L253 | 新增 | 同上（ParticleBeamTrail 版本） |
+| `Shaders/Private/VectorFieldVisualizationVertexFactory.ush` | L202~L210 | 新增 | 同上（VectorField 版本） |
+| `Shaders/Private/MaterialTemplate.ush` | L2263~L2268 | 新增 | `GetMaterialLocalPositionScale` 材质访问函数 |