Visual Shader plugins

Visual Shader plugins are used to create custom VisualShader nodes in GDScript.

The creation process is different from usual editor plugins. You do not need to create a plugin.cfg file to register it; instead, create and save a script file and it will be ready to use, provided the custom node is registered with class_name.

This short tutorial will explain how to make a Perlin-3D noise node (original code from this GPU noise shaders plugin.

Create a Sprite2D and assign a ShaderMaterial to its material slot:

../../../_images/visual_shader_plugins_start.png

Assign VisualShader to the shader slot of the material:

../../../_images/visual_shader_plugins_start2.png

Don’t forget to change its mode to “CanvasItem” (if you are using a Sprite2D):

../../../_images/visual_shader_plugins_start3.png

Create a script which derives from VisualShaderNodeCustom. This is all you need to initialize your plugin.

  1. # perlin_noise_3d.gd
  2. @tool
  3. extends VisualShaderNodeCustom
  4. class_name VisualShaderNodePerlinNoise3D
  7. func _get_name():
  8.     return "PerlinNoise3D"
  11. func _get_category():
  12.     return "MyShaderNodes"
  15. func _get_description():
  16.     return "Classic Perlin-Noise-3D function (by Curly-Brace)"
  19. func _init():
  20.     set_input_port_default_value(2, 0.0)
  23. func _get_return_icon_type():
  24.     return VisualShaderNode.PORT_TYPE_SCALAR
  27. func _get_input_port_count():
  28.     return 4
  31. func _get_input_port_name(port):
  32.     match port:
  33.         0:
  34.             return "uv"
  35.         1:
  36.             return "offset"
  37.         2:
  38.             return "scale"
  39.         3:
  40.             return "time"
  43. func _get_input_port_type(port):
  44.     match port:
  45.         0:
  46.             return VisualShaderNode.PORT_TYPE_VECTOR_3D
  47.         1:
  48.             return VisualShaderNode.PORT_TYPE_VECTOR_3D
  49.         2:
  50.             return VisualShaderNode.PORT_TYPE_SCALAR
  51.         3:
  52.             return VisualShaderNode.PORT_TYPE_SCALAR
  55. func _get_output_port_count():
  56.     return 1
  59. func _get_output_port_name(port):
  60.     return "result"
  63. func _get_output_port_type(port):
  64.     return VisualShaderNode.PORT_TYPE_SCALAR
  67. func _get_global_code(mode):
  68.     return """
  69.         vec3 mod289_3(vec3 x) {
  70.             return x - floor(x * (1.0 / 289.0)) * 289.0;
  71.         }
  73.         vec4 mod289_4(vec4 x) {
  74.             return x - floor(x * (1.0 / 289.0)) * 289.0;
  75.         }
  77.         vec4 permute(vec4 x) {
  78.             return mod289_4(((x * 34.0) + 1.0) * x);
  79.         }
  81.         vec4 taylorInvSqrt(vec4 r) {
  82.             return 1.79284291400159 - 0.85373472095314 * r;
  83.         }
  85.         vec3 fade(vec3 t) {
  86.             return t * t * t * (t * (t * 6.0 - 15.0) + 10.0);
  87.         }
  89.         // Classic Perlin noise.
  90.         float cnoise(vec3 P) {
  91.             vec3 Pi0 = floor(P); // Integer part for indexing.
  92.             vec3 Pi1 = Pi0 + vec3(1.0); // Integer part + 1.
  93.             Pi0 = mod289_3(Pi0);
  94.             Pi1 = mod289_3(Pi1);
  95.             vec3 Pf0 = fract(P); // Fractional part for interpolation.
  96.             vec3 Pf1 = Pf0 - vec3(1.0); // Fractional part - 1.0.
  97.             vec4 ix = vec4(Pi0.x, Pi1.x, Pi0.x, Pi1.x);
  98.             vec4 iy = vec4(Pi0.yy, Pi1.yy);
  99.             vec4 iz0 = vec4(Pi0.z);
  100.             vec4 iz1 = vec4(Pi1.z);
  102.             vec4 ixy = permute(permute(ix) + iy);
  103.             vec4 ixy0 = permute(ixy + iz0);
  104.             vec4 ixy1 = permute(ixy + iz1);
  106.             vec4 gx0 = ixy0 * (1.0 / 7.0);
  107.             vec4 gy0 = fract(floor(gx0) * (1.0 / 7.0)) - 0.5;
  108.             gx0 = fract(gx0);
  109.             vec4 gz0 = vec4(0.5) - abs(gx0) - abs(gy0);
  110.             vec4 sz0 = step(gz0, vec4(0.0));
  111.             gx0 -= sz0 * (step(0.0, gx0) - 0.5);
  112.             gy0 -= sz0 * (step(0.0, gy0) - 0.5);
  114.             vec4 gx1 = ixy1 * (1.0 / 7.0);
  115.             vec4 gy1 = fract(floor(gx1) * (1.0 / 7.0)) - 0.5;
  116.             gx1 = fract(gx1);
  117.             vec4 gz1 = vec4(0.5) - abs(gx1) - abs(gy1);
  118.             vec4 sz1 = step(gz1, vec4(0.0));
  119.             gx1 -= sz1 * (step(0.0, gx1) - 0.5);
  120.             gy1 -= sz1 * (step(0.0, gy1) - 0.5);
  122.             vec3 g000 = vec3(gx0.x, gy0.x, gz0.x);
  123.             vec3 g100 = vec3(gx0.y, gy0.y, gz0.y);
  124.             vec3 g010 = vec3(gx0.z, gy0.z, gz0.z);
  125.             vec3 g110 = vec3(gx0.w, gy0.w, gz0.w);
  126.             vec3 g001 = vec3(gx1.x, gy1.x, gz1.x);
  127.             vec3 g101 = vec3(gx1.y, gy1.y, gz1.y);
  128.             vec3 g011 = vec3(gx1.z, gy1.z, gz1.z);
  129.             vec3 g111 = vec3(gx1.w, gy1.w, gz1.w);
  131.             vec4 norm0 = taylorInvSqrt(vec4(dot(g000, g000), dot(g010, g010), dot(g100, g100), dot(g110, g110)));
  132.             g000 *= norm0.x;
  133.             g010 *= norm0.y;
  134.             g100 *= norm0.z;
  135.             g110 *= norm0.w;
  136.             vec4 norm1 = taylorInvSqrt(vec4(dot(g001, g001), dot(g011, g011), dot(g101, g101), dot(g111, g111)));
  137.             g001 *= norm1.x;
  138.             g011 *= norm1.y;
  139.             g101 *= norm1.z;
  140.             g111 *= norm1.w;
  142.             float n000 = dot(g000, Pf0);
  143.             float n100 = dot(g100, vec3(Pf1.x, Pf0.yz));
  144.             float n010 = dot(g010, vec3(Pf0.x, Pf1.y, Pf0.z));
  145.             float n110 = dot(g110, vec3(Pf1.xy, Pf0.z));
  146.             float n001 = dot(g001, vec3(Pf0.xy, Pf1.z));
  147.             float n101 = dot(g101, vec3(Pf1.x, Pf0.y, Pf1.z));
  148.             float n011 = dot(g011, vec3(Pf0.x, Pf1.yz));
  149.             float n111 = dot(g111, Pf1);
  151.             vec3 fade_xyz = fade(Pf0);
  152.             vec4 n_z = mix(vec4(n000, n100, n010, n110), vec4(n001, n101, n011, n111), fade_xyz.z);
  153.             vec2 n_yz = mix(n_z.xy, n_z.zw, fade_xyz.y);
  154.             float n_xyz = mix(n_yz.x, n_yz.y, fade_xyz.x);
  155.             return 2.2 * n_xyz;
  156.         }
  157.     """
  160. func _get_code(input_vars, output_vars, mode, type):
  161.     return output_vars[0] + " = cnoise(vec3((%s.xy + %s.xy) * %s, %s)) * 0.5 + 0.5;" % [input_vars[0], input_vars[1], input_vars[2], input_vars[3]]

Save it and open the Visual Shader. You should see your new node type within the member’s dialog under the Addons category (if you can’t see your new node, try restarting the editor):

../../../_images/visual_shader_plugins_result1.png

Place it on a graph and connect the required ports:

../../../_images/visual_shader_plugins_result2.png

That is everything you need to do, as you can see it is easy to create your own custom VisualShader nodes!

Previous Next

© Copyright 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision 53e837c6.

Built with Sphinx using a theme provided by Read the Docs.