Contents
Manual home
Start here
Guides
Getting around
Making objects
Terrain, water and sky
Materials and light
Rendering and export
Loop Studio
Files and purchases
Concepts
Reference
Troubleshooting
Reference

Environment settings and presets

The ENVIRONMENT BROWSER holds the sky, clouds, night sky, sun, ground plane, wind, fog and background picture of a scene, along with the presets that set all of them in one click. Open it from the ENVIRONMENT card at the bottom right of the window, with ⌘E or with the ENVIRONMENT BROWSER command in the command palette. The presets are on the left side of the panel. On the right are a preview, the settings in the order used below and the buttons at the foot.

Each change goes into the scene as you make it, and a slider drag is one undo step. The panel has no APPLY or CANCEL; its X only closes it. The environment is saved with the scene. Where a section has an ENABLED switch, turning it off dims the rows below it and keeps their values. For the tasks these settings serve, see Set the sky, sun, fog and clouds.

Preset list

LabelEffectAvailability
SEARCH PRESETSShows only the preset cards whose names contain the text typed, ignoring capitals. Folder cards stay in view. Inside a folder the field reads SEARCH IN and the folder name.Always
+ FOLDERAdds a folder for presets, with its name ready to typeDimmed inside a folder, since folders cannot hold folders
ROLLReplaces the whole environment with a random one, as described in Roll. One undo step per click.Always
BUILT-INThe 13 presets that come with Orbit, listed in Built-in environmentsAt the top level only
USER PRESETSSaved presets and folders. Inside a folder the heading shows the folder name.Always
A preset cardReplaces the whole environment with the preset's, including ground plane, fog, wind and background, as one undo step. The card of the preset in use has a thicker, colored outline. While an unsaved roll is showing, a click first asks Replace the rolled sky?Always
+ NEW PRESETSaves the current environment as a preset in the folder being viewed and applies it. The name is Rolled Sky and a number after a roll, Preset and a number otherwise.Hidden while the search field holds text

A preset saved this way is a .orbitenv file. Renaming, moving, deleting and importing presets are covered in Save your own presets.

Preview and name

At the top of the right side, a chrome sphere shows the environment with its reflections and fog. It is redrawn shortly after the last change.

Under the sphere is the name of the environment. A built-in preset shows its name in capitals and a roll shows CUSTOM. A user preset shows its name in a field, where typing a new name and pressing Return renames the preset. EDITS UPDATE THIS PRESET below the field means that each change in the panel is also written into that preset's file.

Sky

LabelValues and defaultEffect
TOPColor, #7394D1The color straight overhead
BOTTOMColor, #1F2640The color at the horizon. The sky blends from TOP to BOTTOM.
TURBULENCE0 to 1.00, default 0.40Breaks up the gradient with noise. At 0 the blend is smooth.
INTENSITY0.50 to 3.00, default 1.00Brightens or darkens the whole sky, and the sky seen in shiny objects

While the Void preset is applied, the sky stays black whatever these settings say. Another preset, ROLL or SAVE AS PRESET ends that.

Clouds

LabelValues and defaultEffectAvailability
ENABLEDOn or off, default offCovers the sky with cloudsAlways
COVERAGE0 to 1.00, default 0.50How much of the sky the clouds cover, from clear at 0 to overcast at 1Clouds on
SCALE0.10 to 10.00, default 3.00Higher values give smaller, more numerous cloudsClouds on
OCTAVES1 to 8, default 4Layers of fine detail in each cloudClouds on
HORIZON FALLOFF0.50 to 8.00, default 1.00Higher values thin the clouds near the horizon and gather them overheadClouds on
CLOUD COLORColor, whiteThe color of the clouds overheadClouds on
SHADOW COLORColor, #9999B2The color the clouds shade toward at the horizonClouds on

Clouds cover the stars. The sun and the moon are drawn in front of them. With wind in the scene, the clouds drift while Loop Studio plays and in exported loops.

Night

STARS and MOON each have their own switch, and the rows under a switch are dimmed while it is off.

