ocean
An endless sea at this object's height: wind-driven waves, sky reflections and sun glitter, clear shallows over sand, deep blue water, foam on crests and along the shore. Aircraft and boats meet it at its surface.
In scene text
ocean { wave_height 1 wind_direction 1 choppiness 1 }Add it in the Inspector (Add Component), in scene text as above, or ask your AI. Fields you leave out keep their defaults.
Fields 31
| Field | Type | Unit / range | What it does |
|---|---|---|---|
wave_height | number | m, 0 … 12 | Biggest waves, crest to trough: 0.5 calm, 1.5 fresh breeze, 4+ storm. |
wind_direction | number | deg, -360 … 360 | Compass direction the wind blows toward (0 north, 90 east). |
choppiness | number | 0 … 1 | 0 round swell, 1 sharp, breaking chop. |
deep_color | colour (r, g, b) | — | Deep open water. |
shallow_color | colour (r, g, b) | — | Thin water: over sand, through wave crests. |
clarity | number | m, 0.2 … 60 | How far you can see into the water. |
foam | number | 0 … 1 | White water on crests and at the shore. |
model | text | — | gerstner |
wind_speed | number | m/s, 0 … 40 | Spectrum: wind 10 m above the sea (3 light air, 8 breeze, 15 gale, 25 storm). |
fetch | number | km, 0.1 … 5000 | Spectrum: open water upwind; short is choppy and young, long is tall and long-period. |
spectrum | text | — | jonswap |
spread | number | 0 … 1 | Spectrum: 0 long straight swell, 1 confused short-crested sea. |
peak_sharpness | number | 1 … 7 | Spectrum: JONSWAP gamma, 1 fully developed, 3.3 typical, 7 young sea. |
tile_size | number | m, 20 … 2000 | Spectrum: largest wave tile; smaller ones layer detail on it. |
resolution | number | 64 … 256 | Spectrum: FFT samples per tile side (64, 128, 256). |
cascades | number | 1 … 4 | Spectrum: wave tiles layered (4 with a 1000 m tile: a sea that repeats only every kilometre, detail down to centimetres). |
seed | number | 0 … 100000 | Spectrum: which random sea. |
whitecap_threshold | number | 0 … 1 | Spectrum, with whitecaps -1: higher, more whitecaps (fold amount where foam starts). |
whitecaps | number | -1 … 4 | Spectrum: how much of the sea breaks into whitecaps, against what's measured at sea for this wind (about 1% of the surface at 10 m/s, 4% at 15, 11% at 20, a fifth at 25): 1 as measured, 0 none, 2 twice; -1 uses whitecap_threshold instead. |
foam_fade | number | s, 0.1 … 20 | Spectrum: how long whitecaps linger. |
absorption | (x, y, z) | — | Light absorbed per meter at clarity 7, red green blue (clarity scales it). |
subsurface | number | 0 … 2 | Sun glow through thin wave crests. |
glitter | number | 0 … 2 | Sun glitter brightness. |
refraction | number | 0 … 2 | How much the waves bend the view of the bottom. |
shore_fade | number | m, 0.01 … 3 | Depth over which the sea fades in at the shore. |
surf | number | 0 … 3 | Surf: waves that slow, steepen and break on every beach and rock shelf (0 none, 1 as the waves make it, 3 big surf). |
surf_period | number | s, -1 … 25 | Seconds between breaking waves (-1 from the sea's longest waves). |
run_up | number | m, -1 … 6 | How high the waves run up the shore: sand and rock wet below it, a sheet of water and foam with each wave (-1 from the wave height, 0 a dry shore). |
underwater_color | colour (r, g, b) | — | Underwater: the water's color. |
caustics | number | 0 … 3 | Underwater and shallows: caustic brightness. |
light_shafts | number | 0 … 3 | Underwater: sun shaft brightness. |
Arcwright Beta 2 (0.4.0) · generated from the engine source (25e375c86)Something wrong or missing? Tell us