Skip to content

Environments

The environment surrounds your whole scene, like an infinitely large sphere (other software calls it a sky dome or environment map). It does two jobs at once:

  1. It is the backdrop. Whatever the camera sees past your model is the environment.
  2. It lights the scene. Light from every direction of the environment falls on your model and shows up in reflections, so the environment sets the mood of the whole render.
A rooftop terrace with two armchairs and a coffee table, lit by a sunny HDRI with scattered clouds

One HDRI provides the sky, the distant landscape, the sunlight and the soft shadows. There are no other lights in this scene apart from two dimmed lanterns.

Rayscaper has three environment types. Pick the one that matches what you are making:

TypeWhat it isBest for
ColorA single color in every directionProduct shots, clean studio renders, quick tests
HDRIA 360° photo of a real place, including its lightRealistic lighting with minimal setup, interiors and exteriors
SkyA computed sky, with a sun you can positionExteriors where you control the time of day

A new model starts with a Nishita sky whose sun follows SketchUp’s Shadows panel, so the first render has the sunlight and the shadows you see in SketchUp. Auto Exposure is on as well, so rooms lit through a window come out as bright as a sunny exterior.

All environment settings live in the Environment section of the Scene Editor. Choose a type with the Environment Type buttons at the top; the controls below them change with the type.

The Environment section of the Scene Editor with an HDRI selected

The Environment section with an HDRI selected.

Two switches apply to every environment type:

Turns the environment off completely. The background turns black and only the lights you placed yourself, such as point lights, spotlights and emissive materials, light the scene.

The terrace lit by the sunny HDRI

The environment provides the backdrop and most of the light.

Hides the environment from the camera but keeps its light. Your model is lit and reflects exactly as before, while the background becomes transparent in the saved PNG. Transparent only appears while Enabled is on.

The terrace with the sky visible behind it

The HDRI is visible behind the terrace.


The simplest environment: one color in every direction. It lights the scene evenly from all sides, which gives soft, shadowless light, a clean backdrop and reflections without distractions.

The terrace with a white color environment

White gives neutral, even light, the classic product shot look.

Best for: product renders, catalog images, clay renders and quick lighting checks.

The Color environment settings
SettingDefaultDescription
Power0.8Brightness of the background and of the light it casts. The slider runs from 0.01 to 100 on a logarithmic scale, so small values are easy to set.
Environment ColorWhiteThe color of the background and of the light. Click the swatch to pick a color.

An HDRI (High Dynamic Range Image) is a 360° photo of a real place that also stores how bright every part of it is, from the deepest shadow to the sun itself. Used as an environment, it lights your model the way that place would: direct sunlight, soft skylight, light bouncing off nearby buildings, and realistic reflections. It is the fastest way to a realistic render.

The terrace lit by a sunny HDRI with clouds

A sunny sky with clouds: crisp shadows and a bright, fresh look.

Best for: architectural exteriors and interiors, products shown in context, and any render where realism matters.

  1. Select HDRI as the environment type. A file dialog opens right away, choose an .hdr or .exr file.
  2. Turn Rotation until the sun or the brightest part of the HDRI is where you want it.
  3. Adjust Power until the brightness is right.
  4. To switch to a different file later, click Open… next to the HDRI path.

The quickest source is the built-in Asset Manager. It gives you the full Poly Haven HDRI library inside Rayscaper: drag an HDRI onto the viewport and Rayscaper downloads and applies it.

You can also download HDRIs yourself from Poly Haven or ambientCG. Both offer hundreds of free, high-quality HDRIs under the CC0 license, so you can use them in any project, including commercial work.

SettingDefaultDescription
HDRI PathThe HDRI file. Click Open… to choose a different one.
Power0.8Brightness multiplier, from 0.01 to 100 on a logarithmic scale.
Rotation0°Turns the HDRI around the vertical axis, from 0° to 360°. Use it to move the sun, and with it the shadows and reflections.

Rotation is the most useful HDRI setting. Turning the HDRI moves the sun around your model, which changes the direction of the shadows, which side of the model is lit, and what you see in the background:

The terrace backlit by the sun from the back left

The sun is behind the terrace on the left. The furniture is backlit and the shadows fall towards the camera.

