83 lines
3.5 KiB
Markdown
83 lines
3.5 KiB
Markdown
---
|
||
title: UE4.25传统渲染方式的代码迁移指南
|
||
date: 2020-11-10 13:55:15
|
||
tags: Shader
|
||
rating: ⭐️
|
||
---
|
||
## 前言
|
||
4.25的GlobalShader的调用代码发生了一下变化，我在写完RDG例子后顺便写了一下GlobalShader的使用案例。具体的可以参考我的插件：
|
||
|
||
[https://github.com/blueroseslol/BRPlugins](https://github.com/blueroseslol/BRPlugins)
|
||
|
||
代码位于SimpleGlobalShader.cpp中。
|
||
|
||
## 变量使用LAYOUT_FIELD宏进行包裹
|
||
对于新定义用于设置变量的GlobalShader基类使用，需要使用**DECLARE_INLINE_TYPE_LAYOUT**(FYourShaderName,NonVirtual)宏进行声明。另外还有**DECLARE_TYPE_LAYOUT**(FYourShaderName,NonVirtual)宏，不太清楚差别，但作用应该是一样的。
|
||
|
||
除此之外还有
|
||
```
|
||
class FSimpleGlobalShader : public FGlobalShader
|
||
{
|
||
DECLARE_INLINE_TYPE_LAYOUT(FSimpleGlobalShader, NonVirtual);
|
||
public:
|
||
static bool ShouldCompilePermutation(const FGlobalShaderPermutationParameters& Parameters)
|
||
{
|
||
return IsFeatureLevelSupported(Parameters.Platform, ERHIFeatureLevel::SM5);
|
||
}
|
||
|
||
static void ModifyCompilationEnvironment(const FGlobalShaderPermutationParameters& Parameters, FShaderCompilerEnvironment& OutEnvironment)
|
||
{
|
||
FGlobalShader::ModifyCompilationEnvironment(Parameters, OutEnvironment);
|
||
OutEnvironment.SetDefine(TEXT("TEST_MICRO"), 1);
|
||
}
|
||
|
||
FSimpleGlobalShader(){}
|
||
|
||
FSimpleGlobalShader(const ShaderMetaType::CompiledShaderInitializerType& Initializer):FGlobalShader(Initializer)
|
||
{
|
||
SimpleColorVal.Bind(Initializer.ParameterMap, TEXT("SimpleColor"));
|
||
TextureVal.Bind(Initializer.ParameterMap, TEXT("TextureVal"));
|
||
TextureSampler.Bind(Initializer.ParameterMap, TEXT("TextureSampler"));
|
||
}
|
||
|
||
template<typename TRHIShader>
|
||
void SetParameters(FRHICommandList& RHICmdList,TRHIShader* ShaderRHI,const FLinearColor &MyColor, FTexture2DRHIRef InInputTexture)
|
||
{
|
||
SetShaderValue(RHICmdList, ShaderRHI, SimpleColorVal, MyColor);
|
||
SetTextureParameter(RHICmdList, ShaderRHI, TextureVal, TextureSampler,TStaticSamplerState<SF_Trilinear,AM_Clamp,AM_Clamp,AM_Clamp>::GetRHI(), InInputTexture);
|
||
}
|
||
|
||
private:
|
||
LAYOUT_FIELD(FShaderResourceParameter, TextureVal);
|
||
LAYOUT_FIELD(FShaderResourceParameter, TextureSampler);
|
||
LAYOUT_FIELD(FShaderParameter, SimpleColorVal);
|
||
};
|
||
```
|
||
|
||
第二个形参视类内是否有虚函数，选择Abstract或者NonVirtual。源代码里基本上都是使用NonVirtual的。
|
||
|
||
另一个不常用的宏是**DECLARE_EXPORTED_TYPE_LAYOUT**(FYourShaderName, YOUR_API, Virtual)，它用于声明需要被其他类继承的基类。具体的使用方法还请参照UE4源码。
|
||
|
||
Shader变量需要使用LAYOUT_FIELD宏进行包裹，第一个形参为类型，普通类型声明为FShaderParameter，Texture2d与Sampler声明为FShaderResourceParameter。例如：
|
||
```
|
||
LAYOUT_FIELD(FShaderParameter, SimpleColorVal);
|
||
LAYOUT_FIELD(FShaderResourceParameter, TextureVal);
|
||
LAYOUT_FIELD(FShaderResourceParameter, TextureSampler);
|
||
```
|
||
## Shader声明改变
|
||
声明宏由DECLARE_SHADER_TYPE(FSimplePixelShader, Global)转变为DECLARE_GLOBAL_SHADER(FSimplePixelShader)。
|
||
|
||
## 去除序列化相关函数
|
||
去掉virtual bool Serialize(FArchive& Ar) override函数。
|
||
|
||
LAYOUT_FIELD宏会实现这部分功能。
|
||
|
||
## FImageWriteTask
|
||
FImageWriteTask现在接受TArray64的数据。而不是 TArray。如果你想传递TArray数据，可以这么写：
|
||
```
|
||
TArray<FColor> OutBMP;
|
||
// Fill OutBMP somehow
|
||
TUniquePtr<TImagePixelData<FColor>> PixelData = MakeUnique<TImagePixelData<FColor>>(DestSize);
|
||
PixelData->Pixels = OutBMP;
|
||
ImageTask->PixelData = MoveTemp(PixelData);
|
||
``` |