---

title: GroundedSkybox category: Addons layout: docs

GroundedSkybox

A ground-projected skybox.

By default the object is centered at the camera, so it is often helpful to set skybox.position.y = height to put the ground at the origin.

Code Example

const height = 15, radius = 100;
const skybox = new GroundedSkybox( envMap, height, radius );
skybox.position.y = height;
scene.add( skybox );

Import

GroundedSkybox is an addon, and must be imported explicitly, see Installation#Addons.

import { GroundedSkybox } from 'three/addons/objects/GroundedSkybox.js';

Constructor

new GroundedSkybox( map : Texture, height : number, radius : number, resolution : number )

Constructs a new ground-projected skybox.

map | The environment map to use.
---|---
height | The height is how far the camera that took the photo was above the ground. A larger value will magnify the downward part of the image.
radius | The radius of the skybox. Must be large enough to ensure the scene's camera stays inside.
resolution | The geometry resolution of the skybox. Default is 128.

Source

examples/jsm/objects/GroundedSkybox.js