Power scales all the light of the HDRI. Lower it when the render is too bright or when the environment overpowers your own lights, and raise it when the render is too dark.

The terrace with the HDRI at power 0.3, the render is dark

Too dark: the lanterns now stand out, but the scene looks underexposed.

If you already picked an environment in SketchUp’s Environments panel (in the Default Tray), Rayscaper can use it directly. Rayscaper then syncs:

  • HDRI image: the SketchUp environment image becomes Rayscaper’s HDRI.
  • Rotation: SketchUp’s environment rotation becomes Rayscaper’s Rotation.
  • Exposure: SketchUp’s skydome exposure becomes Rayscaper’s Power.
  • Linked sun: if Set Sun Location is on in SketchUp, Rayscaper adds a directional light called SketchUp Environment Sun that matches the sun direction of the environment.

To turn it on, choose Extensions > Rayscaper > Use SketchUp Environment for HDRI. A checkmark shows that it is active.

The Use SketchUp Environment for HDRI menu item with a checkmark

Turn on environment tracking in Extensions > Rayscaper > Use SketchUp Environment for HDRI.

SketchUp's Environments panel with a Breezeway HDRI and its settings

SketchUp’s Environments panel. The HDRI, rotation, exposure and sun are all synced to Rayscaper.

While tracking is on, the Environment section shows Tracking SketchUp Environment and SketchUp controls the HDRI settings. Changes in SketchUp’s Environments panel update the render right away.

Rayscaper's Environment section showing Tracking SketchUp Environment

The Environment section while tracking a SketchUp environment.

The SketchUp Environment Sun light appears in the Lights section. You can change its intensity and color temperature there, but its direction always follows the environment.

The SketchUp Environment Sun directional light in Rayscaper's Lights section

The SketchUp Environment Sun directional light that Rayscaper creates for you.


A sky environment computes the sky from a physical model of the atmosphere, so no image file is needed. The sky is always sharp, whatever your resolution, and with the Nishita model you can put the sun exactly where you want it, for any time of day.

The terrace under a Nishita sky in the afternoon

Nishita with the sun at 30°: realistic sunlight, a soft blue sky and a visible sun.

Best for: exteriors and architectural renders where you control the sun, sun studies, and golden hour or dusk shots.

Choose the model with Sky Model. Each model is explained below.

ModelSunBest for
NishitaYes, with a visible sun disk and full control over its positionRealistic exteriors, any time of day, sunsets
Hosek/WilkieNoSoft daylight from a clear or hazy sky
PreethamNoQuick previews and stylized renders

The most realistic sky model. It simulates how sunlight scatters in Earth’s atmosphere: on air molecules, which make the sky blue, on dust, which makes it hazy, and in the ozone layer. It renders a visible sun and lets you set its height and direction, so you get a matching sky for every time of day.

Sun Elevation sets the time of day. The same sky turns from a deep blue noon sky into a warm sunset and then into dusk:

The terrace under a Nishita sky with the sun high at 60 degrees

Sun Elevation 60°: bright, neutral light and short shadows.

The Nishita sky settings

The Nishita settings are grouped into the sky, the sun and the atmosphere.

SettingDefaultDescription
Power1.0Brightness of the sky and the sun together, from 0.01 to 100 on a logarithmic scale.
GroundOnShows a ground below the horizon instead of black. See Ground.
Ground Albedo0.3How much light the ground reflects, from 0 to 1: about 0.1 for dark soil or asphalt, 0.3 for grass or concrete, 0.8 for fresh snow. Only shown while Ground is on.
Sun DiskOnShows the sun in the sky. Turn it off to keep the sky light without a visible sun.
Sun Size0.53°Angular diameter of the sun, from 0.01° to 1°. The real sun is about 0.53°. A larger sun gives softer shadows.
Sun Intensity1.0Brightness of the sun disk, from 0 to 10, without changing the sky.
Sun Elevation60°Height of the sun above the horizon, from -90° to 90°. 0° is sunrise or sunset, 90° is straight overhead. Below 0° the sun has set.
Sun Rotation0°Compass direction of the sun, from 0° to 360°. Turns the sun, and so the shadows, around your model.
Altitude0 kmHeight of the viewer above sea level, from 0 to 60 km. Higher altitudes give a thinner atmosphere and a darker, deeper blue sky.
Air Density1.0Amount of air, from 0 to 10. Air scatters blue light, so this changes the color and brightness of the sky.
Dust Density0.5Amount of dust and haze, from 0 to 10. Higher values give hazier conditions and warmer sunlight.
Ozone Density3.0Amount of ozone, from 0 to 10. Mostly visible at sunset, where higher values add purple and pink tones.

