Command…Unity

SetRenderTarget(4)CommandBuffer.Blit(5)填充Shader变量数据(6)绘制(7)转换纹理格式

CommandBuffer

(2021.3版本)常用函数方法context.Cullcontext.DrawGizmoscontext.DrawRenderersvoid

DrawShadows

Rendering.ShadowDrawingSettings

settings);void

camera);context.DrawWireOverlay(camera);context.ExecuteCommandBuffer(cmd);context.SetupCameraProperties(camera);context.Submit();if

(!context.SubmitForRenderPassValidation()){...}其他

CommandBuffer

命令缓冲区保存渲染命令列表(“设置渲染目标绘制网格…”)。

它们可以设置为在相机渲染(参见camera

addcommandbuffer)或立即执行(参见Graphics.ExecuteCommandBuffer)期间的不同处执行。

通常情况下它们会以自定义方式扩展Unity的渲染管道。

例如您可以在完成所有常规对象之后将一些附加对象渲染到延迟渲染G-buffer中或者对光影贴图进行自定义处理。

有关详细信息请参阅

command

如果需要可以创建命令缓冲区然后多次执行。

也就是说一般使用完毕后需要手动清除缓存如果命令是Loop的则可以循环执行

CommandBuffer

[NativeType(Runtime/Graphics/CommandBuffer/RenderingCommandBuffer.h)]

[NativeHeader(Runtime/Shaders/ComputeShader.h)]

[UsedByNativeCode]

[NativeHeader(Runtime/Shaders/RayTracingShader.h)]

[NativeHeader(Runtime/Export/Graphics/RenderingCommandBuffer.bindings.h)]

public

SetBufferCounterValue(GraphicsBuffer

buffer,

CommandBuffer.GetTemporaryRT获取临时渲染纹理

static

Shader.PropertyToID(_FrameBuffer);

public

//纹理过滤模式(默认为Point)。

还有Bilinear、TrilinearRenderTextureFormat

format,

//RenderTexture的格式。

(常用有ARGB32(Default)、Depth、Shadowmap、...)RenderTextureReadWrite

readWrite,

enableRandomWrite);//是否应该启用对纹理的随机写入访问(默认为false)。

使用ReleaseTemporaryRT释放临时渲染纹理传递相同的nameID。

任何没有明确释放的临时纹理将在相机完成渲染时或在Graphics.ExecuteCommandBuffer结束后被删除。

获得临时渲染纹理后您可以将其设置为活动(SetRenderTarget)或

blit

it。

在命令缓冲区执行期间您不需要显式地保留活动渲染目标(当前渲染目标将在之后保存和恢复)。

如果使用Gamma色彩空间RenderTextureReadWrite

sRGB

如果使用Linear色彩空间默认输入为sRGBfragment输出为线性空间颜色。

当渲染到texture时fragment输出转化为sRGB空间。

当在Shader中采样纹理sRGB色彩空间会自动转为线性空间。

Linear然而如果你的渲染纹理包含非颜色数据(法线速度其他自定义值)那么你不希望Linear-sRGB转换发生。

当纹理类型为

“HDR”

formats、Depth、Shadowmap则无论readWrite设为什么都会使用线性空间。

我们可以通过RenderTexture.sRGB了解渲染纹理使用sRGB或是Linear。

如果为sRGB返回true如果为Linear返回false。

void

SetRenderTarget(Rendering.RenderTargetIdentifier

color,

//渲染目标设置为颜色缓冲。

Rendering.RenderBufferLoadAction

colorLoadAction,

//用于颜色的加载操作。

Rendering.RenderBufferStoreAction

colorStoreAction,

//用于颜色的存储操作。

Rendering.RenderTargetIdentifier

depth,

//将渲染目标设置为深度缓冲区。

Rendering.RenderBufferLoadAction

depthLoadAction,

//用于深度/模板缓冲区的加载操作。

Rendering.RenderBufferStoreAction

depthStoreAction);//用于深度/模板缓冲区的存储操作

public

