局部位置缩放

返回 Rendering

概述

允许通过材质图在局部空间（Local Space）对顶点位置进行缩放，实现不依赖 Actor Transform 的比例调整。

实现

在各 VertexFactory 中通过 VertexFactoryUpdateLocalPositionScale 函数实现：

void VertexFactoryUpdateLocalPositionScale(
    inout FVertexFactoryInput Input,
    inout FVertexFactoryIntermediates Intermediates,
    float3 scale)
{
    Input.Position.xyz *= scale;
}

由 USES_LOCAL_POSITION_SCALE 宏控制启用，在世界变换之前应用。

使用场景

角色部件的动态缩放（如拳头放大的夸张动画效果）
不同 LOD 级别的微调
格斗游戏中攻击判定与视觉表现分离时的视觉调整

材质属性

MP_LocalPositionScale（float3）通过材质图控制。参见自定义材质属性。

完整代码解析

LocalVertexFactory.ush — 缩放函数定义

// 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 — 调用流程

// 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` 材质访问函数

3.8 KiB Raw Blame History Unescape Escape