- Geometry
- Render
Sky
Purpose
Section titled “Purpose”Sky adds atmosphere and sunlight around a Scene. Clouds drift overhead, filtering the light and casting shadows across your objects. After sunset a Physical Sky draws the night: the stars, the planets, the Milky Way and a Moon that lights the scene and the clouds.
Use Physical for weather, HDR for an environment image, Procedural for a simpler sky, or Solid for uniform colour.
Place Sky under Geometry / Render and select it in the Sky field on Scene’s Collection page.
For a renderer in Local mode, select it on the renderer’s Scene page instead.
Start with Physical and choose Weather on the Sky page. Move Time of Day to change the sun’s position, the sky’s colour and the shadows. Adjust Coverage for more or fewer clouds.
Move Time of Day past sunset for the night. Night Exposure on the Night page keeps it visible without touching the renderer’s Exposure.
For an environment image, choose HDR and connect it to hdr. HDR Rotation turns the image around the scene, and HDR Tint changes its colour. Leave Add Sun off when the image already carries its own sun.
Inputs and outputs
Section titled “Inputs and outputs”hdrsupplies a linear lat-long RGBA image for the HDR source.weather_mapcontrols where Physical clouds form. Red sets coverage, green sets cloud type.starsreplaces the star catalogue with your own: one row per star of right ascension and declination (degrees, J2000), magnitude and B-V colour.
scene carries the environment and its sun. In TouchDesigner, selecting Sky on the Scene or renderer connects it. In a Lab graph, wire scene into a free object input on Scene.
Controls
Section titled “Controls”- Weather chooses Clear, Fair Cumulus, Stratocumulus, Overcast or Storm. In TouchDesigner, choosing a weather fills in its cloud and haze settings. Adjust them afterwards for your own weather.
- Time of Day is local solar time in hours. Latitude and Day of Year on Advanced set when dawn and dusk happen. Sun Heading turns the sun’s path around the scene. To aim the sun directly, set Sun Position to Direction and use Sun Direction.
- Wind and Wind Direction move the clouds. Cloud Shadows sets how much they hold back the sunlight. Sun Intensity and Sky Intensity set the direct and scattered light.
- Meters Per Unit matches the atmosphere to your scene’s scale. Use 1 for metres or 0.01 for centimetres. Ground Height sets the planet’s ground level in scene units.
- Time Scale and Time Offset control cloud motion. Cloud time is scene time multiplied by Time Scale, plus Time Offset in seconds.
- Quality controls the steps through the clouds. Cloud Detail Quality chooses Fine, Medium or Coarse. Lower detail costs less and softens small wisps. For another speed control, use Sky Resolution on Realtime Trace’s Sky page.
- The Night page scales each part of the night, 1 being physical. Moon Phase From places the Moon by the date or by Moon Phase.
Realtime Trace draws the Physical atmosphere and moving clouds from the camera’s view. Weather controls animated a little each frame are followed without baking the sky again. Path Trace uses a map baked at the scene’s origin. Surface Renderer uses Sky to light surfaces and keeps its background transparent.
Surface Renderer takes diffuse environment light from the Sky, but its reflections use a procedural sky. Use either tracer when reflections must show the HDR image.
A Scene keeps one Sky. If another reaches it, the Scene leaves that Sky and its sun out and reports it in Status. A renderer in Scene + Local mode uses its local Sky in preference to the Scene’s.
Inputs
-
hdrimage -
weather_mapimage -
starsimage
Outputs
-
scenescene required
Parameters
Section titled “Parameters”Sky
op('sky').par.Timeofday Hours, local solar time: moves the sun, and with it the sky's colour, the clouds' light and the shadows. Dawn and dusk depend on Latitude and Day of Year.
- Default:
15.5- Range:
- 0 to 24
op('sky').par.Sunheading Turns the sun's whole path about the vertical, degrees: at 0 it rises toward +x and sets toward -x, noon toward +z.
- Default:
0- Range:
- -180 to 180
op('sky').par.Coverage How much of the sky the clouds cover.
- Default:
0.45- Range:
- 0 to 1
op('sky').par.Wind How fast the clouds drift, metres a second.
- Default:
9- Range:
- 0 to 60
op('sky').par.Winddirection Where the clouds drift to, degrees from +x toward +z.
- Default:
20- Range:
- -180 to 180
op('sky').par.Cloudshadows How much the clouds hold back the sun on the scene.
- Default:
1- Range:
- 0 to 1
op('sky').par.Sunintensity The sun's light: 1 lights a white surface facing it to 1.0; the default 3 is a bright day at Exposure 1. The sky's light is scattered sunlight and follows it.
- Default:
3- Range:
- 0 to 20
op('sky').par.Skyintensity The sky's light, relative to what the sun makes it (1 is as the air scatters it).
- Default:
1- Range:
- 0 to 4
op('sky').par.Hdrrotation - Default:
0- Range:
- -180 to 180
op('sky').par.Hdrtintr - Default:
1- Range:
- 0 to 4
op('sky').par.Hdrtintg - Default:
1- Range:
- 0 to 4
op('sky').par.Hdrtintb - Default:
1- Range:
- 0 to 4
op('sky').par.Solidcolorr - Default:
0.5- Range:
- 0 to 1
op('sky').par.Solidcolorg - Default:
0.5- Range:
- 0 to 1
op('sky').par.Solidcolorb - Default:
0.5- Range:
- 0 to 1
op('sky').par.Extrasun HDR and Solid: add a sun at Time of Day as well (off when the map carries its own).
- Default:
Off- Options:
- Off, On
Advanced
op('sky').par.Latitude - Default:
40- Range:
- -89 to 89
op('sky').par.Dayofyear - Default:
200- Range:
- 1 to 365
op('sky').par.Sundirx - Default:
0.2- Range:
- -1 to 1
op('sky').par.Sundiry - Default:
0.5- Range:
- -1 to 1
op('sky').par.Sundirz - Default:
0.4- Range:
- -1 to 1
op('sky').par.Sundiameter - Default:
0.53- Range:
- 0.1 to 10
op('sky').par.Clouds - Default:
On- Options:
- Off, On
op('sky').par.Cloudbase - Default:
1500- Range:
- 0 to 15000
op('sky').par.Cloudtop - Default:
5000- Range:
- 200 to 20000
op('sky').par.Cloudtype - Default:
0.55- Range:
- 0 to 1
op('sky').par.Typevariation - Default:
0.35- Range:
- 0 to 1
op('sky').par.Density - Default:
1- Range:
- 0 to 8
op('sky').par.Detail - Default:
0.45- Range:
- 0 to 1
op('sky').par.Softness - Default:
0.35- Range:
- 0 to 1
op('sky').par.Anvil - Default:
0- Range:
- 0 to 1
op('sky').par.Evolution - Default:
1.2- Range:
- 0 to 20
op('sky').par.Cirrus - Default:
0.35- Range:
- 0 to 1
op('sky').par.Cirrusaltitude - Default:
9500- Range:
- 3000 to 16000
op('sky').par.Droplet - Default:
18- Range:
- 5 to 50
op('sky').par.Multiplescattering - Default:
0.65- Range:
- 0 to 0.95
op('sky').par.Ambient - Default:
1- Range:
- 0 to 4
op('sky').par.Weatheroffsetx - Default:
0- Range:
- -1000000 to 1000000
op('sky').par.Weatheroffsety - Default:
0- Range:
- -1000000 to 1000000
op('sky').par.Weatheroffsetz - Default:
0- Range:
- -1000000 to 1000000
op('sky').par.Weatherscale - Default:
36000- Range:
- 2000 to 200000
op('sky').par.Weathermapsize The width of ground the weather_map image covers, centred on the origin: red paints where clouds form, green how tall they build.
- Default:
40000- Range:
- 100 to 1000000
op('sky').par.Haze - Default:
1- Range:
- 0 to 20
op('sky').par.Airdensity - Default:
1- Range:
- 0 to 4
op('sky').par.Ozone - Default:
1- Range:
- 0 to 4
op('sky').par.Godrays - Default:
1- Range:
- 0 to 4
op('sky').par.Metersperunit How many metres one scene unit is. The clouds sit kilometres up, so a scene built in centimetres wants 0.01.
- Default:
1- Range:
- 0.001 to 100000
op('sky').par.Groundheight The scene height of the planet's ground.
- Default:
0- Range:
- -100000 to 100000
op('sky').par.Groundalbedor - Default:
0.1- Range:
- 0 to 1
op('sky').par.Groundalbedog - Default:
0.1- Range:
- 0 to 1
op('sky').par.Groundalbedob - Default:
0.1- Range:
- 0 to 1
op('sky').par.Timescale Cloud time is scene time x Time Scale + Time Offset.
- Default:
1- Range:
- 0 to 1000
op('sky').par.Timeoffset - Default:
0- Range:
- -1000000 to 1000000
op('sky').par.Quality More steps through the clouds: slower, finer.
- Default:
1- Range:
- 0.25 to 4
op('sky').par.Turbidity - Default:
2.5- Range:
- 1 to 10
op('sky').par.Horizonfade - Default:
0.18- Range:
- 0 to 1
op('sky').par.Groundfalloff - Default:
0.65- Range:
- 0.05 to 4
op('sky').par.Skyozone - Default:
0.6- Range:
- 0 to 3
op('sky').par.Skysaturation - Default:
1- Range:
- 0 to 2
op('sky').par.Skyovercast - Default:
0- Range:
- 0 to 1
Night
op('sky').par.Night Physical: after sunset the Sky draws the night: real stars (HYG 4.1 and Gaia DR3, or the stars input), the planets, the Milky Way (NASA), the airglow, and the Moon with its phase and relief (NASA LRO), which lights the scene and the clouds.
- Default:
On- Options:
- Off, On
op('sky').par.Nightexposure How many stops the Sky brightens itself, its sun and its Moon as its light fades: from 1 degree after sunset to full at 16 degrees down. 0 is physical (night is black); 20 shows the Milky Way on a moonless night. Moonlight lowers it, so a brighter Moon always makes a brighter picture.
- Default:
20- Range:
- 0 to 30
op('sky').par.Stars The stars' brightness: 1 is physical, relative to the Moon and the sky.
- Default:
1- Range:
- 0 to 20
op('sky').par.Starsize How wide a star is drawn, in pixels. Every star keeps its light wherever it falls, so a star never blinks as the view moves.
- Default:
0.75- Range:
- 0.3 to 4
op('sky').par.Starlimit The faintest star drawn, visual magnitude: 6.5 is what an eye sees, 11.5 all the catalogue holds (the fainter ones are in the Milky Way).
- Default:
11.5- Range:
- -1 to 11.5
op('sky').par.Starcolor How much of the stars' colour (from their spectra) shows: 1 is their colour, 0 white.
- Default:
1- Range:
- 0 to 3
op('sky').par.Milkyway The Milky Way, the light of the stars too faint to draw one by one: 1 is physical.
- Default:
1- Range:
- 0 to 20
op('sky').par.Airglow The faint green and red glow of the upper air, brightest toward the horizon: 1 is physical.
- Default:
1- Range:
- 0 to 20
op('sky').par.Planets Mercury, Venus, Mars, Jupiter and Saturn where they stand on the date: 1 is physical.
- Default:
1- Range:
- 0 to 20
op('sky').par.Moon The Moon's brightness, on the sky and as the light it casts: 1 is physical.
- Default:
1- Range:
- 0 to 20
op('sky').par.Moonsize Draws the Moon larger, at its own brightness; the light it casts stays the real Moon's.
- Default:
1- Range:
- 0.25 to 20
op('sky').par.Moonphase 0 new, 0.25 first quarter, 0.5 full, 0.75 last quarter.
- Default:
0.5- Range:
- 0 to 1
op('sky').par.Year With Day of Year and Time of Day, the date of the night: where the Moon and the planets stand.
- Default:
2026- Range:
- 1900 to 2100
op('sky').par.Longitude Degrees east: with Time of Day (local solar time) it sets the hour on the Moon's clock.
- Default:
0- Range:
- -180 to 180