Water is a very complex shader inside of the Source engine: it is animated, reflective, fogged, refractive, and bump mapped. With this complexity come rules and restrictions on how it is placed and what sort of water is used in different situations.
This sort of water is the best looking, but also carries the most cost. This shader will reflect the world around it, refract and fog the world beneath it (based on the line integral through the water volume), and animate a bump mapped texture on the surface. While the results are photo-realistic, the cost can sometimes be too prohibitive for complex scenes.
For situations where a more simplistic water solution is called for (normally for performance reasons), "cheap" water may be used. This version of water does not reflect the world around it, making it less realistic, but also much cheaper. Expensive water will fallback to cheap water on video cards that are unable to support the features necessary for it to render properly. It will also fallback to this material if the user overrides the visual quality setting for water's appearance in the Video options in-game.
To make it perform efficiently, water also has a collection of rules regarding its placement and usage inside of a map.
- There may be only one water level height in a PVS if the water is expensive.
- "Expensive" and "cheap" water may not be used simultaneously in the same PVS.
- The water's surface should never slope in the Z-axis; it should always be parallel to the horizon line in a map.
- Water is created by applying a water material to the top-most surface of a brush, while covering the remaining faces with the
- The water_lod_control entity controls the distance at which expensive water transitions into cheap water.
- An env_cubemap entity must be present for the water surface to render properly on sub-DX9 hardware.
- Areaportals may never cross the water surface.
- Water does not seal the map.
Water does not work with brush entities, and should not be attached to an entity. Water brushes included in any brush entity will not render correctly. The only exceptions are func_water_analog and func_water.
To add a water volume to your level, follow these steps:
- Create a brush the size of the water volume using the Block Tool.
- Open the Texture Browser by clicking the Browse button on the Texture Bar.
- Double-click the
tools\toolsnodrawmaterial in the Texture Browser.
- With your water brush selected, click the Apply Current Texture button to assign the
tool textures|tools\toolsnodrawmaterial to the whole brush.
- Select the Texture Application tool, which opens the Face Edit mode.
- Left-Click the top face of the water brush in the 3D view to select it.
- Click Browse to bring up the Texture Browser again.
waterinto the filter field. This will show you all materials with the keyword
waterin their name.
- Select a water material to apply by double-clicking it. One water material to try is
- Click the Apply button on the Face Edit panel.
- The brush should have water correctly applied. Compile and run your map (with VVis and VRad enabled) to test it.
In order for water surfaces to render correctly, it is necessary for your map to have a skybox, and for the water brush itself to be rectangular. The brush can intersect other brushes, in order to hide unwanted areas. If the water hasn't been rendered correctly (you can't see it), it means you have a leak somewhere.
- L4D2 maps also require an env_fog_controller.
- All water brushes in Alien Swarm must be attached to a func_brush called "structure_seal".
- To create the poison water in Portal, you must use the texture
Cubemaps and water
Cubemaps are important to use with water surfaces. On lower than DX9 level video cards, it is not possible to render the real-time reflective water shader. For these cards, an env_cubemap entity provides the pre-calculated environment map use to render water on sub-DX9 cards.
Adding a env_cubemap to water surfaces:
- Add an env_cubemap entity using the Entity Tool.
- Place the env_cubemap above the top surface of the water, near the center.
- Double-click the env_cubemap in the 3D view to bring up the Object Properties dialog.
- Click on the Brush faces key in the Object Properties.
- Click the Pick... button. The mouse cursor will change to the eye dropper icon.
- Click the top water face to select it with the eyedropper. The face will highlight in red, to show it has been associated with the env_cubemap entity.
- Close the Object properties dialog.
- Compile and run your map. After the map is loaded, open the developers console and type
buildcubemaps. The engine will calculate an environment map for each env_cubemap entity, and save the data into the BSP file.