checkPatternSoft

Function call: fn_checkPatternSoft (uv, color1, color2, number, edgeSharpness);

Example with values: fn_checkPatternSoft (uv, 0.0.xxx, 1.0.xxx, 20.0.xx, 1000.0);
(Result see image)

Purpose:
Generating a selectable number of squares with changing color or brightness or other RGB source.
This can be a color, or a texture from a sampler. Adjustable edge softness of the squares.
More details see the parameter descriptions.

Required global definitions and declarations:

(add outside and above all shaders and functions):

//-----------------------------------------------------------------------------------------//
// Definitions and declarations
//-----------------------------------------------------------------------------------------//

float _OutputAspectRatio;
#define PI  3.141592654

Code (Example as a float3 RGB function without alpha):

float3 fn_checkPatternSoft  (float2 uv, float3 color1, float3 color2, float2 number, float edgeSharpness)
{ 
   number.y /= _OutputAspectRatio;
   float2 mix =  sin (uv * PI * number ) * edgeSharpness / number;
   mix =  clamp( mix, -0.5, 0.5) + 0.5; 
   mix.x = lerp( mix.y , 1.0 - mix.y, mix.x);
   return lerp (color1, color2, mix.x);
}

When making code changes, note that color1 and color2 must have the same float type.

Code description at the bottom of this page.

Parameter Description

uv:
Enter the name of the used texture coordinate variable.
Type: float2

color1:
Color of the first square at the top left. Type: float3 (RGB)
- This can be a color, or a texture from a sampler.

color2:
Color of the squares next to color1 squares. Type: float3 (RGB)
- This can be a color, or a texture from a sampler.

number:
Number of squares in a horizontal line.
Type: float2
To create equal edge lengths (squares), the x and y parameters must be identical.
Value range: > +1 or < -1
Illegal value is 0 (leads to division by 0)

edgeSharpness:
Edge sharpness of the squares
Type: float
Value range: > +1 or < -1
Values around 1000 and above result in relatively sharp edges for HD formats.
At 200 and below, the edge smoothness is clearly visible.

Return value:

The value of the parameter color1 or color2 (in the change of squares)
Type: float3 (same type as color1 and color2)
Value range: 0.0 to 1.0

Code description

The code at the top of this page is compressed.
For a better understanding, the uncompressed code is described here:

float3 fn_checkPatternSoft  (float2 uv, float3 color1, float3 color2, float2 number, float edgeSharpness)
{ 
   float x =  sin (uv.x * PI * number.x );
   x *=  edgeSharpness / number.x;
   x =  clamp( x, -0.5, 0.5);        // range -0.5 +0.5
   x += 0.5 ;                        // range 0 to 1

 float y =  sin (uv.y * ((number.y * PI) / _OutputAspectRatio));
   y *=  edgeSharpness/ number.y;
   y =  clamp( y, -0.5, 0.5);
   y+= 0.5 ; 

   float mix = lerp( y , 1.0 - y, x);
   return lerp (color1, color2, mix);
}

Code description in illustrated form:
(Where one-dimensional float values are created in the code, the images linked below show these values as grayscale (for illustration purposes only).

Vertical lines:
float x = sin (uv.x * PI * number.x ); this is the result (if number.x = 5.0)

The following two lines of code increase the sharpness:

x *=  edgeSharpness / number.x;
x =  clamp( x, -0.5, 0.5);   // range -0.5 +0.5`

` x += 0.5 ; ` Move to the normal range from 0 to 1

Horizontal lines:

 float y =  sin (uv.y * ((number.y * PI) / _OutputAspectRatio));
   y *=  edgeSharpness/ number.y;
   y =  clamp( y, -0.5, 0.5);
   y+= 0.5 ;

float mix = lerp( y , 1.0 - y, x); Pattern generation from the vertical and horizotal lines.

return lerp (color1, color2, mix); Assignment to the set colors.

Code_for_developing_Lightworks_effects

Here we collect code to create Lightworks.fx effects.