ProceduralSky

Category: Core

Type of that is generated procedurally based on user input parameters.

enum TextureSize:

TEXTURE_SIZE_256 = 0
TEXTURE_SIZE_512 = 1
TEXTURE_SIZE_1024 = 2
TEXTURE_SIZE_4096 = 4
TEXTURE_SIZE_MAX = 5 — Represents the size of the TextureSize enum.

ProceduralSky provides a way to create an effective background quickly by defining procedural parameters for the sun, the sky and the ground. The sky and ground are very similar, they are defined by a color at the horizon, another color, and finally an easing curve to interpolate between these two colors. Similarly the sun is described by a position in the sky, a color, and an easing curve. However, the sun also defines a minimum and maximum angle, these two values define at what distance the easing curve begins and ends from the sun, and thus end up defining the size of the sun in the sky.

The ProceduralSky is updated on the CPU after the parameters change and stored in a texture and then displayed as a background in the scene. This makes it relatively unsuitable for realtime updates during gameplay. But with a small texture size it is still feasible to update relatively frequently because it is updated on a background thread when multi-threading is available.

ground_bottom_color

Setter	set_ground_bottom_color(value)
Getter	get_ground_bottom_color()

Color of the ground at the bottom.

float ground_curve

Setter	set_ground_curve(value)
Getter	get_ground_curve()

ground_energy

Setter	set_ground_energy(value)
Getter	get_ground_energy()

Amount of energy contribution from the ground.

Color ground_horizon_color

Setter	set_ground_horizon_color(value)
Getter	get_ground_horizon_color()

Color of the ground at the horizon.

sky_curve

How quickly the sky_horizon_color fades into the .

float sky_energy

Setter	set_sky_energy(value)
Getter	get_sky_energy()

Amount of energy contribution from the sky.

Setter	set_sky_horizon_color(value)
Getter	get_sky_horizon_color()

Color of the sky at the horizon.

sky_top_color

Setter	set_sky_top_color(value)
Getter	get_sky_top_color()

Color of the sky at the top.

float sun_angle_max

Setter	set_sun_angle_max(value)
Getter	get_sun_angle_max()

sun_angle_min

Distance from sun where it goes from solid to starting to fade.

Color sun_color

Setter	set_sun_color(value)
Getter	get_sun_color()

Color of the sun.

sun_curve

Setter	set_sun_curve(value)
Getter	get_sun_curve()

How quickly the sun fades away between sun_angle_min and .

float sun_energy

Setter	set_sun_energy(value)
Getter	get_sun_energy()

Amount of energy contribution from the sun.

sun_latitude

Setter	set_sun_latitude(value)
Getter	get_sun_latitude()

The suns height using polar coordinates.

float sun_longitude

The direction of the sun using polar coordinates.

Setter	set_texture_size(value)
Getter	get_texture_size()