OceanModifier(Modifier)

base classes — bpy_struct, Modifier

class bpy.types.OceanModifier(Modifier)

Simulate an ocean surface

bake_foam_fade

How much foam accumulates over time (baked ocean only)

Type: float in [0, inf], default 0.98

choppiness

Choppiness of the wave’s crest (adds some horizontal component to the displacement)

Type: float in [0, inf], default 1.0

damping

Damp reflected waves going in opposite direction to the wind

Type: float in [0, 1], default 0.5

depth

Depth of the solid ground below the water surface

Type: float in [-inf, inf], default 200.0

fetch_jonswap

This is the distance from a lee shore, called the fetch, or the distance over which the wind blows with constant velocity. Used by ‘JONSWAP’ and ‘TMA’ models

Type: float in [0, inf], default 120.0

filepath

Path to a folder to store external baked images

Type: string, default “”, (never None)

foam_coverage

Amount of generated foam

Type: float in [-inf, inf], default 0.0

foam_layer_name

Name of the vertex color layer used for foam

Type: string, default “”, (never None)

frame_end

End frame of the ocean baking

Type: int in [-inf, inf], default 250

frame_start

Start frame of the ocean baking

Type: int in [-inf, inf], default 1

geometry_mode

Method of modifying geometry

GENERATE Generate – Generate ocean surface geometry at the specified resolution.
DISPLACE Displace – Displace existing geometry according to simulation.

Type: enum in [‘GENERATE’, ‘DISPLACE’], default ‘GENERATE’

invert_spray

Invert the spray direction map

Type: boolean, default False

is_cached

Whether the ocean is using cached data or simulating

Type: boolean, default False, (readonly)

random_seed

Seed of the random generator

Type: int in [0, inf], default 0

repeat_x

Repetitions of the generated surface in X

Type: int in [1, 1024], default 1

repeat_y

Repetitions of the generated surface in Y

Type: int in [1, 1024], default 1

resolution

Resolution of the generated surface for rendering and baking

Type: int in [1, 1024], default 7

sharpen_peak_jonswap

Peak sharpening for ‘JONSWAP’ and ‘TMA’ models

Type: float in [0, 1], default 0.0

size

Surface scale factor (does not affect the height of the waves)

Type: float in [0, inf], default 1.0

spatial_size

Size of the simulation domain (in meters), and of the generated geometry (in BU)

Type: int in [-inf, inf], default 50

spectrum

Spectrum to use

PHILLIPS Turbulent Ocean – Use for turbulent seas with foam.
PIERSON_MOSKOWITZ Established Ocean – Use for a large area, established ocean (Pierson-Moskowitz method).
JONSWAP Established Ocean (Sharp Peaks) – Use for sharp peaks (‘JONSWAP’, Pierson-Moskowitz method) with peak sharpening.
TEXEL_MARSEN_ARSLOE Shallow Water – Use for shallow water (‘JONSWAP’, ‘TMA’ - Texel-Marsen-Arsloe method).

Type: enum in [‘PHILLIPS’, ‘PIERSON_MOSKOWITZ’, ‘JONSWAP’, ‘TEXEL_MARSEN_ARSLOE’], default ‘PHILLIPS’

spray_layer_name

Name of the vertex color layer used for the spray direction map

Type: string, default “”, (never None)

time

Current time of the simulation

Type: float in [0, inf], default 1.0

use_foam

Generate foam mask as a vertex color channel

Type: boolean, default False

use_normals

Output normals for bump mapping - disabling can speed up performance if its not needed

Type: boolean, default False

use_spray

Generate map of spray direction as a vertex color channel

Type: boolean, default False

viewport_resolution

Viewport resolution of the generated surface

Type: int in [1, 1024], default 7

wave_alignment

How much the waves are aligned to each other

Type: float in [0, 1], default 0.0

wave_direction

Main direction of the waves when they are (partially) aligned

Type: float in [-inf, inf], default 0.0

wave_scale

Scale of the displacement effect

Type: float in [0, inf], default 1.0

wave_scale_min

Shortest allowed wavelength

Type: float in [0, inf], default 0.01

wind_velocity

Wind speed

Type: float in [-inf, inf], default 30.0

classmethod bl_rna_get_subclass(id, default=None)

Parameters: id (string) – The RNA type identifier.
Returns: The RNA type or default when not found.
Return type: bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)

Parameters: id (string) – The RNA type identifier.
Returns: The class or default when not found.
Return type: type

Inherited Properties

Inherited Functions