GlobalShaderExample_UE4.26

UE4.26 Version of GlobalShaderCreattion

因为这篇文章已经不适用于UE4.26

且这篇文章中提到的Repository 中又有过多与创建GlobalShader不相干的东西，所以我在这里参考这两篇文章及代码做了修改，使其适用于UE4.26.

测试方法

新建C++工程
在工程内创建Plugins目录,将此插件clone至其中
编译后，创建三个资源：Render Target，材质球，和一个继承Actor的蓝图类
材质球内，将RenderTargetTexture连接到Base Color
蓝图类内，设置按下任意键，调用DrawTestShaderRenderTarget，其中Output Render Target设置为第三步创建的Render Target, My Texture设置为任意导入的贴图， My Color设置为任意颜色， WorldContextObject设置为一个self引用
将蓝图类放入关卡，并设置其接受输入
在场景中任意放置一个物体，并赋予第三步创建的材质球
运行，按下第五步设置的按键，观察物体材质的变化

GlobalShader 4.26 变动

整体参考

参考引擎自带插件LensDistortion(缺少传入贴图的部分)

Plugins/Compositing/LensDistortion

细节变动

Build.cs

PrivateDependencyModuleNames 中还要添加一个Projects，因为 IPluginManager.h现在位于Runtime/Projects目录下

去掉Serialize函数

彻底删除这个函数，不需要了

virtual bool Serialize(FArchive& Ar) override

FGlobalShaderMap

FGlobalShaderMap 替代了原来的

TShareMap<FGlobalShaderType>

旧代码:

TShaderMap<FGlobalShaderType>* GlobalShaderMap = GetGlobalShaderMap(FeatureLevel);

新代码:

FGlobalShaderMap* GlobalShaderMap = GetGlobalShaderMap(FeatureLevel);

GETSAFERHISHADER_VERTEX

这个宏已经不存在了，直接使用XXXShader.GetXXXShader()函数代替旧代码：

GraphicsPSOInit.BoundShaderState.VertexShaderRHI = GETSAFERHISHADER_VERTEX(*VertexShader);
GraphicsPSOInit.BoundShaderState.PixelShaderRHI = GETSAFERHISHADER_PIXEL(*PixelShader);

新代码：

GraphicsPSOInit.BoundShaderState.VertexShaderRHI = VertexShader.GetVertexShader();
GraphicsPSOInit.BoundShaderState.PixelShaderRHI = PixelShader.GetPixelShader();

GetPixelShader

SetShaderValue(RHICmdList, GetPixelShader(), SimpleColorVal, MyColor);

GetPixelShader()已经不是GlobalShader中的函数了，要替换为：

RHICmdList.GetBoundPixelShader()

SetRenderTarget

这个方法已经废弃，要用RHIBeginRenderPass和RHIEndRenderPass来代替参考：LensDistortionRendering.cpp 旧代码：

SetRenderTarget(
	RHICmdList,
	OutputRenderTargetResource->GetRenderTargetTexture(),
	FTextureRHIRef(),
	ESimpleRenderTargetMode::EUninitializedColorAndDepth,
	FExclusiveDepthStencil::DepthNop_StencilNop
);
  //……
  DrawIndexedPrimitiveUP…
  RHICmdList.CopyToResolveTarget(.....

新代码：

FRHITexture2D* RenderTargetTexture = OutputRenderTargetResource->GetRenderTargetTexture();
RHICmdList.Transition(FRHITransitionInfo(RenderTargetTexture, ERHIAccess::SRVMask, ERHIAccess::RTV));
FRHIRenderPassInfo RPInfo(RenderTargetTexture, ERenderTargetActions::DontLoad_Store);
RHICmdList.BeginRenderPass(RPInfo, TEXT("DrawUVDisplacement"));
{

	FGlobalShaderMap* GlobalShaderMap = GetGlobalShaderMap(FeatureLevel);
	TShaderMapRef<FShaderTestVS> VertexShader(GlobalShaderMap);
	TShaderMapRef<FShaderTestPS> PixelShader(GlobalShaderMap);

	// Set the graphic pipeline state.  
	FGraphicsPipelineStateInitializer GraphicsPSOInit;
	RHICmdList.ApplyCachedRenderTargets(GraphicsPSOInit);
	GraphicsPSOInit.DepthStencilState = TStaticDepthStencilState<false, CF_Always>::GetRHI();
	GraphicsPSOInit.BlendState = TStaticBlendState<>::GetRHI();
	GraphicsPSOInit.RasterizerState = TStaticRasterizerState<>::GetRHI();
	GraphicsPSOInit.PrimitiveType = PT_TriangleList;
	GraphicsPSOInit.BoundShaderState.VertexDeclarationRHI = GetVertexDeclarationFVector4();
	GraphicsPSOInit.BoundShaderState.VertexShaderRHI = VertexShader.GetVertexShader();
	GraphicsPSOInit.BoundShaderState.PixelShaderRHI = PixelShader.GetPixelShader();
	SetGraphicsPipelineState(RHICmdList, GraphicsPSOInit);

	// Update viewport.
	RHICmdList.SetViewport(
		0, 0, 0.f,
		OutputRenderTargetResource->GetSizeX(), OutputRenderTargetResource->GetSizeY(), 1.f);
	PixelShader->SetParameters(RHICmdList, MyColor);


	RHICmdList.SetStreamSource(0, GScreenSpaceVertexBuffer.VertexBufferRHI, 0);
	RHICmdList.DrawIndexedPrimitive(GTwoTrianglesIndexBuffer.IndexBufferRHI, 0, 0, 4, 0, 2, 1);
}

RHICmdList.EndRenderPass();
RHICmdList.Transition(FRHITransitionInfo(RenderTargetTexture, ERHIAccess::RTV, ERHIAccess::SRVMask));

DrawIndexedPrimitive函数修改

旧代码

DrawIndexedPrimitiveUP(  
    RHICmdList,  
    PT_TriangleList,  
    0,  
    ARRAY_COUNT(Vertices),  
    2,  
    Indices,  
    sizeof(Indices[0]),  
    Vertices,  
    sizeof(Vertices[0])  
);

新代码

RHICmdList.DrawIndexedPrimitive(GTwoTrianglesIndexBuffer.IndexBufferRHI, 0, 0, 4, 0, 2, 1);

现在需要在RHICmdList对象上调用

Shader参数声明方式变化

使用Layout Field替代旧的方式

旧代码 class FMyShaderTest : public FGlobalShader的private部分：

FShaderParameter SimpleColorVal;

新代码

FMyShaderTest类的开头：

DECLARE_INLINE_TYPE_LAYOUT(FMyShaderTest, NonVirtual);

private部分：

LAYOUT_FIELD(FShaderParameter, SimpleColorVal);

2022/03/06

已经正常运行，可以加载出图片

修改的部分：

之前没有正确的使用IndexBuffer，现已修改正确
之前没有成功使用DrawIndexedPrimitive，现在已经修改正确

2022/03/07

加入了Uniform Buffer的传输

整体参考

参考MediaShader.cpp，相对较为“干净”的展示了Uniform Buffer的传输和使用

测试方法

在之前的蓝图基础上，DrawTestShaderRenderTarget节点上增加了一个Struct的输入，只需要MakeMyShaderStructData，就可以创建一个结构体让不同的按键给这个Struct的ColorIndex设置为0-3的不同数值，并再次调用DrawTestShaderRenderTarget即可

2022/03/09

加入了三个图片相关函数的范例

2022/03/29

加入了Compute Shader范例，并更新到4.26最新的API

inlet511 / globalshaderexample_ue4.26 Goto Github PK