SetRenderTarget(RenderTargetIdentifier[]

colors,

多重纹理渲染DBufferRendering.RenderTargetIdentifier

depth,

//要设置的3D或阵列渲染目标的层。

渲染纹理可以用几种方式表示:一个RenderTexture对象一个用GetTemporaryRT创建的临时渲染纹理或者一个内置的临时纹理(BuiltinRenderTextureType)。

所有这些都由RenderTargetIdentifier结构体表示该结构体具有隐式转换操作符以节省输入。

Rendering.RenderBufferLoadAction

当GPU开始渲染到渲染目标时此设置指定应该在表面的现有内容上执行的操作。

如果加载动作是Clear或not

careTile-based

GPUs可能会获得性能优势。

用户应该避免使用RenderBufferLoadAction。

尽可能Load

请注意并非所有平台都有加载/存储操作因此此设置可能在运行时被忽略。

通常面向移动设备的图形api

(OpenGL

如果你使用RenderBufferLoadAction.DontCare渲染可能会失败或产生伪影因为深度纹理中未定义的像素会导致深度测试失败。

你可以使用LoadStoreActionDebugModeSettings

Load:当这个RenderBuffer被激活时保留它的现有内容。

这种设置在基于tile的gpu上很昂贵应该尽可能避免。

Clear激活渲染缓冲区后清除其内容。

目前只能与RenderPass

API一起工作。

DontCare当这个RenderBuffer被激活时GPU被指示不关心RenderBuffer的现有内容。

在基于tile的gpu上这意味着RenderBuffer内容不需要加载到tile内存中从而提供了性能提升。

Rendering.RenderBufferStoreAction

这个枚举描述了当GPU完成渲染到渲染目标时应该在渲染目标上做什么。

当GPU完成渲染到渲染目标时此设置指定应该对渲染结果执行的操作。

如果存储操作为“不关心”基于tile的gpu可能会获得性能优势。

例如如果渲染帧后不需要深度缓冲区内容则此设置可能很有用。

请注意并非所有平台都有加载/存储操作因此此设置可能在运行时被忽略。

通常面向移动设备的图形api

(OpenGL

如果你使用RenderBufferLoadAction.DontCare渲染可能会失败或产生伪影因为深度纹理中未定义的像素会导致深度测试失败。

你可以使用LoadStoreActionDebugModeSettings来突出显示未定义的像素。

StoreRenderBuffer内容需要存储到RAM中。

如果表面启用了MSAA则存储多采样版本未解析的表面。

Resolve解析MSAA曲面后再保存。

StoreAndResolve解析MSAA表面但也存储多采样版本。

DontCareRenderBuffer的内容是不需要的可以被丢弃。

基于tile的gpu将完全跳过写入表面内容从而提供性能提升。

void

Rendering.RenderTargetIdentifier

dest,

pass);添加一个命令使用着色器将纹理中的像素数据复制到渲染纹理中。

这个方法增加了一个命令将像素数据从GPU上的纹理复制到GPU上的渲染纹理。

这是复制纹理最快的方法之一。

当你使用Graphics.Blit,

设置为dest纹理。

将source作为_MainTex属性传递给mat材质。

使用材质的着色器绘制从源纹理到目标纹理的全屏表面。

如果你提供一个没有_MainTex属性的mat材质Blit不会使用source。

自定义着色器

Blit改变了RenderTexture.active。

在使用Blit之前存储active

render

避免将source和dest设置为相同的渲染纹理因为这可能导致未定义的行为。

使用带有双缓冲的自定义渲染纹理代替或者使用两个渲染纹理并在它们之间交替手动实现双缓冲。

在线性色彩空间中在使用Blit之前设置GL.sRGBWrite以确保srgb到线性色彩转换是您所期望的。

将dest设置为空。

Unity现在使用Camera.main.targetTexture作为目标纹理。

设置

Camera.main的Camera.targetTexture

要在通用渲染管道(URP)或高清晰度渲染管道(HDRP)中将数据blit到屏幕上必须在你从RenderPipelineManager.endContextRendering调用的方法中回调处调用Graphics.Blit或

如果你想使用源(渲染)纹理一部分的深度或模板缓冲区或者blit到纹理的子区域你必须手动编写一个等效的Graphics.Blit函数——即使用目标颜色缓冲区和源深度缓冲区设置Graphics.SetRenderTarget

设置orthographic

projection(GL.LoadOrtho)设置材质通道(material

dest的先前内容。

在这种情况下建议使用SetRenderTarget使用适当的加载和存储操作显式地激活dest渲染目标。

Blit

dest应该被设置为BuiltinRenderTextureType.CurrentActive。

(5)填充Shader变量数据

同理还有FLoatArray、Int、Matrix、MatrixArray、Texture、Vector、VectorArrayvoid

proj);

SetViewProjectionMatrices(Matrix4x4

view,

proj);渲染纹理绑定绑定渲染纹理后才能再Pass中使用该Texture。

当命令缓冲区将被执行时一个全局着色器纹理属性将在此时被设置。

public

Rendering.RenderTargetIdentifier

value);

Rendering.RenderTargetIdentifier

value);

