UUSL Tessellation

If you have used the SET_QUAD_DOMAIN define, the engine will use the quad patches:

#define DOMAIN_PATCH quads

#define DOMAIN_PATCH [domain("quad")]
#define DOMAIN_PATCH_VERTICES 4

Otherwise, the engine will use triangle patches:

#define DOMAIN_PATCH triangles

#define DOMAIN_PATCH [domain("tri")]
#define DOMAIN_PATCH_VERTICES 3

Partitioning scheme of the tessellator is defined by the SET_PARTITIONING function:

SET_PARTITIONING( value VALUE )

Arguments

• value VALUE - The partitioning attribute. The value can be one of the following:
  • PARTITIONING_FRAC_ODD - the tessellation factor is rounded to the next odd integer within the [min;max] range.

    Equivalents

    OpenGL

    fractional_odd_spacing

    Direct3D

    [partitioning("fractional_odd")]

  • PARTITIONING_FRAC_EVEN - the tessellation factor is rounded to the next even integer within the [min;max] range.

    Equivalents

    OpenGL

    fractional_even_spacing

    Direct3D

    [partitioning("fractional_even")]

  • PARTITIONING_POW2 - the tessellation is rounded to the next greatest power of 2, yielding the effective range [1, 2, 4, 8, 16, 32, 64].

    Equivalents

    Direct3D

    [partitioning("pow2")]

  • PARTITIONING_INTEGER - the tessellation factor is always rounded up to the nearest integral value, in the range within the [min;max] range.

    Equivalents

    Direct3D

    [partitioning("Integer")]

SET_TOPOLOGY_PRIMITIVE( value VALUE )

Arguments

• value VALUE - The output primitive type attribute. The value can be one of the following:
  • TRIANGLE_CW means clockwise-wound triangles (vertices rotate clockwise around the triangle's center).

    Equivalents

    OpenGL

    cw

    Direct3D

    [outputtopology("triangle_cw")]

  • TRIANGLE_CCW triangle_cw means counter-clockwise-wound triangles (vertices rotate counter-clockwise around the triangle's center).

    Equivalents

    OpenGL

    ccw

    Direct3D

    [outputtopology("triangle_ccw")]

Initialization semantics for hull (control) shader:

Here is a usage example of hull shader input and output structure:

STRUCT(CONTROL_IN)
	INIT_POSITION
	INIT_CONTROL_IN(float4,0)
	INIT_CONTROL_IN(float3,1)
END

STRUCT(CONTROL_OUT)
	INIT_POSITION
	INIT_CONTROL_OUT(float4,0)
END

// end of structures

Use the following pre-defined variables to use the input\output control shader semantics:

If you have used the SET_QUAD_DOMAIN define, you should specify the index for this output semantic:

Initialization semantics:

Here is a usage example of evaluation shader input and output structure:

STRUCT(EVALUATE_IN)
	INIT_POSITION
	INIT_EVALUATE_IN(float4,0)
END

STRUCT(EVALUATE_OUT)
	INIT_POSITION
	INIT_EVALUATE_OUT(float2,0)
	INIT_EVALUATE_OUT(float3,1)
	INIT_EVALUATE_OUT(float3,2)
	INIT_EVALUATE_OUT(float3,3)
	INIT_EVALUATE_OUT(float,4)
	
	INIT_CUSTOM_DEPTH_VERTEX_OUT
	
END

// end of structures

Use the following pre-defined variables to use the input\output control shader semantics:

Hull shader requires the main shader function and patch constant function.

Patch Constant Function#

MAIN_PATCH_CONSTANT_BEGIN(CONTROL_IN)

	<your code here>

END_PATCH_CONSTANT

//end

//if SET_QUAD_DOMAIN defined
void patch_constant(out float edges[4], out float[2] inside) {

	<your code here>

}
//else
void patch_constant(out float edges[3], out float inside) {

	<your code here>

}

CONTROL_CONSTANT_OUT patch_constant(InputPatch<CONTROL_IN,DOMAIN_PATCH_VERTICES> input) {
CONTROL_CONSTANT_OUT output = (CONTROL_CONSTANT_OUT)0;

	<your code here>

return output; }
//

Hull Shader Function#

MAIN_CONTROL_BEGIN(CONTROL_OUT, CONTROL_IN)

	<your code here>

END_CONTROL

//end

#ifdef SET_QUAD_DOMAIN
layout(vertices = 4) out;
void main() {
	if(gl_InvocationID == 0) {
		float edges_factor[4];
		float inside_factor[2];
		patch_constant(edges_factor,inside_factor);
		gl_TessLevelOuter[0] = edges_factor[0];
		gl_TessLevelOuter[1] = edges_factor[1];
		gl_TessLevelOuter[2] = edges_factor[2];
		gl_TessLevelOuter[3] = edges_factor[3];
		gl_TessLevelInner[0] = inside_factor[0];
		gl_TessLevelInner[1] = inside_factor[1];
	}

	<your code here>

}

#else

layout(vertices = 3) out;
	void main() {
		if(gl_InvocationID == 0) {
			float edges_factor[3];
			float inside_factor;
			patch_constant(edges_factor,inside_factor);
			gl_TessLevelOuter[0] = edges_factor[0];
			gl_TessLevelOuter[1] = edges_factor[1];
			gl_TessLevelOuter[2] = edges_factor[2];
			gl_TessLevelInner[0] = inside_factor;
		}

	<your code here>

}
		
#endif

DOMAIN_PATCH
[maxtessfactor(64.0f)]
[outputcontrolpoints(DOMAIN_PATCH_VERTICES)]
[patchconstantfunc("patch_constant")]
CONTROL_PARTITIONING_TYPE
CONTROL_TOPOLOGY_PRIMITIVE_TYPE
CONTROL_OUT main(InputPatch<CONTROL_IN,DOMAIN_PATCH_VERTICES> input,uint CONTROL_POINT_ID : SV_OUTPUTCONTROLPOINTID) { 
	CONTROL_OUT output;

	<your code here>

return output; }

To start and end the main function of the evaluation shader, use the following instructions:

MAIN_EVALUATE_BEGIN(EVALUATE_OUT, EVALUTATE_IN)

	<your code here>

END_EVALUATE

//end

This code is equivalent to:

layout(DOMAIN_PATCH,CONTROL_PARTITIONING_TYPE,CONTROL_TOPOLOGY_PRIMITIVE_TYPE) in;
void main() { 

	<your code here>

}

DOMAIN_PATCH
EVALUATE_OUT main(EVALUATE_CONSTANT_IN patch_constant,const OutputPatch<EVALUATE_IN,DOMAIN_PATCH_VERTICES> input) {
	EVALUATE_OUT output;

	<your code here>

return output; }
//