Skip to content

SIsilicon/Godot-Volumetrics-Plugin

Repository files navigation

Godot Volumetrics Plugin

Donate

volumetrics plugin

Hello fellow Godot user. This plugin will enable to create well lit volumetric fog in the game engine. GLES 3 only.

What is it exactly?

volumetric_techniques

Well as you may know, there are many different ways of achieving volumetric effects; each one has their one advantages and disadvantages. Here is a list of some of these techniques.

  • Analytic fog :- An oldy but a goody, this blends a solid colour onto the scene based on depth, and sometimes height. It's easy to calculate, but usually doesn't interact with lights in the scene.

  • Billboard sprites :- Semi-transparent sprites that always face the viewer can do a good job of simulating fire, clouds and smoke. The illusion can break however if viewed from multiple angles, or intersects any geometry, revealing the true nature of the billboard sprites.

  • Screen space postprocessing :- Using what's on screen, this technique is pretty versatile and allows you to render a variety of volumetric effects. However, as the name implies, the effect is limited by what's visible.

  • Voxel based volumetric fog :- The technique implemented here.

This technique, based on frostbite's implementation, uses a bunch of frustum-aligned 3D textures to hold the participating media in clip-space. This media is then used to calculate lights in 3D space in a more unified manner. Local fog can easily be blended with each other, global fog, and to an extent in this case, transparent objects.

Installation

Whether it's downloaded from the asset library, or directly from the GitHub repo, you must retrieve the silicon.vfx.volumetrics folder inside the addons folder, and put it into your addons folder. If you don't have one, make one. After that, you go into your Project Settings to enable the addon, and you'll be good to go.

Note: you may have some errors involving some nodes not being found; don't worry. Those errors mean nothing and your project will work as usual.

How to use

Volumetric Fog volumetric_fog

volumetric_fog_inspector

To start adding volumetric fog to your scene, you need to first add a VolumetricFog node to your scene (One per viewport). This node holds the properties responsible for how volumes in the scene get rendered.

  • Start:- The closest point to where volumes appear.
  • End :- The farthest point to where volumes appear.
  • Tile Size :- The size of each tile in the 3D textures used to render the effect. A smaller number allows finer detail, but can severely reduce performance.
  • Samples :- The number of layers used to render the volumes. A larger number allows more detail along the depth of the scene, but can reduce performance.
  • Distribution :- How much the volume layers get packed close to the Start distance. A value of zero means equal distribution, while a value of one distributes the layers closer to the viewer, giving more detail close up than farther away.
  • Temporal Blending :- How much the effect blends with the previous frame. A higher value can smooth the effect more, but is more susceptible to ghosting artifacts. Setting it to zero disables blending altogether.
  • Volumetric Shadows :- Enabling this allows volumes in view to cast shadows on themselves (Not on geometry though).
  • Shadow Atlas Size :- How much resolution is used to render the shadows of lights. Does not affect Volumetric Shadows.
  • Ambient Light Color :- The color of the ambient light applied to volumes.
  • Ambient Light Energy :- How much the ambient light is applied to volumes.
  • Cull Mask :- This determines what lights get processed in the effect. Lights whose layers don't match up with this will not show up in the fog.

Volume Proxy volume_proxy

volume_proxy_inspector

After you've added the node mentioned above, the VolumeProxy node should now work for you and can be added to the scene. It has two properties.

  • Material :- Determines the apparent properties of the volume.
  • Bounds Mode :- The shape of volume's borders
    • Global :- No borders at all. Only one VolumeProxy can be global at a time.
    • Local Box :- The border's shaped like a cuboid.
    • Local Sphere :- The border's shaped like an ellipsoid.
  • Extents :- The region in which the volume is rendered (with a local bounds mode).
  • Bounds Fade :- How faded the bounds of the volume is.

Volumetric Material volumetric_material

volumetric_material_inspector

VolumeProxys use a VolumetricMaterial to change the way they appear. They are pretty basic right now, but should do for most practical situations. They have the following properties.

  • Scatter Color :- The color of the volume.
  • Density :- How thick the volume is.
  • Scatter Texture :- A texture applied to the volume's color.
  • Absorption Color :- The color appears as light get's absorbed by the volume. Visible when used in conjunction with Volumetric Shadows.
  • Anisotropy :- How light is scattered through the volume. Positive values tend to scatter light towards the viewer, while negative scatters light away from the viewer.
  • Emission Enabled :- Whether to use emission in the volume.
  • Emission Color :- The color of the emission in the volume.
  • Emission Strength :- How strong the emission is.
  • Emission Texture :- A texture applied to the volume's emission.
  • Uvw Scale :- The scale factor of the uvw texture coordinates.
  • Uvw Offset :- The offset of the uvw texture coordinates.

3D Texture Creator

3d texture creator

The plugin comes with a 3D Texture Creator so that you can easily give a little life to your fog volumes. More specifically, you can generate 3D noise textures. You can find this tool under Project -> Tools -> Create 3D Texture....

3d texture location

After setting up the texture (Each label has a tooltip for you), press the Create Texture button to save the texture to a location. If you're not overriding an existing texture, then you'll have to close and open the engine window to refresh the file manager. Then select the texture and setup the slices (you get the numbers from the texture creator). If the texture is being created for the first time, then it would be imported as a regular texture. You would need to manually reimport it as a Texture3D and restart the editor. And just like that, you should now have a 3D texture to use in your fog. :)

Demo

volumetrics demo

The project comes with a demo to see what can be done with the plugin. Each setting on the top right has a tooltip to tell you about what they do.

  • You look around with the mouse and move with the arrow keys.
  • To see your mouse again, press the Esc key.
  • You can also hide the GUI with G.
  • To exit the demo, you press Shift+Esc.

Here is a link to a video of the demo. https://youtu.be/5R1YU8vNa48

Other stuff

By default, all lights added to the scene affect volumes at the same strength, but you can adjust this strength for each individual light. Each one should now have a Volumetric Energy parameter. This can be used to strengthen or weaken the volumetric effect the light has, without changing the energy the light contributes to real geometry. If you want to do it by script then you must set it as a meta value.

set_meta("volumetric", energy_you_wanna_set_as)

Speaking of geometry, transparent geometries do not blend with volumetrics by default. You need to enable Apply Volumetrics to do that*. Like Volumetric Energy, this too is set as a meta value.

set_meta("apply_volumetrics", wanna_apply_it)

*Friendly tip, the volumes are displayed in the last render layer (Layer 20), and their render priorities are -16 and -17.

Limitations

  • Orthographic camera projection is not supported.
  • The support of transparent materials is limited, as only some of the material properties are supported. The ones that are supported are: Material Override, Material in CSGPrimitives, and Materials in MeshInstances(Not to be confused with the material inside meshes).
  • It doesn't show up in reflection probes.
  • It doesn't get lit by indirect light sources (GIProbes and BakedLights).

Credits and Special Thanks

As stated at the start, this project is based on frostbite's approach to volumetric fog, but I also based my code off of how blender implemented it in their Eevee engine. Lastly, I was inspired to start this project in the first place by danilw's Volumetric Light demo. Go check it out. 😄