Choose the representation that owns the requested view. Open-water sea states use
explicit frequency-space ownership. A beach-level breaker view uses a coupled
band-limited wave field, coast representation, swash state, foam history, and
sand response. Do not reduce either target to scrolling normal maps or unrelated
foam noise.
This skill contains exemplary examples and assets beyond descriptive guidance,
they're worth studying, referencing, or even copying. Use them sufficiently
when relevant and do NOT blindly skip them.
Read references/spectral-cascade-ocean-system.md before implementing or auditing a spectral ocean.
Read
references/coastal-breaker-and-swash-ocean.md
before implementing or auditing the water-to-wet-sand transition of a coastal
breaker system.
Read the spectral cascade ocean system
and its adjacent spectrum, FFT, material, and detail modules for the cascade,
FFT, derivative, Jacobian, foam-history, and shading contracts. Its WebGL2
fragment-FFT backend is an explicit compatibility tier; preserve the
production WebGPU/TSL architecture described in the reference when the target
supports it.
Read the
stylized above/below ocean material
when the target needs a stylized FFT ocean that can be inspected from both
above and below the surface: height-gradient water color, sun-path glints,
crest scatter, Jacobian foam, water-tinted seafloor caustics, and an
underwater Beer-Lambert composite driven by scene depth.
Read the
submerged Snell ocean system
when the camera must remain underwater beneath a WebGPU spectral surface: it
provides exact water-to-air Fresnel with a derivative-filtered critical-angle
mask, total internal reflection against a physically bright upwelling underside,
an energy-conserving transmitted-sun lobe, forward projection of above-water
structures into the window, shared HDR sky radiance, aquatic extinction and
in-scatter, footprint-faded differential-area caustics, full-resolution god rays,
suspended particulates, and the final HDR grade.
Read the
coastal breaker ocean system
when the defining view sits at the waterline: it provides deterministic
band-limited gravity and capillary fields, a signed-distance mainland and
island coast, coast-normal shallow-water swash chains, persistent breaker and
film foam, camera-following warped geometry, wet-sand optics, and shared sky
radiance.
Read the
ocean beach waves implementation
when the beach is owned by a positivity-preserving finite-volume solver: it
provides a rocky coastal grid, reconstructed water and wet-sand fields,
advected foam, shallow-film optics, reflected and refracted sky radiance, and
impact-triggered spray.
$threejs-water-optics; an ocean whose camera changes medium cannot.)tan θc ≈ 1.1346 times the ray's own distance from the interface), not by the camera-to-source span.distance² · pixelAngle / heightGap — and apply it to vertex displacement, derivatives, and every band that rides them. Fade each band to its own mean when the band is an albedo or radiance term.one coast contract; do not derive unstable column ordering from SDF gradients.
linear spring chain does not uniquely recover a flat free surface.
shoreline decal.
surface, and derivative-filter sand normal detail at grazing distance.
reflection.
comparisons.
$threejs-water-optics and its photoreal-water example for air-side shallow-water FFT optics, RGB caustics and diffraction glare. Use that skill for bounded water, screen-space refraction, depth thickness, shoreline absorption, and analytic wave surfaces. Its screen-space refraction is valid there because the camera stays in air and the volume is bounded; it is not a substitute for this skill's forward projection across an open interface.$threejs-procedural-vfx only when crest spray or interaction splashes are required.$threejs-visual-validation for cross-seed, temporal, and GPU evidence.