LabelValues and defaultEffect
STARSOn or off, default offFills the sky with stars
DENSITY0 to 1.00, default 0.50How many stars there are
BRIGHTNESS0 to 3.00, default 1.00How bright the stars are
MOONOn or off, default offShows a moon
PHASE0 to 1.00, default 0.35How much of the moon is lit, from new at 0 through full at 0.50 to new again at 1. Below 0.50 the moon is waxing.
SIZE0.20 to 4.00, default 1.00The size of the moon. At 1.00 its radius is about 2.6°.
AZIMUTH0° to 360°, default 220°The moon's position around the horizon, measured the same way as the sun's
ELEVATION0° to 90°, default 40°The moon's height above the horizon
GLOW0 to 1.00, default 0.35The strength of the glow around the moon
MOTTLE0 to 1.00, default 0.35The dark patches on the face of the moon
MOON COLORColor, #EBF0FFThe tint of the moon

The panel has no control for where the stars fall. A roll that gives a night sky scatters them again. The moon gives the scene no light. To light a night scene, follow Make a night sky.

Sun

The sun has two switches. VISIBLE SUN DISC draws it in the sky, and SUN LIGHT makes it light the scene. Either works without the other, and AZIMUTH and ELEVATION place both.

LabelValues and defaultEffectAvailability
VISIBLE SUN DISCOn or off, default offDraws the sun and its glow in the skyAlways
SUN LIGHTOn or off, default offLights the scene from the direction of the sun, with hard shadowsAlways
LIGHT INTENSITY0 to 4.00, default 1.00The strength of the sunlightSUN LIGHT on
AZIMUTH−180° to 360°, default 45°The sun's position around the horizonAlways
ELEVATION0° to 90°, default 35°The sun's height, from the horizon at 0° to straight overhead at 90°Always

Three groups under DISC, INNER HALO and OUTER CORONA shape the drawn sun. All three are dimmed while VISIBLE SUN DISC is off.

GroupLabelValues and defaultEffect
DISCSIZE0.10° to 15.00°, default 1.49°The radius of the disc as an angle
DISCINTENSITY1.00 to 8.00, default 3.00The brightness of the disc
DISCCOLORColor, #FFF2CCThe color of the disc and of the sunlight
INNER HALOSIZE0.05 to 1.00, default 0.05The width of the tight glow around the disc. Higher values spread it wider; the value is not an angle.
INNER HALOINTENSITY0 to 2.00, default 0.60The brightness of the tight glow
INNER HALOCOLORColor, #FFF2CCThe color of the tight glow
OUTER CORONASIZE0.10 to 3.00, default 0.30The width of the wide, soft glow, on the same scale as INNER HALO
OUTER CORONAINTENSITY0 to 2.00, default 0.25The brightness of the wide glow
OUTER CORONACOLORColor, #FFD9A6The color of the wide glow

The sunlight takes the disc COLOR, which is dimmed with the rest of the group while VISIBLE SUN DISC is off. To change the color of the light, turn the disc on, set the color and turn the disc off again. The sunlight always casts shadows. They show in the LIVE preview and in renders, since the viewport draws none. Light a scene covers the lights you place yourself.

Ground plane

LabelValues and defaultEffectAvailability
ENABLEDOn or off, default offAdds a flat floor that runs to the horizonAlways
HEIGHT−10 m to 0 m, default 0 mThe level of the floor. The slider does not go above 0.Ground on
COLORColor, #0D0D12The color of the floor, and the first color of its patternGround on
REFLECTION0 to 1.00, default 0.60How strongly the floor mirrors the sceneGround on
ROUGHNESS0 to 1.00, default 0Weakens the reflection. The reflection does not blur.Ground on
RECEIVE SHADOWSOn or off, default onLets shadows fall on the floorGround on
PATTERNSOLID, CHECKER, HEX TILES, POLKA DOTS, GRADIENT STRIPES, WIREFRAME GRID or CONCENTRIC RINGS; default SOLIDDraws a pattern in two colors over the floorGround on
ACCENTColor, #1F1F26The second color of the patternShown when PATTERN is not SOLID
PATTERN SCALE0.10 to 4.00, default 1.00The size of the tiles, dots or stripes, in metersShown when PATTERN is not SOLID

