Chapter 620: Water

Core Idea

A basic flat, reflective water effect.

Note that this class can only be used with WebGLRenderer. When using WebGPURenderer, use WaterMesh.

References:

• Flat mirror for three.js
• An implementation of water shader based on the flat mirror
• Water shader explanations in WebGL

Key Concepts

• isWater : boolean (readonly): This flag can be used for type testing.

Code Examples

import { Water } from 'three/addons/objects/Water.js';

• What it demonstrates: Typical usage of Water.

Reference Tables

Constructor

Signature
new Water( geometry : BufferGeometry, options : Water~Options )

Properties

Property	Description
.isWater : boolean (readonly)	This flag can be used for type testing.

Key Takeaways

1. Water extends: EventDispatcher → Object3D → Mesh
2. Most relevant properties: isWater.

Connects To

• EventDispatcher: parent class
• Object3D: parent class
• Mesh: parent class
• Source: examples/jsm/objects/Water.js