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 established oceans (‘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 it’s 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#