UUSL GBuffer结构

GBuffer has the following set of textures: GBuffer具有以下纹理集：

纹理名称	类	描述
Albedo	RGBA8	RGB - albedo value. A - occlusion value. RGB -反照率值。 A -遮挡值。
Shading	RGBA8	R - metalness value. G - F0 (specular) value. B - translucent value. A - microfiber value. R -金属度值。 G -F0（镜面）值。 B -半透明值。 A -超细纤维值。
Normal	RGBA8	RGB - normal value. A - roughness value. RGB -正常值。 A -粗糙度值。
Velocity	RG16F	RG - pixel displacement value (XY coordinates). RG -像素位移值（XY坐标）。
Material Mask	R32U	R - material mask value. R -材质蒙版值。
Lightmap	RG11B10F	RGB - lightmap value. RGB -光照贴图值。
Features	RGBA8	R - bevel value. R -斜角值。

Channels of these textures fill corresponding fields of the GBuffer structure.这些纹理的通道填充GBuffer结构的相应字段。

struct GBuffer {
	float3	albedo;
	float	transparent;
	
	float	metalness;
	float	roughness;
	float	f0;
	float	microfiber;
	
	float3	normal;
	float	translucent;
	
	float2	velocity;
	
	float3	lightmap;
	float	occlusion;
	
	float	bevel;
	
	int		material_mask;
};

Specular G-buffer struct has different fields: Specular G-buffer struct具有不同的字段：

struct GBufferSpecular {
	float3	diffuse;
	float	transparent;
		
	float3	specular;
	float	gloss;
	float	microfiber;
		
	float3	normal;
	float	translucent;
		
	float2	velocity;
		
	float3	lightmap;
	float	occlusion;
		
	float	bevel;
		
	int		material_mask;
};

To convert Specular G-buffer to Metalness G-buffer, use specularToMetalness() function.要将Specular G-buffer转换为Metalness G-buffer，请使用specularToMetalness()函数。

GBuffer GBufferDefault ( ) #

Default constructor for GBuffer structure for metalness workflow. It creates an instance with default (not null) values.

返回值

GBuffer structure with default (not null) values.

GBufferSpecular GBufferSpecularDefault ( ) #

Constructor for GBuffferSpecular structure for specular workflow. It creates an instance with default (not null) values.

返回值

GBufferSpecular structure with default (not null) values.

void shadingGBuffer ( inout GBuffer gbuffer, float3 view ) #

Adds a view-dependent shading to the gbuffer.

参数

• inout GBuffer gbuffer - GBuffer instance. GBuffer实例。
• float3 view - View vector.查看向量。

void shadingGBuffer ( inout GBuffer gbuffer ) #

Adds a shading which is dependent on material parameters.

参数

• inout GBuffer gbuffer - GBuffer instance. GBuffer实例。

GBuffer specularToMetalness ( GBufferSpecular gbuffer ) #

Converts given specular GBufferSpecular to metalness Gbuffer.

参数

• GBufferSpecular gbuffer - Specular GBufferSpecular instance to be converted.高光GBuffer要转换的高光实例。

返回值

Metalness Gbuffer instance.

void setGBuffer ( GBuffer gbuffer ) #

Sets GBuffer values by using corresponding values of given GBuffer instance.

参数

• GBuffer gbuffer - GBuffer instance with necessary values to be set. GBuffer实例，需要设置必要的值。

void setGBuffer ( GBufferSpecular gbuffer ) #

Sets GBuffer values by using corresponding values of given GBufferSpecular instance.
Inside this method specularToMetalness() is called.

参数

• GBufferSpecular gbuffer - GBufferSpecular instance with necessary values to be set. GBufferSpecular实例，需要设置必要的值。

void loadGBufferAlbedo ( inout GBuffer gbuffer, TEXTURE_IN TEX_ALBEDO, float2 uv ) #

Loads albedo texture values (albedo color and occlusion) to GBuffer.

参数

• inout GBuffer gbuffer - Gbuffer structure. Values will be written in it. Gbuffer结构。值将写入其中。
• TEXTURE_IN TEX_ALBEDO - Albedo texture.反照率纹理。
• float2 uv - UV coordinates. UV坐标。

void loadGBufferShading ( inout GBuffer gbuffer, TEXTURE_IN TEX_SHADING, float2 uv ) #

Loads shading texture values (metalness, f0, translucence, microfiber) to GBuffer.

参数

• inout GBuffer gbuffer - Gbuffer structure. Values will be written in it. Gbuffer结构。值将写入其中。
• TEXTURE_IN TEX_SHADING - Shading texture.阴影纹理。
• float2 uv - UV coordinates. UV坐标。

