Структура 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. Экземпляр Specular GBufferSpecular для преобразования.

Возвращаемое значение

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 с помощью ее конструкторов. Для металлического рабочего процесса используйте конструктор GBufferDefault() (для зеркального рабочего процесса вы должны использовать структуру GBufferSpecular и конструктор GBufferSpecularDefault () соответственно).

The following example shows the way of creating GBuffer structure for both workflows by using #ifdef #else #endif preprocessor statements. В следующем примере показан способ создания структуры GBuffer для обоих рабочих процессов с использованием инструкций препроцессора #ifdef #else #endif.

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. Определение GBUFFER с помощью директивы #define удобно для получения доступа к структуре 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);
/* ... */