Rendering.RenderTargetIdentifier

value,

Rendering.RenderTextureSubElement

element);

Rendering.RenderTargetIdentifier

value,

Rendering.RenderTextureSubElement

element);(6)绘制

所有的绘制命令都不会自动添加关于光照、阴影、全局光照等相关数据如果需要相关变量数据需要手动设置参数数据。

否则如果在Shader中使用相关变量结果是未定义的。

一般绘制

//使用的转化矩阵Matrix4x4.identityMaterial

material,

//程序几何的拓扑结构。

MeshTopology.Trianglesint

vertexCount,

//要渲染的实例数。

MaterialPropertyBlock

properties

DrawMeshInstancedProcedural(Mesh

mesh,

DrawProceduralIndirect(Matrix4x4

matrix,

normalizedCamViewport);程序化绘制Procedural没有任何顶点或索引缓冲区

当命令缓冲区执行时这将在GPU上执行绘制调用没有任何顶点或索引缓冲区。

这主要用于Shader

Model

4.5级硬件Shader可以从ComputeBuffer缓冲区读取任意数据。

在顶点着色器中你通常会使用SV_VertexID和SV_InstanceID输入变量从而从一些缓冲区中获取数据。

注意这个drawCall不会设置任何与照明相关的着色器数据(光的颜色方向阴影光和反射探针等)。

如果材质使用的着色器使用任何与照明相关的变量结果是未定义的。

(7)转换纹理格式

srcElement:纹理下标例如CubeMapTexture2DArray等

dstElement:目标纹理下标

ConvertTexture(RenderTargetIdentifier

src,

ConvertTexture(RenderTargetIdentifier

src,

CopyCounterValue(ComputeBuffer/GraphicsBuffer

src,

CopyTexture(Rendering.RenderTargetIdentifier

src,

Rendering.RenderTargetIdentifier

dst);(9)清除

清除缓冲区中的所有命令。

ClearRandomWriteTargets();清除level

pixel

shaders的随机写入目标。

ClearRenderTarget(bool

clearDepth,

ClearRenderTarget(Rendering.RTClearFlags

clearFlags,

IncrementUpdateCount(Rendering.RenderTargetIdentifier

dest);

该标志可“翻转”所有已渲染对象的剔除模式。

主要用例渲染镜子、水等的反射。

由于为用于渲染此反射的虚拟摄像机生成了镜像因此必须反转剔除顺序。

您可以看到

Effects

RequestAsyncReadbackIntoNativeArrayT

void

RequestAsyncReadbackIntoNativeSliceT

void

WaitAllAsyncReadbackRequests();

//同步处理,GPU在完成Blit,

Dispatch或纹理复制命令后通过GraphicsFence

CreateAsyncGraphicsFence(Rendering.SynchronisationStage

stage);

WaitOnAsyncGraphicsFence(Rendering.GraphicsFence

fence);

WaitOnAsyncGraphicsFence(Rendering.GraphicsFence

fence,

SetExecutionFlags(Rendering.CommandBufferExecutionFlags

flags);本地插件

IssuePluginCustomTextureUpdateV2

IssuePluginEvent

IssuePluginEventAndDataWithFlags

ComputeShader

SetComputeFloatParam、SetComputeIntParam、SetComputeVectorParam

、SetComputeVectorArrayParam、SetComputeMatrixParam…

void

添加了一个命令来选择在执行光线/几何相交时使用哪个着色器通道着色。

SetRayTracingShaderPass添加一个命令来执行RayTracingShader。

void

DispatchRays(Experimental.Rendering.RayTracingShader

rayTracingShader,

camera);SetRayTracingAccelerationStructure

SetRayTracingConstantBufferParam

void

SetFoveatedRenderingMode(Rendering.FoveatedRenderingMode

CommandBuffer.SetSinglePassStereo(SinglePassStereoMode)

延迟锁定

UnmarkLateLatchMatrix(Rendering.CameraLateLatchMatrixType

matrixPropertyType);

方法实现通常会针对每个摄像机剔除渲染管线不需要渲染的对象请参阅

CullingResults然后对

ScriptableRenderContext.DrawRenderers

发起一系列调用并混合

ScriptableRenderContext.ExecuteCommandBuffer

调用。

这些调用会设置全局着色器属性、更改渲染目标、分发计算着色器和其他渲染任务。

若要实际执行渲染循环请调用

ScriptableRenderContext.Submit。

常用函数方法

Rendering.ScriptableCullingParameters

ScriptableRenderContext剔除结果所用的内存会在渲染循环完成后得到释放。

context.DrawGizmos

gizmoSubset);...//BeforeRendering

...//不透明物体渲染

//从ScriptableRenderContext.Cull中获得ref

drawingSettings,

ReflectionProbes/LightProbeProxyVolume/

Lightmaps/LightData/MotionVectors/LightIndices/ReflectionProbeData/OcclusionProbe/OcclusionProbeProxyVolume/shadowMask*///

sortingSettings

stateBlock);//RenderStateBlock结构

//SetDetphState

m_RenderStateBlock.stencilReference

reference;

m_RenderStateBlock.stencilState

stencilState;

Execute(ScriptableRenderContext

context,

renderingData){....context.ExecuteCommandBuffer(cmd);cmd.Clear();//

Render

objects...context.DrawRenderers(renderingData.cullResults,

ref

Rendering.ShadowDrawingSettings

settings);

//Rendering.ShadowDrawingSettings

settings

ShadowDrawingSettings(cullResults,

shadowLightIndex);

m_CascadeSlices[cascadeIndex].splitData;Vector4

shadowBias

m_CascadeSlices[cascadeIndex].projectionMatrix,

m_CascadeSlices[cascadeIndex].resolution);ShadowUtils.SetupShadowCasterConstantBuffer(cmd,

ref

shadowBias);CoreUtils.SetKeyword(cmd,

ShaderKeywordStrings.CastingPunctualLightShadow,

false);ShadowUtils.RenderShadowSlice(cmd,

ref

m_CascadeSlices[cascadeIndex],ref

settings,m_CascadeSlices[cascadeIndex].projectionMatrix,

m_CascadeSlices[cascadeIndex].viewMatrix);

}//在RenderShadowSlice函数中使用了DrawShadows

public

RenderShadowSlice(CommandBuffer

cmd,

https://github.com/Unity-Technologies/Graphics/blob/9544b8ed2f98c62803d285096c91b44e9d8cbc47/com.unity.render-pipelines.high-definition/Runtime/Lighting/Shadow/HDShadowAtlas.cs#L197

)cmd.SetViewport(new

shadowSliceData.resolution));cmd.SetViewProjectionMatrices(view,

proj);context.ExecuteCommandBuffer(cmd);cmd.Clear();context.DrawShadows(ref

settings);cmd.DisableScissorRect();context.ExecuteCommandBuffer(cmd);cmd.Clear();cmd.SetGlobalDepthBias(0.0f,

0.0f);

DrawSkybox函数在DrawSkyboxPass使用作为单独的一个Pass。

context.DrawWireOverlay(camera);

注意DrawWireOverlay只在Unity编辑器中起作用

而且需要

并且SceneView.CamerMode.drawMode设置为

如果不满足这些条件调用DrawWireOverlay就没有效果。

context.ExecuteCommandBuffer(cmd);

ExecuteCommandBufferAsync(Rendering.CommandBuffer

commandBuffer,

queueType);是对异步计算队列调度命令缓冲区的执行。

另请参阅SystemInfo.supportsAsyncCompute、GPUFence。

context.SetupCameraProperties(camera);

context.Submit();

在调用ScriptableRenderContext.ExecuteCommandBuffer期间,

ScriptableRenderContext将commandBuffer参数注册到其要执行的命令的内部列表中。

这些命令(包括存储在自定义commandBuffer中的命令)的实际执行发生在ScriptableRenderContext.Submit期间。

如果您的绘制调用依赖于您在CommandBuffer中指定的管道状态请确保在其他ScriptableRenderContext方法(如DrawRenderers,

DrawShadows)之前调用ExecuteCommandBuffer。

即如果DrawRenderers需要CommandBuffer中的命令作为前置条件则必须先提交缓存命令再使用DrawRenderers函数。

否则即使在DrawRenderers函数之前将命令添加到了commandBuffer,但会因为提交顺序导致最终结果的不正确。

(!context.SubmitForRenderPassValidation()){…}

由BeginRenderPass调用启动的渲染传递是否可以执行预定的命令。

context.InvokeOnRenderObjectCallback();

在InvokeOnRenderObjectCallbackPass.cs中调用context.InvokeOnRenderObjectCallback();

作为MonoBehaviour

ScriptableRenderContext.EmitWorldGeometryForSceneView(camera);

几何形状发射到

(isSceneViewCamera){ScriptableRenderContext.EmitWorldGeometryForSceneView(camera);}

#endif