World(ID)

base classes — bpy_struct, ID

class bpy.types.World(ID)

World data-block describing the environment and ambient lighting of a scene

animation_data

Animation data for this data-block

Type:

AnimData, (readonly)

color

Color of the background

Type:

mathutils.Color of 3 items in [0, inf], default (0.05, 0.05, 0.05)

light_settings

World lighting settings

Type:

WorldLighting, (readonly, never None)

lightgroup

Lightgroup that the world belongs to

Type:

string, default “”, (never None)

mist_settings

World mist settings

Type:

WorldMistSettings, (readonly, never None)

node_tree

Node tree for node based worlds

Type:

NodeTree, (readonly)

probe_resolution

Resolution when baked to a texture

Type:

enum in [‘128’, ‘256’, ‘512’, ‘1024’, ‘2048’, ‘4096’], default ‘1024’

sun_angle

Angular diameter of the Sun as seen from the Earth

Type:

float in [0, 3.14159], default 0.00918043

sun_shadow_filter_radius

Blur shadow aliasing using Percentage Closer Filtering

Type:

float in [0, inf], default 1.0

sun_shadow_jitter_overblur

Apply shadow tracing to each jittered sample to reduce under-sampling artifacts

Type:

float in [0, 100], default 10.0

sun_shadow_maximum_resolution

Maximum size of a shadow map pixel. Higher values use less memory at the cost of shadow quality.

Type:

float in [0, inf], default 0.001

sun_threshold

If non-zero, the maximum value for world contribution that will be recorded inside the world light probe. The excess contribution is converted to a sun light. This reduces the light bleeding caused by very bright light sources.

Type:

float in [0, inf], default 10.0

use_eevee_finite_volume

The world’s volume used to be rendered by EEVEE Legacy. Conversion is needed for it to render properly.

Type:

boolean, default False

use_nodes

Use shader nodes to render the world

Type:

boolean, default False

use_sun_shadow

Enable sun shadow casting

Type:

boolean, default True

use_sun_shadow_jitter

Enable jittered soft shadows to increase shadow precision (disabled in viewport unless enabled in the render settings). Has a high performance impact.

Type:

boolean, default False

classmethod bl_rna_get_subclass(id, default=None)
Parameters:

id (str) – 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 (str) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References