Skip to main content

Riverology - Surface

🎨 Water Rendering
💡 PBR Lighting
🌊 Flow Animation

Configure water surface rendering with absorption, scattering, and flow-driven effects.


Prerequisites​

RequirementDetails
EngineUE5.x (latest release)
PluginRiverology installed and configured
SceneBP_Riverology river spline in your level
SkillsBasic PBR and water rendering understanding
About Surface Settings

Surface Light settings control how light interacts with river water - absorption, scattering, reflectivity, and specular characteristics. Properly configured settings achieve realistic water responding to scene lighting.


Step-by-step​

1. Configure the Surface Light parameters

With BP_Riverology selected, scroll through the Details panel to find the Surface Light category. This section contains all parameters that control light interaction with the water surface:

Color Properties:

  • Absorption - The color absorbed by the water. Darker colors create murkier water; lighter colors allow more light penetration. This affects how the riverbed and submerged objects appear.
  • Scattering - The color scattered by particles in the water. Controls the tint of light that bounces within the water volume.

Surface Properties:

  • Anisotropy (Surface Scattering) - Controls the directionality of light scattering (default: 0.8). Higher values create more directional scattering along the flow direction.
  • Water Roughness - The micro-surface roughness of the water (default: 0.05). Lower values create sharper, mirror-like reflections; higher values create softer, diffused reflections.
  • Water Fresnel Roughness - Controls roughness specifically for Fresnel calculations (default: 0.02). Affects how reflectivity changes based on viewing angle.
  • Water Specular - The specular intensity of the water surface (default: 0.225). Higher values create brighter specular highlights.
  • Exponent - The specular exponent controlling highlight sharpness (default: 5.0). Higher values create tighter, more concentrated highlights.
  • BaseReflectFractionIn - Base reflectivity fraction when looking into the water (default: 0.04). Controls minimum reflection at perpendicular viewing angles.

Surface Light parameters in Details panel

2. Preview the surface configuration

Press Play or use the viewport to observe how your Surface Light settings affect the river appearance. The combination of absorption, scattering, and specular properties creates the final visual result.

Key visual indicators:

  • Water clarity - Controlled primarily by Absorption color.
  • Surface reflections - Controlled by Water Roughness, Water Specular, and Fresnel settings.
  • Light response - How the water reacts to directional and ambient lighting in your scene.

Iterate on the settings until you achieve the desired look for your environment.

River surface with configured lighting


Parameter Reference​

ParameterRangeDefaultEffect
AbsorptionColor-Water color absorption (darker = murkier)
ScatteringColor-Light scatter color within water volume
Anisotropy0.0 - 1.00.8Scattering directionality
Water Roughness0.0 - 1.00.05Surface reflection sharpness
Water Fresnel Roughness0.0 - 1.00.02Angle-dependent reflection roughness
Water Specular0.0 - 1.00.225Specular highlight intensity
Exponent1.0 - 128.05.0Specular highlight concentration
BaseReflectFractionIn0.0 - 1.00.04Minimum perpendicular reflectivity

Water TypeAbsorptionRoughnessSpecularNotes
Clear Mountain StreamLight blue0.020.3High clarity, sharp reflections
Forest RiverGreen-brown0.080.2Moderate clarity, organic tint
Muddy RiverDark brown0.150.15Low clarity, diffused surface
Tropical LagoonCyan0.030.25High clarity, vibrant color

Troubleshooting Common Issues​

ProblemLikely CauseSolution
Water looks too darkAbsorption color too saturatedLighten the Absorption color
No visible reflectionsWater Specular too lowIncrease Water Specular value
Reflections too blurryWater Roughness too highDecrease Water Roughness
Unrealistic plastic lookFresnel settings incorrectAdjust BaseReflectFractionIn closer to 0.04
Specular too harshExponent too highLower the Exponent value
Water appears flatScattering not configuredAdjust Scattering color to add depth

Summary​

In this guide, you learned how to:

  1. Configure surface light settings - Adjust absorption, scattering, and specular properties in the Surface Light category.
  2. Preview and iterate - Observe how settings affect the river appearance and fine-tune for your scene.

These settings are fundamental to achieving realistic river rendering and should be tuned to match your scene's lighting and artistic direction.