In the viewport the floor reflects only the sky. Objects appear in its reflection in the LIVE preview and in renders, for the reasons in The viewport, the preview and the render.

Wind

LabelValues and defaultEffect
DIRECTION0° to 360°, default 0°The direction the wind blows from
STRENGTH0 to 1.00, default 0How hard the wind blows. At 0 the scene has no wind.

The section has no ENABLED switch; a STRENGTH of 0 turns the wind off. Plants lean away from the wind, and water with FOLLOW WIND on takes its direction from DIRECTION. The swaying of plants and the drift of glowing motes, clouds and the banks of LAYERED fog happen while Loop Studio plays and in exported loops. See Make things move in the wind.

Fog

The rows below ENABLED are dimmed while fog is off. The rows each MODE shows are marked in the last column; the others are hidden.

LabelValues and defaultEffectAvailability
ENABLEDOn or off, default offFades distant parts of the scene into the fog colorAlways
COLORColor, #808CA6The color of the fogEvery mode
MODEEXPONENTIAL, LINEAR or LAYERED; default EXPONENTIALHow the fog builds up. EXPONENTIAL thickens smoothly with distance, LINEAR ramps from START DIST to END DIST and LAYERED lies low and thins with height.Every mode
START DIST0 m to 40 m, default 0 mThe distance from the camera that stays clearEvery mode
END DIST1 m to 150 m, default 30 mThe distance where the fog is completeLINEAR
DENSITY0 to 0.15, default 0.035The thickness of the fog. At 0.035, objects about 20 m away are roughly half hidden. In LAYERED mode it is the thickness at BASE HEIGHT.EXPONENTIAL and LAYERED
BASE HEIGHT−10 m to 20 m, default 0 mThe height at which the fog has its DENSITY. It is thicker below and thinner above.LAYERED
SCALE HEIGHT0.50 m to 20 m, default 4.00 mHow quickly the fog thins with height. Smaller values keep it closer to the ground.LAYERED
NOISE AMOUNT0 to 1.00, default 0Breaks the fog into patchy banks. At 0 it is even.LAYERED
NOISE SCALE0.02 to 1.00, default 0.15The size of the banks. Higher values make them smaller; at 0.15 they are about 6 m across.LAYERED
MAX AMOUNT0 to 1.00, default 1.00The most the fog can hide. Below 1, the farthest objects stay faintly visible.Every mode

When fog is off, choosing the TERRA '96 look in RENDER SETTINGS shows TERRA PAIRS WITH FOG with an ENABLE button, described in Render settings. ENABLE turns fog on in LAYERED mode with COLOR #8C9EB8, DENSITY 0.02, START DIST 0 m, BASE HEIGHT 0 m, SCALE HEIGHT 4.00 m, NOISE AMOUNT 0 and NOISE SCALE 0.15, and leaves END DIST and MAX AMOUNT as they were.

Background

LabelValues and defaultEffectAvailability
IMAGEThe file name, or NONE by defaultThe picture shown behind the sceneAlways
CHOOSEButtonOpens a file dialog to pick the picture. One undo step.Always
CLEARButtonRemoves the picture. One undo step.Shown once a picture is set
FITSTRETCH, FIT, FILL or TILE; default FILLFILL covers the view and crops the picture, FIT shows all of it with the sky around it, STRETCH covers the view without keeping its proportions and TILE repeats it at its own pixel sizeShown once a picture is set

The picture appears only where the camera looks past the objects. Shiny objects still reflect the sky, and the scene is still lit by it. Saving the scene stores a copy of the picture in the file, reduced to 1024 pixels on its longest side if it is larger. Under the file name, EMBEDDED means Orbit is using that stored copy because the original file cannot be found, and MISSING · USING SKY means neither is available and the sky shows in its place.

LabelEffectAvailability
SAVE AS PRESETSaves the current environment as a preset in the folder being viewed and applies it, as + NEW PRESET doesAlways
REVEAL IN FINDERShows the preset's .orbitenv file in the FinderWhile a user preset is applied

Built-in environments

A card replaces the whole environment. It turns off the ground plane, fog, wind and background picture and returns each setting it does not list below to its default. None of the cards turns on SUN LIGHT. Card names appear as written here; the name under the preview shows them in capitals.

