# OceanBathymetry

> Talos next · Since 0.6

The ground under the sea, as a 16-bit height raster.

Waves shoal and break over it, the surf, swash, wet sand and caustics follow it, and the CPU sea (buoyancy) sees the same shoaled waves. Without it the sea is as deep as `depthM` says. Invalid values are `ocean-bathymetry-range-invalid`.

## Fields

| Field | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `asset` | `string` | yes |  |  | A `texture` asset: a 16-bit greyscale PNG. A texel's ground height is `baseM + stepM * value` (value 0..65535); row 0 is at the smallest z. A missing asset is `ocean-bathymetry-asset-missing`; an asset that is not a .png texture (or a PNG that is not 16-bit greyscale) is `ocean-bathymetry-not-16bit`. |
| `originXz` | `Vec2` | yes |  |  | World x and z of the raster's minimum corner, metres. |
| `sizeM` | `Vec2` | yes |  |  | World size the raster covers along x and z, metres; both above 0. Outside it the sea is deep. |
| `baseM` | `number` | yes |  |  | Ground height of texel value 0, metres. |
| `stepM` | `number` | yes |  |  | Height per texel value step, metres; above 0. |
| `minDepthM` | `number` | no | `0` |  | The thin-water floor: water shallower than this is the waterline, 0.01..1 m. Default 0.05. |

## See also

- `Vec2`