Sun Size and Sun Intensity only appear while Sun Disk is on.

The atmosphere ends at the horizon, so below it a sky is black. Wherever your model doesn’t cover the view, for example in an aerial view or with a model without a ground surface, that black shows. With Ground on, Rayscaper fills everything below the horizon with a plain ground, lit by the same sun and sky as your model: light grey at midday, dimmer and bluer at sunset, dark at night. It also lights the scene from below, like a real ground does. A ground surface in your model covers it.

Skies made before Rayscaper had this setting keep their black below the horizon until you turn Ground on.

Dust Density changes how clear the air is. More dust scatters and absorbs more sunlight:

The terrace under a clear Nishita sky

The default: a clear blue sky and crisp shadows.

Rayscaper’s Nishita sky can follow the sun position from SketchUp’s Shadows panel. This is useful when:

  • you already set up the shadows in SketchUp for a specific date and time,
  • you want to compare sun positions quickly with SketchUp’s shadow sliders,
  • the render has to match a SketchUp shadow study.

It’s on for a new model. To turn it on or off, choose Extensions > Rayscaper > Use SketchUp Sun for Nishita Sky. While it’s on, the Nishita sun follows SketchUp’s shadow settings.

Changing the time in SketchUp’s Shadows panel moves the Nishita sun in real time.

While tracking is on, the Environment section shows ✓ Tracking SketchUp Sun, and Sun Elevation and Sun Rotation are disabled because SketchUp controls them.


A sky model that is more accurate than Preetham, especially near the horizon. It has no sun: it gives the soft light of a clear or hazy sky, with the brightest part straight overhead.

The terrace under a clear Hosek/Wilkie sky

The default turbidity, with Power raised to 3: a clear blue sky.

The Hosek/Wilkie sky settings
SettingDefaultDescription
Power1.0Brightness of the sky, from 0.01 to 100 on a logarithmic scale. Without a sun, the default is rather dark, raise it to 2 or 3 for daylight.
Turbidity2.5Haze in the air, from 1 (crystal clear) to 10 (very hazy). Low values give a deep blue sky, high values a pale, milky one.
Ground Albedo0.3How much light the ground reflects, from 0 to 1. A bright ground, like snow, brightens the sky near the horizon.

The oldest and simplest sky model. It gives a bright, plausible sky from just a turbidity value, but with less nuance than the other models, and without a sun.

The terrace under a Preetham sky

The Preetham sky with the default settings.

The Preetham sky settings
SettingDefaultDescription
Power1.0Brightness of the sky, from 0.01 to 100 on a logarithmic scale.
Turbidity2.5Haze in the air, from 1 (crystal clear) to 10 (very hazy).

Product shot on white

  1. Choose Color and keep the color white.
  2. Set Power to 1.0 to 1.5 for bright, even light.
  3. Turn on Transparent if you want to place the product on another background later.

Sunny exterior

  1. Choose HDRI and pick a clear or partly cloudy sky from the Asset Manager, or choose Sky with Nishita.
  2. Turn Rotation (HDRI) or Sun Rotation (Nishita) until the sun lights the side of the building the camera sees.
  3. For Nishita, set Sun Elevation for the time of day: around 60° for midday, below 15° for golden hour.

Interior

  1. Choose an HDRI that fits the view through your windows. An overcast HDRI gives soft, even daylight.
  2. Rooms get most of their light through windows, so raise Power until the room is bright enough, or add lights.
  3. When you add lights, lower Power again so the environment doesn’t wash them out.

Night scene

  1. Turn off Enabled, or use a Nishita sky with Sun Elevation just below 0° for a dusk glow.
  2. Light the scene with lights and emissive materials.

The example scene on this page is built from CC0 models, textures and HDRIs from Poly Haven.