---
description: The backdrop of the sky
---

# The Sky Dome

## Overview

The Sky Dome functions as the backdrop upon which the rest of the COZY FX are drawn. It perfectly blends simplicity and functionality into a canvas that is a perfect base for stylized weather.

### Desktop vs Mobile

There are two different sky styles that come with COZY: Desktop and Mobile. The Mobile sky only has the [Gradient Shading](#gradient-shading) and the [Sun Disk and Halo](#sun-disk-and-halo) features whereas the Desktop style has all of the features below.

### How to Change the Sky Style

In the Options tab of the Settings module, change the value of the Sky Style enum to change the current cloud type.

<figure><img src="https://2041269432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrqKsGNTyQFMrNJSWMHS0%2Fuploads%2Fm8k5FRlEp9S9hvi7slHb%2Fimage.png?alt=media&#x26;token=4110d077-c6a3-487c-99a8-5e57cdf81a17" alt="" width="563"><figcaption></figcaption></figure>

Then select your sky type from the enum:

<figure><img src="https://2041269432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrqKsGNTyQFMrNJSWMHS0%2Fuploads%2FqLx3Ixu334tHEUMXvu28%2Fimage.png?alt=media&#x26;token=30110f8b-f9ed-4918-94f8-fb2949f9a3c7" alt=""><figcaption></figcaption></figure>

## Features

### Gradient Shading

<figure><img src="https://2041269432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrqKsGNTyQFMrNJSWMHS0%2Fuploads%2Fec1YlpkIUVhakMwSNnOM%2FGradient%20Sky%20Animation.gif?alt=media&#x26;token=e4be77e9-b93f-4c5d-bbac-5ffa1660336a" alt=""><figcaption></figcaption></figure>

The most important feature of the simple sky is a gradient shader that interpolates from the zenith color (or the top of the sky) to the horizon color. These two colors are set and then interpolated using an exponential function with a coefficient. You can set this coefficient using the gradient exponent parameter.

### Sun Disk and Halo

<figure><img src="https://2041269432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrqKsGNTyQFMrNJSWMHS0%2Fuploads%2FPPQcIIBOix3uBI6CM2kD%2FAnimation.gif?alt=media&#x26;token=04e86a61-05e5-4dc0-9148-40ad0ec5aaf7" alt="" width="563"><figcaption></figcaption></figure>

The **Sun Disk** refers to the the visual disk that represents the sun. Using the [Atmosphere Module](../modules/atmosphere-module) we can easily edit the size, color, direction, pitch, and falloff of the sun. We also have access to a **Sun Halo** that draws a smooth halo around the sun in the sky. This is _not_ the same thing as the Flare in the [Fog Dome](the-fog-dome).

### Rainbow

<figure><img src="https://2041269432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrqKsGNTyQFMrNJSWMHS0%2Fuploads%2F9ZGxovVmDtxClPnO2G1P%2FRainbow%20Animation.gif?alt=media&#x26;token=dfd0c885-0851-47b4-b8a6-f5cb477ed801" alt="" width="563"><figcaption></figcaption></figure>

COZY ships with a simple rainbow system as a part of the Desktop sky. The rainbow position and width can be edited in the atmosphere profile however the brightness of the rainbow is linked to the **wetness parameter** of the [Climate Module](../modules/climate-module).

### Stars

<figure><img src="https://2041269432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrqKsGNTyQFMrNJSWMHS0%2Fuploads%2FpBa4Giys4LUOegi8npdm%2Fimage.png?alt=media&#x26;token=e520494d-c8a0-4a1d-a774-79d525e7c706" alt="" width="563"><figcaption></figcaption></figure>

COZY has a simple star system that is used by the Desktop Sky style. By default, COZY uses an 8K star texture to place the stars with a simple variation noise in the shader for twinkling. Use the star color parameter to determine the brightness and color of the stars.&#x20;

### Galaxy

<figure><img src="https://2041269432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrqKsGNTyQFMrNJSWMHS0%2Fuploads%2FBDeMHoVfkFaK2TlobWYu%2FGalaxy%20Animation%202.gif?alt=media&#x26;token=e2207b61-62fd-4d65-83a2-acbae2d5cdb2" alt="" width="563"><figcaption></figcaption></figure>

The galaxy effect is a three channel texture that covers the night sky. Control the placement of the galaxy with the Galaxy Map property and the variation with the Galaxy Variation Map.

### Light Scattering

<figure><img src="https://2041269432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrqKsGNTyQFMrNJSWMHS0%2Fuploads%2FSwRJ5YgK9v4xbi8bAS9v%2Fimage.png?alt=media&#x26;token=6b1924fd-e2d6-44c5-b06d-627001652f87" alt="" width="563"><figcaption></figcaption></figure>

Commonly mistaken as Aurora Borealis (see the [Ambience Module](../modules/ambience-module) for the actual Aurora), the light scattering FX are actually just part of the sky! They occur around the horizon and can be replaced with a different texture or disabled by setting their color to transparent.

## Additional Features

### Stars Using the Mobile Sky Style

You may have noticed that the Mobile Sky does not have stars built into it however there is another way to do this making use of particles. Check out the Particle Stars child under the weather sphere (disabled by default) for an example for how to use this

<figure><img src="https://2041269432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrqKsGNTyQFMrNJSWMHS0%2Fuploads%2FPpgAFivlUFVPa4Thib2d%2Fimage.png?alt=media&#x26;token=9fdf3d9c-f7dc-4e62-8166-e30b64e0436a" alt="" width="563"><figcaption></figcaption></figure>