void loadGBufferNormal ( inout GBuffer gbuffer, TEXTURE_IN TEX_NORMAL, float2 uv ) #

Loads normal texture values (normal and roughness) to GBuffer.

参数

• inout GBuffer gbuffer - Gbuffer structure. Values will be written in it. Gbuffer结构。值将写入其中。
• TEXTURE_IN TEX_NORMAL - Normal texture.普通纹理。
• float2 uv - UV coordinates. UV坐标。

void loadGBufferLightMap ( inout GBuffer gbuffer, TEXTURE_IN TEX_LIGHTMAP, float2 uv ) #

Loads lightmap texture values to passed GBuffer instance.

参数

• inout GBuffer gbuffer - Gbuffer structure. Values will be written in it. Gbuffer结构。值将写入其中。
• TEXTURE_IN TEX_LIGHTMAP - Lightmap texture.光照贴图纹理。
• float2 uv - UV coordinates. UV坐标。

void loadGBufferVelocity ( inout GBuffer gbuffer, TEXTURE_IN TEX_VELOCITY, float2 uv ) #

Loads velocity texture values to passed GBuffer instance.

参数

• inout GBuffer gbuffer - Gbuffer structure. Values will be written in it. Gbuffer结构。值将写入其中。
• TEXTURE_IN TEX_VELOCITY - Velocity texture.速度纹理。
• float2 uv - UV coordinates. UV坐标。

void loadGBufferMaterialMask ( inout GBuffer gbuffer, TEXTURE_IN_UINT TEX_MATERIAL_MASK, float2 uv ) #

Loads material mask texture values to passed GBuffer instance.

参数

• inout GBuffer gbuffer - Gbuffer structure. Values will be written in it. Gbuffer结构。值将写入其中。
• TEXTURE_IN_UINT TEX_MATERIAL_MASK - Material mask texture.材质蒙版纹理。
• float2 uv - UV coordinates. UV坐标。

Defining the GBuffer Structure定义GBuffer结构#

To use GBuffer structure in your shader's code, you should define and initialize the GBuffer structure by using its constructors. For metalness worlkflow use GBufferDefault() constructor (for specular workflow you should use GBufferSpecular structure and GBufferSpecularDefault() constructor respectively).要在着色器的代码中使用GBuffer结构，应使用其构造函数定义和初始化GBuffer结构。对于金属化的worlkflow，请使用GBufferDefault()构造函数（对于镜面工作流，应分别使用 GBufferSpecular 结构和 GBufferSpecularDefault（）构造函数）。

The following example shows the way of creating GBuffer structure for both workflows by using #ifdef #else #endif preprocessor statements.下面的示例演示了使用#ifdef #else #endif预处理程序语句为两个工作流创建GBuffer结构的方法。

UUSL

/* ... */
	#ifdef METALNESS
		GBuffer gbuffer = GBufferDefault();
		#define GBUFFER gbuffer
	#else
		GBufferSpecular gbuffer_s = GBufferSpecularDefault();
		#define GBUFFER gbuffer_s
	#endif
/* ... */

注意

Defining the GBUFFER with #define directive is handy to get access to GBuffer structure, no matter what type of the workflow is used.无论使用哪种类型的工作流程，使用#define指令定义GBUFFER都可以轻松访问GBuffer结构。

Filling the GBuffer Structure填充GBuffer结构#

/* ... */
	#ifdef METALNESS
		GBUFFER.albedo		= color.rgb;
		GBUFFER.metalness	= shading.r;
		GBUFFER.roughness	= shading.g;
		
	#else
		GBUFFER.diffuse		= color.rgb;
		GBUFFER.specular	= shading.rgb;
		GBUFFER.gloss		= shading.a;
		GBUFFER.microfiber	= m_microfiber;
		
	#endif
/* ... */

Loading Textures to GBuffer Structure将纹理加载到GBuffer结构#

// initialize textures
/* ... */
INIT_TEXTURE(1,TEX_NORMAL)
INIT_TEXTURE(2,TEX_ALBEDO)
INIT_TEXTURE(3,TEX_SHADING)
/* ... */

/* ... */
GBuffer gbuffer = GBufferDefault();
loadGBufferAlbedo(gbuffer, TEXTURE_OUT(TEX_ALBEDO),uv);
loadGBufferShading(gbuffer, TEXTURE_OUT(TEX_SHADING),uv);
loadGBufferNormal(gbuffer, TEXTURE_OUT(TEX_NORMAL),uv);
/* ... */