CardSky, TOP to BOTTOMSun discCloudsNight
Void#000000 to #000000, TURBULENCE 0. The sky stays black whatever the SKY settings say.OffOffOff
Classic#7394D1 to #1F2640, TURBULENCE 0.40. Every setting at its default.OffOffOff
Studio#666666 to #0D0D0D, TURBULENCE 0OffOffOff
Sunset#260D33 to #E6661A, TURBULENCE 0.30At 270° and 5°, with an amber halo and a peach coronaOffOff
Color Band#1A0066 to #004D4D, TURBULENCE 0OffOffOff
Postcard#4A6FA5 to #B8C8DD, TURBULENCE 0.40At 45° and 35°COVERAGE 0.60, SCALE 3.00, OCTAVES 5, whiteOff
Overcast#3D5A8C to #8FA8C7, TURBULENCE 0.50At 45° and 35°, dimmer, INTENSITY 2.00COVERAGE 0.85, SCALE 2.50, OCTAVES 6, HORIZON FALLOFF 0.70Off
Dusk#D88940 to #E89C7A, TURBULENCE 0.30, sky INTENSITY 1.20At 45° and 15°, orange, SIZE 2.14°COVERAGE 0.55, SCALE 3.50, OCTAVES 5, peachOff
Twilight#3D2C5C to #7E5478, TURBULENCE 0.30OffCOVERAGE 0.50, SCALE 4.00, OCTAVES 5, mauveOff
Nightfall#0A0F2E to #1A2348, TURBULENCE 0.50, sky INTENSITY 0.70OffCOVERAGE 0.40, SCALE 3.50, OCTAVES 5, blue graySTARS and MOON on at their defaults
Bryce-Era Alien#C66734 to #6A4E8C, TURBULENCE 0.40At 45° and 35°, pale yellowCOVERAGE 0.50, SCALE 3.00, OCTAVES 4, greenOff
Nebula#2A0838 to #0A0510, TURBULENCE 0.40OffCOVERAGE 0.70, SCALE 2.50, OCTAVES 6, HORIZON FALLOFF 0.50, cyan shading to magentaOff
Dust Storm#A8482D to #6B3F25, TURBULENCE 0.60, sky INTENSITY 0.90At 45° and 35°, dim and red brown, INTENSITY 1.50COVERAGE 0.80, SCALE 2.50, OCTAVES 6, HORIZON FALLOFF 0.60, tanOff

The two angles of a sun disc are its AZIMUTH and ELEVATION.

Roll

ROLL picks one of seven moods at random, each about as likely as the others, and then chooses every setting within that mood's limits. Sometimes one part of a roll, such as the cloud colors, strays further from the mood. A roll turns off the ground plane and the background picture and sets a random wind DIRECTION. The moods have no names in the panel.

MoodSunCloudsLAYERED fogNightWind STRENGTH
Blue daytime skyDisc and light, 25° to 50° highAlways20% of rolls, DENSITY 0.010 to 0.020None0.15 to 0.45
Low golden sunDisc and light, 3° to 18° highAlways55%, 0.020 to 0.040None0.10 to 0.35
Alien dayDisc and lightAlways30%, 0.015 to 0.035None0.20 to 0.50
Alien nightDim cyan green light, no discAlways35%, 0.020 to 0.040Stars, and a moon in 60% of rolls0.15 to 0.40
NightDim, cool light, no disc70% of rolls35%, 0.015 to 0.030Stars, and a moon in 75% of rolls0.10 to 0.30
Dust stormLight, and a dim red disc in 50% of rollsAlways70%, 0.030 to 0.060None0.55 to 0.90
Dark, empty skyFaint light, no discNoneNeverNone0

Every roll turns on SUN LIGHT, so a rolled night scene is lit by a dim light that stands in for the moon. Rolled fog has a MAX AMOUNT of 0.90 and takes a paler version of the rolled BOTTOM color. A roll is not a preset until it is saved with SAVE AS PRESET or + NEW PRESET.

Related: Set the sky, sun, fog and clouds, Make a night sky, Make things move in the wind and Save your own presets.