此函数在mipmap流系统已知的全部材质上设置mipmap流调试属性。
您可以使用此函数在场景中所有渲染器的材质上设置调试着色器属性。要为mipmap流系统设置渲染器和摄像机，请参阅纹理流。
对于每个流纹理，材质使用此函数设置两个属性，分别称为(Texture property name)_MipInfo和(Texture property name)_StreamInfo。它们分别包含以下值
请注意，即使对于非流纹理，也会设置流状态代码值。mipmap流系统设置的代码为
在您自己的调试着色器中使用这些属性来可视化任何纹理的当前流状态。
例如，当您在具有渲染器的场景中使用此函数时，该渲染器具有名为“MainTex”的纹理属性的材质，它会在材质上设置两个名为MainTex_MipInfo和MainTex_StreamInfo的float4属性。前者属性在其x、y、z和w字段中分别包含流式Mip级别、纹理原始Mipmap数量、所需的流式Mip级别和已加载的Mip级别，而后者属性在其x、y、z和w字段中分别包含纹理的流优先级、其最新GPU上传的时间戳、流状态代码和0。
对于光照贴图，此函数设置unity_Lightmap_MipInfo和unity_Lightmap_StreamInfo属性。
您可以使用Camera.SetReplacementShader设置自定义Unity着色器，摄像机使用您已设置的材质渲染调试信息。以下示例着色器使用这些设置属性
Shader "Show Mipmap Streaming" { Properties { _MainTex("", 2D) = "white" {} _Control("Control (RGBA)", 2D) = "red" {} _Splat3("Layer 3 (A)", 2D) = "white" {} _Splat2("Layer 2 (B)", 2D) = "white" {} _Splat1("Layer 1 (G)", 2D) = "white" {} _Splat0("Layer 0 (R)", 2D) = "white" {} _BaseMap("", 2D) = "white" {} _Cutoff("Cutoff", float) = 0.5 }
CGINCLUDE // Common code used by most of the things below #include "UnityCG.cginc" struct v2f { float4 pos : SV_POSITION; float2 uv : TEXCOORD0; }; uniform float4 _MainTex_ST; uniform float4 _MainTex_TexelSize; uniform float4 _MainTex_MipInfo;
UNITY_DECLARE_TEX2D(_MainTex); UNITY_DECLARE_TEX2D(_SceneViewMipcolorsTexture);
uint GetMipCount(Texture2D tex) { #if defined(SHADER_API_D3D11) || defined(SHADER_API_D3D12) || defined(SHADER_API_D3D11_9X) || defined(SHADER_API_XBOXONE) || defined(SHADER_API_PSSL) #define MIP_COUNT_SUPPORTED 1 #endif #if (defined(SHADER_API_OPENGL) || defined(SHADER_API_VULKAN)) && !defined(SHADER_STAGE_COMPUTE) // OpenGL only supports TextureSize for width, height, depth // TextureQueryLevels (GL_ARB_Texture_query_levels) needs OpenGL 4.3 or above and doesn't compile in compute shaders // tex.GetDimensions converted to TextureQueryLevels #define MIP_COUNT_SUPPORTED 1 #endif // Metal doesn't support high enough OpenGL version
#if defined(MIP_COUNT_SUPPORTED) uint mipLevel, width, height, mipCount; mipLevel = width = height = mipCount = 0; tex.GetDimensions(mipLevel, width, height, mipCount); return mipCount; #else return 0; #endif }
float4 GetStreamingMipColor(uint mipCount, float4 mipInfo) { // alpha is amount to blend with source color (0.0 = use original, 1.0 = use new color)
// mipInfo : // x = quality setings minStreamingMipLevel // y = original mip count for Texture // z = desired on screen mip level // w = loaded mip level uint originalTextureMipCount = uint(mipInfo.y);
// If material/shader mip info (original mip level) has not been set it’s either not a streamed Texture // or no renderer is updating it if (originalTextureMipCount == 0) return float4(0.0, 0.0, 1.0, 0.5);
uint desiredMipLevel = uint(mipInfo.z); uint mipCountDesired = uint(originalTextureMipCount) - uint(desiredMipLevel); if (mipCount == 0) { // Can't calculate, use the passed value mipCount = originalTextureMipCount - uint(mipInfo.w); }
if (mipCount < mipCountDesired) { // red tones when not at the desired mip level (reduction due to budget). Brighter is further from original, alpha 0 when at desired float ratioToDesired = float(mipCount) / float(mipCountDesired); return float4(1.0, 0.0, 0.0, 1.0 - ratioToDesired); } else if (mipCount >= originalTextureMipCount) { // original color when at (or beyond) original mip count return float4(1.0, 1.0, 1.0, 0.0); } else { // green tones when not at the original mip level. Brighter is closer to original, alpha 0 when at original float ratioToOriginal = float(mipCount) / float(originalTextureMipCount); return float4(0.0, 1.0, 0.0, 1.0 - ratioToOriginal); } }
float3 GetDebugStreamingMipColorBlended(float3 originalColor, Texture2D tex, float4 mipInfo) { uint mipCount = GetMipCount(tex); float4 mipColor = GetStreamingMipColor(mipCount, mipInfo); return lerp(originalColor, mipColor.rgb, mipColor.a); }
v2f vert(appdata_base v) { v2f o; o.pos = UnityObjectToClipPos(v.vertex); o.uv = TRANSFORM_TEX(v.texcoord, _MainTex);
return o; }
fixed4 frag(v2f i) : COLOR { fixed4 col = UNITY_SAMPLE_TEX2D(_MainTex, i.uv); half4 res; res.rgb = GetDebugStreamingMipColorBlended(col.rgb, _MainTex, _MainTex_MipInfo); res.a = col.a; return res; }
struct v2fGrass { float4 pos : SV_POSITION; fixed4 color : COLOR; float2 uv : TEXCOORD0; };
fixed4 fragGrass(v2fGrass i) : COLOR { fixed4 col = UNITY_SAMPLE_TEX2D(_MainTex, i.uv); half4 res; res.rgb = GetDebugStreamingMipColorBlended(col.rgb, _MainTex, _MainTex_MipInfo); res.a = col.a * i.color.a; return res; }
ENDCG
SubShader { Tags { "ForceSupported" = "True" "RenderType" = "Opaque" } Pass { CGPROGRAM
// As both normal opaque shaders and terrain splat shaders // have "Opaque" render type, we need to do some voodoo // to make both work.
#pragma vertex vertWTerrain #pragma fragment fragWTerrain #pragma target 2.0 #pragma exclude_renderers gles
struct v2fterr { float4 pos : SV_POSITION; float2 uvnormal : TEXCOORD0; float4 uv[3] : TEXCOORD2; float nonterrain : TEXCOORD5; };
uniform float4 _Splat0_ST, _Splat1_ST, _Splat2_ST, _Splat3_ST, _Splat4_ST; uniform float4 _Splat0_TexelSize, _Splat1_TexelSize, _Splat2_TexelSize, _Splat3_TexelSize, _Splat4_TexelSize; uniform float4 _BaseMap_TexelSize;
v2fterr vertWTerrain(appdata_base v) { v2fterr o; o.pos = UnityObjectToClipPos(v.vertex); // assume it's not a terrain if _Splat0_TexelSize is not set up. float nonterrain = _Splat0_TexelSize.z == 0.0 ? 1 : 0; // collapse/don't draw terrain's add pass in this mode, since it looks really bad if first pass // and add pass blink depending on which gets drawn first with this replacement shader // TODO: make it display mips properly even for two-pass terrains. o.pos *= _MainTex_TexelSize.z == 0.0 && _Splat0_TexelSize.z != 0.0 ? 0 : 1; // normal Texture UV o.uvnormal = TRANSFORM_TEX(v.texcoord, _MainTex); // terrain splat UVs float2 baseUV = v.texcoord.xy; o.uv[0].xy = baseUV; o.uv[0].zw = half2(0, 0); o.uv[1].xy = TRANSFORM_TEX(baseUV, _Splat0); o.uv[1].zw = TRANSFORM_TEX(baseUV, _Splat1); o.uv[2].xy = TRANSFORM_TEX(baseUV, _Splat2); o.uv[2].zw = TRANSFORM_TEX(baseUV, _Splat3);
o.nonterrain = nonterrain; return o; }
UNITY_DECLARE_TEX2D(_Control); UNITY_DECLARE_TEX2D(_Splat0); UNITY_DECLARE_TEX2D(_Splat1); UNITY_DECLARE_TEX2D(_Splat2); UNITY_DECLARE_TEX2D(_Splat3); UNITY_DECLARE_TEX2D(_BaseMap); fixed4 fragWTerrain(v2fterr i) : COLOR { // sample regular Texture fixed4 colnormal = UNITY_SAMPLE_TEX2D(_MainTex, i.uvnormal);
// sample splatmaps half4 splat_control = UNITY_SAMPLE_TEX2D(_Control, i.uv[0].xy); half3 splat_color = splat_control.r * UNITY_SAMPLE_TEX2D(_Splat0, i.uv[1].xy).rgb; splat_color += splat_control.g * UNITY_SAMPLE_TEX2D(_Splat1, i.uv[1].zw).rgb; splat_color += splat_control.b * UNITY_SAMPLE_TEX2D(_Splat2, i.uv[2].xy).rgb; splat_color += splat_control.a * UNITY_SAMPLE_TEX2D(_Splat3, i.uv[2].zw).rgb;
// lerp between normal and splatmaps half3 col = lerp(splat_color, colnormal.rgb, (half)i.nonterrain);
half4 res; // TODO: Take splat mips into account res.rgb = GetDebugStreamingMipColorBlended(col.rgb, _MainTex, _MainTex_MipInfo); res.a = colnormal.a;
return res; }
ENDCG } }
SubShader { Tags { "ForceSupported" = "True" "RenderType" = "Transparent" } Pass { Cull Off CGPROGRAM #pragma vertex vert #pragma fragment frag #pragma target 2.0 #pragma exclude_renderers gles ENDCG } }
SubShader { Tags { "ForceSupported" = "True" "RenderType" = "TransparentCutout" } Pass { AlphaTest Greater[_Cutoff] CGPROGRAM #pragma vertex vert #pragma fragment frag #pragma target 2.0 #pragma exclude_renderers gles ENDCG } }
SubShader { Tags { "ForceSupported" = "True" "RenderType" = "TreeBark" } Pass { CGPROGRAM #pragma vertex vertTreeBark #pragma fragment frag #pragma target 2.0 #pragma exclude_renderers gles #include "UnityCG.cginc" #include "UnityBuiltin3xTreeLibrary.cginc" v2f vertTreeBark(appdata_full v) { v2f o; TreeVertBark(v); o.pos = UnityObjectToClipPos(v.vertex); o.uv = v.texcoord; return o; }
ENDCG } }
SubShader { Tags { "ForceSupported" = "True" "RenderType" = "TreeLeaf" } Pass { CGPROGRAM #pragma vertex vertTreeLeaf #pragma fragment frag #pragma target 2.0 #pragma exclude_renderers gles #include "UnityCG.cginc" #include "UnityBuiltin3xTreeLibrary.cginc" v2f vertTreeLeaf(appdata_full v) { v2f o; TreeVertLeaf(v); o.pos = UnityObjectToClipPos(v.vertex); o.uv = v.texcoord; return o; }
ENDCG AlphaTest GEqual[_Cutoff] } }
SubShader { Tags { "ForceSupported" = "True" "RenderType" = "TreeOpaque" } Pass { CGPROGRAM #pragma vertex vertTree #pragma fragment frag #pragma target 2.0 #pragma exclude_renderers gles #include "TerrainEngine.cginc" struct appdata { float4 vertex : POSITION; fixed4 color : COLOR; float2 texcoord : TEXCOORD0; }; v2f vertTree(appdata v) { v2f o; TerrainAnimateTree(v.vertex, v.color.w); o.pos = UnityObjectToClipPos(v.vertex); o.uv = v.texcoord; return o; }
ENDCG } }
SubShader { Tags { "ForceSupported" = "True" "RenderType" = "TreeTransparentCutout" } Pass { Cull Off CGPROGRAM #pragma vertex vertTree #pragma fragment frag #pragma target 2.0 #pragma exclude_renderers gles #include "TerrainEngine.cginc" struct appdata { float4 vertex : POSITION; fixed4 color : COLOR; float4 texcoord : TEXCOORD0; }; v2f vertTree(appdata v) { v2f o; TerrainAnimateTree(v.vertex, v.color.w); o.pos = UnityObjectToClipPos(v.vertex); o.uv = v.texcoord; return o; }
ENDCG AlphaTest GEqual[_Cutoff] } }
SubShader { Tags { "ForceSupported" = "True" "RenderType" = "TreeBillboard" } Pass { Cull Off ZWrite Off CGPROGRAM #pragma vertex vertTree #pragma fragment frag #pragma target 2.0 #pragma exclude_renderers gles #include "TerrainEngine.cginc" v2f vertTree(appdata_tree_billboard v) { v2f o; TerrainBillboardTree(v.vertex, v.texcoord1.xy, v.texcoord.y); o.pos = UnityObjectToClipPos(v.vertex); o.uv.x = v.texcoord.x; o.uv.y = v.texcoord.y > 0; return o; }
ENDCG
SetTexture[_MainTex] { combine primary, Texture } } }
SubShader { Tags { "ForceSupported" = "True" "RenderType" = "GrassBillboard" } Pass { Cull Off CGPROGRAM #pragma vertex vertGrass #pragma fragment fragGrass #pragma target 2.0 #pragma exclude_renderers gles #include "TerrainEngine.cginc" v2fGrass vertGrass(appdata_full v) { v2fGrass o; WavingGrassBillboardVert(v); o.color = v.color; o.pos = UnityObjectToClipPos(v.vertex); o.uv = v.texcoord; return o; }
ENDCG AlphaTest Greater[_Cutoff] } }
SubShader { Tags { "ForceSupported" = "True" "RenderType" = "Grass" } Pass { Cull Off CGPROGRAM #pragma vertex vertGrass #pragma fragment fragGrass #pragma target 2.0 #pragma exclude_renderers gles #include "TerrainEngine.cginc" v2fGrass vertGrass(appdata_full v) { v2fGrass o; WavingGrassVert(v); o.color = v.color; o.pos = UnityObjectToClipPos(v.vertex); o.uv = v.texcoord; return o; }
ENDCG AlphaTest Greater[_Cutoff] } }
Fallback Off }
| materialTextureSlot | 设置mipmap流调试属性时要引用的材质纹理插槽。 |
此函数在mipmap流系统已知的全部材质上设置mipmap流调试属性，使用特定于给定材质纹理插槽的数据。
您可以使用此重载轻松调试场景中所有渲染器上任何给定的材质纹理插槽。
此函数不是为每个材质纹理属性设置两个属性，而是设置以下属性
unity_MipmapStreaming_DebugTex的2D纹理属性。unity_MipmapStreaming_DebugTex_MipInfo的向量属性。unity_MipmapStreaming_DebugTex_StreamInfo的向量属性。为这些属性设置的值对应于mipmap流系统已知的指示材质纹理插槽中纹理的数据，即使该纹理未流式传输。
mipmap流系统使用纹理属性在着色器的Properties块中出现的顺序来确定给定插槽编号对应的内容。
此外：如果materialTextureSlot为-1，则mipmap流系统（在有意义的情况下）会聚合系统已知的材质上所有纹理的数据，并使用该聚合数据设置前面提到的属性。
unity_MipmapStreaming_DebugTex使用分配给材质纹理插槽0的纹理设置。unity_MipmapStreaming_DebugTex_MipInfo设置为(0, 0, 0, 0)，这些值对于各个纹理来说过于具体，无法聚合。unity_MipmapStreaming_DebugTex_StreamInfo设置为(0, 材质上最新纹理上传的时间戳, 打包的流状态代码+流状态标志, 0)。请注意，流状态代码保留0-15的值。当聚合发生时，mipmap流系统设置的流状态标志为