Reference

Presets

Fifteen skies, one file each, in src/config/presets/. Hover a card to see the sky move, click to enlarge it, or run one live.

Clear preset — Clear`clear`High sun, a few fair-weather cumulus.

Partly cloudy preset — Partly cloudy`partlyCloudy`Broken cumulus in clumps and clearings.

Marine preset — Marine`marine`The signature sky: sea cumulus with the sun ahead.

Overcast preset — Overcast`overcast`A low grey deck. No blue, no sun disc.

Storm preset — Storm`storm`Squall line, rain veils, lightning, low sun under the deck.

Monsoon preset — Monsoon`monsoon`Heavy tropical rain under a torn deck.

Altocumulus preset — Altocumulus`altocumulus`A mackerel sky of small mid-level puffs.

Cirrus preset — Cirrus`cirrus`Fibrous ice cloud on a clean blue dome.

Towering preset — Towering`towering`Cumulus congestus: isolated cauliflower towers.

Cumulonimbus preset — Cumulonimbus`cumulonimbus`One monumental cell anchored 10 km north.

Dawn preset — Dawn`dawn`Sun just clear of the horizon, long warm light.

Golden hour preset — Golden hour`golden`Low sun behind towering cumulus.

Sunset preset — Sunset`sunset`Ember light under an altocumulus sheet.

Noctilucent preset — Noctilucent`noctilucent`Electric-blue high cloud in deep twilight.

Night preset — Night`night`Waning gibbous moon, stars and the milky way.

#Loading presets

sky.loadPreset('storm');        // snap: no easing, history reset, full re-bake
sky.applyPreset('storm');       // ease there over ~1–2 s
sky.presetName;                 // 'storm', or null once edited

Both also accept a params object. Any field you leave out takes the default.

#Presets are plain data

src/config/presets/golden.js

/** Golden — golden hour behind towering cumulus */
export default {
  label: 'Golden',
  cloudForm: 'towering', humidity: 0.7, precipitation: 0, temperature: 0.68, wind: 0.15, density: 0.68, edge: 0.42,
  clump: 0.5, coverage: 0, cirrus: 1, haze: 0.32, timeOfDay: 18.032, northOffset: 97.77, lunarAge: 18.3,
  exposure: 0, bloom: 0.42, godRays: 0.8, view: { yaw: 0, pitch: 0.2 },
};

view is a framing hint that only the demo uses; the library ignores it.

import { PRESETS, getPresetParams } from 'naturegl-sky';

Object.keys(PRESETS);           // ['clear', 'partlyCloudy', …]
getPresetParams('marine');      // complete, deep-cloned SkyParams

#Try one live

Starts on `cumulonimbus`. Press 1–0 in the demo to switch presets.

#Reference

Name	Form	Time	Look
`clear`	cumulus	13:59	High sun, a few fair-weather cumulus
`partlyCloudy`	cumulus	15:00	Broken cumulus in clumps and clearings
`marine`	cumulus	15:57	The signature sky: sea cumulus, sun ahead
`overcast`	cumulus	16:11	A low grey deck, no blue, no sun
`storm`	cumulus	18:16	Dark squall line, rain veils, lightning, low sun under the deck
`monsoon`	cumulus	17:23	Heavy tropical rain under a torn deck
`altocumulus`	altocumulus	15:57	A mackerel sky of small mid-level puffs
`cirrus`	cirrus	15:43	Fibrous ice cloud, clean blue dome
`towering`	towering	16:11	Cumulus congestus: isolated cauliflower towers
`cumulonimbus`	cumulonimbus	14:45	A monumental cell anchored 10 km north, sun behind you
`dawn`	cumulus	18:20	Sun just clear of the horizon, long warm light
`golden`	towering	18:02	Golden hour behind towering cumulus
`sunset`	altocumulus	18:17	Ember light under an altocumulus sheet
`noctilucent`	noctilucent	18:47	Electric-blue high cloud in deep twilight
`night`	cumulus	21:30	Moonlit night, waning gibbous, stars and the milky way

The times were re-derived for the physical sun track: timeOfDay together with northOffset reproduces each sky's original sun elevation and azimuth. That's why dawn shows an evening hour.