106 lines
3.8 KiB
Markdown
106 lines
3.8 KiB
Markdown
---
|
||
title: 自定义材质属性
|
||
date: 2026-05-03 00:00:00
|
||
excerpt: 新增 MaterialProperty、BlendMode 和材质标记
|
||
tags:
|
||
- ARC
|
||
- Rendering
|
||
- Material
|
||
rating: ⭐
|
||
---
|
||
|
||
# 自定义材质属性
|
||
|
||
返回 [[Rendering]]
|
||
|
||
## 概述
|
||
|
||
ARC 引擎在 UE4 材质系统中新增了多个材质属性（MaterialProperty）、混合模式（BlendMode）和材质标记，为卡通渲染的顶点变换和特殊效果提供材质图级别的控制能力。
|
||
|
||
## 新增材质属性
|
||
|
||
| 属性 | 枚举值 | 类型 | 用途 |
|
||
|------|--------|------|------|
|
||
| `MP_OrthoBlendWeight` | float | 顶点 | [[正交投影混合]]权重，0=透视，1=正交 |
|
||
| `MP_ScreenAlignedMeshOffset` | float3 | 顶点 | [[屏幕对齐网格]]偏移（像素单位） |
|
||
| `MP_ScreenAlignedMeshScale` | float3 | 顶点 | [[屏幕对齐网格]]缩放 |
|
||
| `MP_ScreenSpaceDepthOffset` | float | 顶点 | [[屏幕空间深度偏移]]值 |
|
||
| `MP_LocalPositionScale` | float3 | 顶点 | [[局部位置缩放]]系数 |
|
||
|
||
### Shader 端访问函数
|
||
|
||
在 `MaterialTemplate.ush` 中生成对应的访问函数：
|
||
|
||
```hlsl
|
||
float GetMaterialOrthoBlendWeight(FMaterialVertexParameters Parameters) { %s; }
|
||
float3 GetMaterialScreenAlignedMeshOffset(FMaterialVertexParameters Parameters) { %s; }
|
||
float3 GetMaterialScreenAlignedMeshScale(FMaterialVertexParameters Parameters) { %s; }
|
||
float GetMaterialScreenSpaceDepthOffset(FMaterialVertexParameters Parameters) { %s; }
|
||
float3 GetMaterialLocalPositionScale(FMaterialVertexParameters Parameters) { %s; }
|
||
```
|
||
|
||
`%s` 由 `HLSLMaterialTranslator` 在编译时替换为材质图表达式。
|
||
|
||
## 新增混合模式
|
||
|
||
| 混合模式 | 枚举值 | 混合公式 | 用途 |
|
||
|---------|--------|---------|------|
|
||
| `BLEND_X2Multiply` | — | `DestColor × SourceColor × 2` | 双倍乘法混合，用于深色叠加 |
|
||
| `BLEND_AdditiveForUI` | — | `Dest + Source × SourceAlpha` | UI 专用加法混合 |
|
||
|
||
### X2Multiply 雾效处理
|
||
|
||
在 `BasePassPixelShader.usf` 中为 X2Multiply 提供自定义雾效混合：
|
||
|
||
```hlsl
|
||
#elif MATERIALBLENDING_X2MULTIPLY
|
||
half3 FoggedColor = lerp(
|
||
float3(0.5, 0.5, 0.5), // 中灰（乘法中性色）
|
||
Color,
|
||
Fogging.aaa * Fogging.aaa);
|
||
Out.MRT[0] = half4(FoggedColor, Opacity);
|
||
```
|
||
|
||
## 新增材质标记
|
||
|
||
| 标记 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| `bScreenAlignedMesh` | bool | 启用[[屏幕对齐网格]]渲染模式 |
|
||
| `bForcedPrepass` | bool | 强制该材质走 Early-Z PrePass（ASW/Wizcorp） |
|
||
|
||
### bForcedPrepass
|
||
|
||
在 `BasePassRendering.cpp` 中控制深度绘制行为：
|
||
|
||
```cpp
|
||
// 强制 PrePass 的材质始终写入深度
|
||
if (Material.bForcedPrepass)
|
||
{
|
||
// 走 DepthPass 而非依赖 BasePass 深度写入
|
||
}
|
||
```
|
||
|
||
可在材质实例中覆盖（`MaterialEditor` 中显示为可覆盖属性）。
|
||
|
||
## REDMaterialInstanceDynamic
|
||
|
||
新增 `REDMaterialInstanceDynamic` 类（`REDMaterialInstanceDynamic.h/.cpp`），扩展了标准 `UMaterialInstanceDynamic`，可能用于运行时的卡通渲染材质参数控制。
|
||
|
||
## 关联文档
|
||
|
||
- [[正交投影混合]] — 使用 `MP_OrthoBlendWeight`
|
||
- [[屏幕对齐网格]] — 使用 `MP_ScreenAlignedMeshOffset/Scale`
|
||
- [[BasePass修改]] — `bForcedPrepass` 的影响
|
||
|
||
## 修改文件列表
|
||
|
||
| 文件 | 修改类型 |
|
||
|------|---------|
|
||
| `Source/Runtime/Engine/Public/SceneTypes.h` | 新增 `MP_*` 枚举 |
|
||
| `Source/Runtime/Engine/Classes/Materials/Material.h` | 新增 `bScreenAlignedMesh`、`bForcedPrepass` |
|
||
| `Source/Runtime/Engine/Classes/Materials/REDMaterialInstanceDynamic.h` | **新增** |
|
||
| `Source/Runtime/Engine/Private/Materials/REDMaterialInstanceDynamic.cpp` | **新增** |
|
||
| `Source/Runtime/Engine/Private/Materials/HLSLMaterialTranslator.cpp` | 编译支持 |
|
||
| `Shaders/Private/MaterialTemplate.ush` | 新增访问函数 |
|
||
| `Source/Editor/MaterialEditor/` | 编辑器 UI 支持 |
|