import buildModuleUrl from "../Core/buildModuleUrl.js"; import CubeMapPanorama from "./CubeMapPanorama.js"; import SceneMode from "./SceneMode.js"; import destroyObject from "../Core/destroyObject.js"; /** * A sky box around the scene to draw stars. The sky box is defined using the True Equator Mean Equinox (TEME) axes. *
* This is only supported in 3D. The sky box is faded out when morphing to 2D or Columbus view. The size of * the sky box must not exceed {@link Scene#maximumCubeMapSize}. *
* * @alias SkyBox * @constructor * * @param {object} options Object with the following properties: * @param {object} [options.sources] The source URL orImage object for each of the six cube map faces. See the example below.
* @param {boolean} [options.show=true] Determines if this primitive will be shown.
*
*
* @example
* scene.skyBox = new Cesium.SkyBox({
* sources : {
* positiveX : 'skybox_px.png',
* negativeX : 'skybox_nx.png',
* positiveY : 'skybox_py.png',
* negativeY : 'skybox_ny.png',
* positiveZ : 'skybox_pz.png',
* negativeZ : 'skybox_nz.png'
* }
* });
*
* @see Scene#skyBox
* @see Transforms.computeTemeToPseudoFixedMatrix
*/
function SkyBox(options) {
this._sources = options.sources;
this._show = options.show ?? true;
this._panorama = new CubeMapPanorama({
sources: this._sources,
show: this._show,
returnCommand: true,
});
}
Object.defineProperties(SkyBox.prototype, {
/**
* Gets or sets the the primitive object.
* @memberof SkyBox.prototype
* @type {object}
*/
sources: {
get: function () {
return this._panorama.sources;
},
set: function (value) {
this._panorama.sources = value;
},
},
/**
* Determines if the sky box will be shown.
* @memberof SkyBox.prototype
* @type {boolean}
* @default true
*/
show: {
get: function () {
return this._panorama.show;
},
set: function (value) {
this._panorama.show = value;
},
},
});
/**
* Called when {@link Viewer} or {@link CesiumWidget} render the scene to
* get the draw commands needed to render this primitive.
* * Do not call this function directly. This is documented just to * list the exceptions that may be propagated when the scene is rendered: *
* * @exception {DeveloperError} this.sources is required and must have positiveX, negativeX, positiveY, negativeY, positiveZ, and negativeZ properties. * @exception {DeveloperError} this.sources properties must all be the same type. */ SkyBox.prototype.update = function (frameState, useHdr) { const { mode, passes } = frameState; if (mode !== SceneMode.SCENE3D && mode !== SceneMode.MORPHING) { return; } if (!passes.render) { return; } // Delegate completely return this._panorama.update(frameState, useHdr); }; /** * Returns true if this object was destroyed; otherwise, false. *isDestroyed will result in a {@link DeveloperError} exception.
*
* @returns {boolean} true if this object was destroyed; otherwise, false.
*
* @see SkyBox#destroy
*/
SkyBox.prototype.isDestroyed = function () {
return false;
};
/**
* Destroys the WebGL resources held by this object. Destroying an object allows for deterministic
* release of WebGL resources, instead of relying on the garbage collector to destroy this object.
* isDestroyed will result in a {@link DeveloperError} exception. Therefore,
* assign the return value (undefined) to the object as done in the example.
*
* @exception {DeveloperError} This object was destroyed, i.e., destroy() was called.
*
*
* @example
* skyBox = skyBox && skyBox.destroy();
*
* @see SkyBox#isDestroyed
*/
SkyBox.prototype.destroy = function () {
this._panorama = this._panorama && this._panorama.destroy();
return destroyObject(this);
};
function getDefaultSkyBoxUrl(suffix) {
return buildModuleUrl(`Assets/Textures/SkyBox/tycho2t3_80_${suffix}.jpg`);
}
/**
* Creates a skybox instance with the default starmap for the Earth.
* @return {SkyBox} The default skybox for the Earth
*
* @example
* viewer.scene.skyBox = Cesium.SkyBox.createEarthSkyBox();
*/
SkyBox.createEarthSkyBox = function () {
return new SkyBox({
sources: {
positiveX: getDefaultSkyBoxUrl("px"),
negativeX: getDefaultSkyBoxUrl("mx"),
positiveY: getDefaultSkyBoxUrl("py"),
negativeY: getDefaultSkyBoxUrl("my"),
positiveZ: getDefaultSkyBoxUrl("pz"),
negativeZ: getDefaultSkyBoxUrl("mz"),
},
});
};
export default SkyBox;